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

Цео репозиторијум може бити велики (~3 GB) када преузмете целу историју и све датотеке. Ако само присуствујете радионици или вам требају само неке фасцикле лекција, плитко клонирање (или делимично клонирање) избегава већину тог преузимања скраћивањем историје и/или прескакањем великих датотека.
Замените <your-username> у наредним командама са URL вашег форка (или URL оригиналног репозиторијума ако то више волите).
Да бисте клонирали само најновију историју комита (мало преузимање):
git clone --depth 1 https://github.com/<your-username>/ai-agents-for-beginners.git
Да бисте клонирали одређену грану:
git clone --depth 1 --branch <branch-name> https://github.com/<your-username>/ai-agents-for-beginners.git
Ово користи делимично клонирање и спарсно-прегледавање (захтева Git 2.25+ и препоручује се модерни Git са подршком за делимично клонирање):
git clone --depth 1 --filter=blob:none --sparse https://github.com/<your-username>/ai-agents-for-beginners.git
Уђите у фасциклу репозиторијума:
За bash:
cd ai-agents-for-beginners
За Powershell:
Set-Location ai-agents-for-beginners
Затим наведите које фасцикле желите (пример испод показује две фасцикле):
git sparse-checkout set 00-course-setup 01-intro-to-ai-agents
Након клонирања и провере датотека, ако вам требају само датотеке и желите да ослободите простор (без историје git-а), обришите метаподатке репозиторијума (💀неповратно — изгубићете све функције Git-а: нема комита, повлачења, гурања или приступа историји).
За Linux/macOS:
rm -rf .git
За Windows:
Remove-Item -Recurse -Force .git
Направите нови Codespace за овај репозиторијум преко 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)
Охрабрујемо вас да испробате све три врсте примера како бисте видели која вам највише одговара.
Коју год опцију да изаберете, она ће одредити које кораке за подешавање треба да следите у наставку:
НАПОМЕНА: Ако немате инсталиран Python3.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.
Ово можете урадити тако што ћете отићи на подешавања личних приступних токена у вашем 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. Иако се трудимо да обезбедимо тачност, молимо вас да имате у виду да аутоматски преводи могу садржати грешке или нетачности. Оригинални документ на његовом изворном језику треба сматрати меродавним извором. За критичне информације препоручује се професионални превод од стране људи. Не преузимамо одговорност за било каква погрешна тумачења или неспоразуме који могу настати услед коришћења овог превода.