Ова лекција ће обухватити како да покренете примере кода из овог курса.
Пре него што почнете са клонирањем вашег репозиторијума, придружите се Discord каналу AI Agents For Beginners да бисте добили помоћ око подешавања, поставили питања о курсу или се повезали са другим учесницима.
Да бисте започели, клонирајте или форкујте GitHub репозиторијум. Ово ће направити вашу верзију материјала курса како бисте могли да покрећете, тестирате и прилагођавате код!
Ово можете урадити кликом на линк за форковање репозиторијума.
Сада би требало да имате своју форковану верзију овог курса на следећем линку:
Овај курс нуди серију Jupyter Notebooks које можете покренути како бисте стекли практично искуство у изградњи 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)
Препоручујемо вам да испробате све три врсте примера како бисте видели који вам најбоље одговара.
Опција коју изаберете одредиће које кораке за подешавање треба да следите у наставку:
НАПОМЕНА: Ако немате Python 3.12 инсталиран, уверите се да сте га инсталирали. Затим креирајте свој venv користећи python3.12 како бисте осигурали да су исправне верзије инсталиране из датотеке requirements.txt.
Пример
Креирајте директоријум Python venv:
python3 -m venv venv
Затим активирајте venv окружење за:
macOS и Linux
source venv/bin/activate
Windows
venv\Scripts\activate
У корену овог репозиторијума укључили смо датотеку requirements.txt
која садржи све потребне Python пакете за покретање примера кода.
Можете их инсталирати покретањем следеће команде у вашем терминалу у корену репозиторијума:
pip install -r requirements.txt
Препоручујемо креирање Python виртуелног окружења како бисте избегли било какве конфликте и проблеме.
Уверите се да користите исправну верзију Python-а у VSCode.
Овај курс користи GitHub Models Marketplace, који пружа бесплатан приступ великим језичким моделима (LLMs) које ћете користити за изградњу AI агената.
Да бисте користили GitHub моделе, потребно је да креирате GitHub Personal Access Token.
Ово можете урадити тако што ћете отићи на подешавања Personal Access Tokens у вашем GitHub налогу.
Молимо вас да следите Принцип минималних привилегија приликом креирања вашег токена. То значи да токену треба дати само дозволе које су му потребне за покретање примера кода у овом курсу.
Изаберите опцију Fine-grained tokens
на левој страни екрана тако што ћете отићи на Developer settings.
Затим изаберите Generate new token
.
Унесите описно име за ваш токен које одражава његову сврху, како би га касније лако идентификовали.
🔐 Препорука за трајање токена
Препоручено трајање: 30 дана
За сигурнији приступ, можете изабрати краћи период—на пример, 7 дана 🛡️
Ово је одличан начин да поставите лични циљ и завршите курс док је ваш ентузијазам за учење висок 🚀.
Ограничите опсег токена на ваш форк овог репозиторијума.
Ограничите дозволе токена: Под Permissions, кликните на картицу Account, а затим на дугме “+ Add permissions”. Појавиће се падајући мени. Потражите Models и означите поље за њега.
Проверите потребне дозволе пре него што генеришете токен.
Пре него што генеришете токен, уверите се да сте спремни да га сачувате на сигурном месту, као што је менаџер лозинки, јер неће бити приказан поново након креирања.
Копирајте ваш нови токен који сте управо креирали. Сада ћете га додати у .env
датотеку укључену у овај курс.
.env
датотекуДа бисте креирали .env
датотеку, покрените следећу команду у вашем терминалу.
cp .env.example .env
Ово ће копирати пример датотеке и креирати .env
у вашем директоријуму, где ћете попунити вредности за променљиве окружења.
Са копираним токеном, отворите .env
датотеку у вашем омиљеном текст едитору и налепите ваш токен у поље GITHUB_TOKEN
.
Сада би требало да можете да покренете примере кода из овог курса.
Пратите кораке за креирање хаба и пројекта у Azure AI Foundry овде: Hub resources overview
Када креирате ваш пројекат, потребно је да преузмете стринг за повезивање вашег пројекта.
Ово можете урадити тако што ћете отићи на страницу Overview вашег пројекта у Azure AI Foundry порталу.
.env
датотекуДа бисте креирали .env
датотеку, покрените следећу команду у вашем терминалу.
cp .env.example .env
Ово ће копирати пример датотеке и креирати .env
у вашем директоријуму, где ћете попунити вредности за променљиве окружења.
Са копираним токеном, отворите .env
датотеку у вашем омиљеном текст едитору и налепите ваш токен у поље PROJECT_ENDPOINT
.
Као најбољу праксу за безбедност, користићемо аутентификацију без кључа за аутентификацију на Azure OpenAI са Microsoft Entra ID.
Затим, отворите терминал и покрените az login --use-device-code
да бисте се пријавили на ваш Azure налог.
Када се пријавите, изаберите вашу претплату у терминалу.
За лекцију Agentic RAG - Лекција 5 - постоје примери који користе Azure Search и Azure OpenAI.
Ако желите да покренете ове примере, потребно је да додате следеће променљиве окружења у вашу .env
датотеку:
AZURE_SUBSCRIPTION_ID
- Проверите Project details на страници Overview вашег пројекта.
AZURE_AI_PROJECT_NAME
- Погледајте врх странице Overview вашег пројекта.
AZURE_OPENAI_SERVICE
- Пронађите ово у картици Included capabilities за Azure OpenAI Service на страници Overview.
AZURE_OPENAI_RESOURCE_GROUP
- Идите на Project properties на страници Overview у Management Center.
GLOBAL_LLM_SERVICE
- Под Connected resources, пронађите име везе за Azure AI Services. Ако није наведено, проверите Azure portal у вашој групи ресурса за име ресурса AI Services.
AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME
- Изаберите ваш модел за уграђивање (нпр. text-embedding-ada-002
) и забележите Deployment name из детаља модела.
AZURE_OPENAI_CHAT_DEPLOYMENT_NAME
- Изаберите ваш модел за ћаскање (нпр. gpt-4o-mini
) и забележите Deployment name из детаља модела.
AZURE_OPENAI_ENDPOINT
- Потражите Azure AI services, кликните на њих, затим идите на Resource Management, Keys and Endpoint, скролујте до “Azure OpenAI endpoints” и копирајте ону која каже “Language APIs”.
AZURE_OPENAI_API_KEY
- Са истог екрана, копирајте КЉУЧ 1 или КЉУЧ 2.
AZURE_SEARCH_SERVICE_ENDPOINT
- Пронађите ваш Azure AI Search ресурс, кликните на њега и погледајте Overview.
AZURE_SEARCH_API_KEY
- Затим идите на Settings и затим Keys да бисте копирали примарни или секундарни администраторски кључ.
AZURE_OPENAI_API_VERSION
- Посетите страницу API version lifecycle под Latest GA API release.Уместо да хардкодујете ваше акредитиве, користићемо везу без кључа са Azure OpenAI. Да бисмо то урадили, увешћемо DefaultAzureCredential
и касније позвати функцију DefaultAzureCredential
да бисмо добили акредитиве.
from azure.identity import DefaultAzureCredential, InteractiveBrowserCredential
Ако имате било каквих проблема са покретањем овог подешавања, придружите се нашем Azure AI Community Discord или отворите питање.
Сада сте спремни да покренете код за овај курс. Срећно у учењу више о свету AI агената!
Увод у AI агенте и случајеве употребе агената
Одрицање од одговорности:
Овај документ је преведен помоћу услуге за превођење вештачке интелигенције Co-op Translator. Иако се трудимо да обезбедимо тачност, молимо вас да имате у виду да аутоматски преводи могу садржати грешке или нетачности. Оригинални документ на његовом изворном језику треба сматрати меродавним извором. За критичне информације препоручује се професионални превод од стране људи. Не преузимамо одговорност за било каква погрешна тумачења или неспоразуме који могу произаћи из коришћења овог превода.