ai-agents-for-beginners

Подешавање курса

Увод

Ова лекција ће обухватити како да покренете узорке кода овог курса.

Придружите се другим учесницима и добијте помоћ

Пре него што почнете са клонирањем вашег репозиторијума, придружите се AI Agents For Beginners Discord каналу да добијете помоћ око подешавања, поставите питања о курсу или се повежете са другим учесницима.

Клонирајте или форкујте овај репозиторијум

Да бисте започели, клонирајте или форкујте GitHub репозиторијум. Ово ће направити вашу верзију материјала курса како бисте могли да покрећете, тестирате и прилагођавате код!

Ово можете урадити кликом на линк до

Требало би да сада имате своју форковану верзију овог курса на следећем линку:

Forked Repo

Покретање кода

Овај курс нуди серију Jupyter Notebook-ова које можете покренути како бисте стекли практично искуство у изградњи AI агената.

Узорци кода користе:

Захтева GitHub налог - бесплатно:

1) Semantic Kernel Agent Framework + GitHub Models Marketplace. Ознака: (semantic-kernel.ipynb) 2) AutoGen Framework + GitHub Models Marketplace. Ознака: (autogen.ipynb)

Захтева Azure претплату: 3) Azure AI Foundry + Azure AI Agent Service. Ознака: (azureaiagent.ipynb)

Препоручујемо вам да испробате све три врсте примера како бисте видели који вам најбоље одговара.

Опција коју изаберете одредиће које кораке за подешавање треба да следите у наставку:

Захтеви

У корену овог репозиторијума укључили смо датотеку requirements.txt која садржи све потребне Python пакете за покретање узорака кода.

Можете их инсталирати покретањем следеће команде у вашем терминалу у корену репозиторијума:

pip install -r requirements.txt

Препоручујемо креирање Python виртуелног окружења како бисте избегли било какве конфликте и проблеме.

Подешавање VSCode-а

Уверите се да користите исправну верзију Python-а у VSCode-у.

image

Подешавање за узорке који користе GitHub моделе

Корак 1: Преузмите свој GitHub Personal Access Token (PAT)

Овај курс користи GitHub Models Marketplace, који пружа бесплатан приступ великим језичким моделима (LLMs) које ћете користити за изградњу AI агената.

Да бисте користили GitHub моделе, потребно је да креирате GitHub Personal Access Token.

Ово можете урадити тако што ћете отићи на свој

GitHub налог.

Молимо вас да следите Принцип најмање привилегије приликом креирања вашег токена. То значи да треба да доделите токену само оне дозволе које су му потребне за покретање узорака кода у овом курсу.

  1. Изаберите опцију Fine-grained tokens на левој страни екрана тако што ћете отићи на Developer settings

    Затим изаберите Generate new token.

    Generate Token

  2. Унесите описно име за ваш токен које одражава његову сврху, чинећи га лако препознатљивим касније.

    🔐 Препорука за трајање токена

    Препоручено трајање: 30 дана
    За сигурнији приступ можете изабрати краћи период—на пример, 7 дана 🛡️
    То је одличан начин да поставите лични циљ и завршите курс док је ваш ентузијазам за учење висок 🚀.

    Token Name and Expiration

  3. Ограничите опсег токена на ваш форк овог репозиторијума.

    Limit scope to fork repository

  4. Ограничите дозволе токена: Под Permissions, кликните на картицу Account, а затим на дугме “+ Add permissions”. Појавиће се падајући мени. Потражите Models и означите поље за њега. Add Models Permission

  5. Потврдите потребне дозволе пре него што генеришете токен. Verify Permissions

  6. Пре него што генеришете токен, уверите се да сте спремни да га сачувате на сигурном месту, као што је менаџер лозинки, јер неће бити приказан поново након креирања. Store Token Securely

Копирајте свој нови токен који сте управо креирали. Сада ћете га додати у вашу .env датотеку укључену у овај курс.

Корак 2: Креирајте своју .env датотеку

Да бисте креирали .env датотеку, покрените следећу команду у вашем терминалу.

cp .env.example .env

Ово ће копирати пример датотеке и креирати .env у вашем директоријуму где ћете попунити вредности за променљиве окружења.

Са копираним токеном, отворите .env датотеку у вашем омиљеном текст едитору и налепите ваш токен у поље GITHUB_TOKEN.
GitHub Token Field

Сада би требало да можете да покренете узорке кода овог курса.

Подешавање за узорке који користе Azure AI Foundry и Azure AI Agent Service

Корак 1: Преузмите свој Azure Project Endpoint

Пратите кораке за креирање хаба и пројекта у Azure AI Foundry-у овде: Hub resources overview

Када креирате свој пројекат, потребно је да преузмете стринг за повезивање вашег пројекта.

Ово можете урадити тако што ћете отићи на страницу Overview вашег пројекта у Azure AI Foundry порталу.

Project Connection String

Корак 2: Креирајте своју .env датотеку

Да бисте креирали .env датотеку, покрените следећу команду у вашем терминалу.

cp .env.example .env

Ово ће копирати пример датотеке и креирати .env у вашем директоријуму где ћете попунити вредности за променљиве окружења.

Са копираним токеном, отворите .env датотеку у вашем омиљеном текст едитору и налепите ваш токен у поље PROJECT_ENDPOINT.

Корак 3: Пријавите се на Azure

Као најбољу праксу за безбедност, користићемо аутентификацију без кључа за аутентификацију на Azure OpenAI са Microsoft Entra ID.

Затим, отворите терминал и покрените az login --use-device-code да се пријавите на ваш Azure налог.

Када се пријавите, изаберите вашу претплату у терминалу.

Додатне променљиве окружења - Azure Search и Azure OpenAI

За лекцију Agentic RAG - Лекција 5 - постоје узорци који користе Azure Search и Azure OpenAI.

Ако желите да покренете ове узорке, потребно је да додате следеће променљиве окружења у вашу .env датотеку:

Страница прегледа (Пројекат)

Центар за управљање

Страница модела + крајњих тачака

Azure портал

Спољна веб страница

Подешавање аутентификације без кључа

Уместо да хардкодујете своје акредитиве, користићемо везу без кључа са Azure OpenAI. Да бисмо то урадили, увешћемо DefaultAzureCredential и касније позвати функцију DefaultAzureCredential да добијемо акредитиве.

from azure.identity import DefaultAzureCredential, InteractiveBrowserCredential

Заглавили сте негде?

Ако имате било каквих проблема са покретањем овог подешавања, придружите се нашем

или.

Следећа лекција

Сада сте спремни да покренете код за овај курс. Срећно у учењу више о свету AI агената!

Увод у AI агенте и њихове случајеве употребе

Одрицање од одговорности:
Овај документ је преведен коришћењем услуге за превођење помоћу вештачке интелигенције Co-op Translator. Иако се трудимо да обезбедимо тачност, молимо вас да имате у виду да аутоматски преводи могу садржати грешке или нетачности. Оригинални документ на његовом изворном језику треба сматрати меродавним извором. За критичне информације препоручује се професионални превод од стране људи. Не преузимамо одговорност за било каква погрешна тумачења или неспоразуме који могу настати услед коришћења овог превода.

This site is open source. Improve this page.