Ova lekcija obuhvaća kako pokrenuti primjere koda iz ovog tečaja.
Prije nego što počnete klonirati svoj repozitorij, pridružite se AI Agents For Beginners Discord kanalu kako biste dobili pomoć oko postavljanja, postavili pitanja o tečaju ili se povezali s drugim polaznicima.
Za početak, klonirajte ili forkajte GitHub repozitorij. Time ćete dobiti vlastitu verziju materijala tečaja kako biste mogli pokretati, testirati i prilagođavati kod!
To možete učiniti klikom na poveznicu za forkanje repozitorija.
Sada biste trebali imati vlastitu forkanu verziju ovog tečaja na sljedećoj poveznici:

Cijeli repozitorij može biti velik (~3 GB) kada preuzimate cijelu povijest i sve datoteke. Ako samo prisustvujete radionici ili trebate samo nekoliko mapa lekcija, plitko kloniranje (ili rijetko kloniranje) izbjegava većinu tog preuzimanja skraćivanjem povijesti i/ili preskakanjem blobova.
Zamijenite <your-username> u naredbama ispod s URL-om vašeg forka (ili izvornim URL-om ako to preferirate).
Za kloniranje samo najnovije povijesti commitova (malo preuzimanje):
git clone --depth 1 https://github.com/<your-username>/ai-agents-for-beginners.git
Za kloniranje određene grane:
git clone --depth 1 --branch <branch-name> https://github.com/<your-username>/ai-agents-for-beginners.git
Ovo koristi djelomično kloniranje i rijetko preuzimanje (zahtijeva Git 2.25+ i preporučuje se moderni Git s podrškom za djelomično kloniranje):
git clone --depth 1 --filter=blob:none --sparse https://github.com/<your-username>/ai-agents-for-beginners.git
Uđite u mapu repozitorija:
Za bash:
cd ai-agents-for-beginners
Za Powershell:
Set-Location ai-agents-for-beginners
Zatim odredite koje mape želite (primjer ispod prikazuje dvije mape):
git sparse-checkout set 00-course-setup 01-intro-to-ai-agents
Nakon kloniranja i provjere datoteka, ako trebate samo datoteke i želite osloboditi prostor (bez povijesti gita), izbrišite metapodatke repozitorija (💀nepovratno — izgubit ćete svu funkcionalnost Gita: nema commitova, povlačenja, guranja ili pristupa povijesti).
Za Linux/macOS:
rm -rf .git
Za Windows:
Remove-Item -Recurse -Force .git
Kreirajte novi Codespace za ovaj repozitorij putem GitHub sučelja.
Ovaj tečaj nudi niz Jupyter Notebooks datoteka koje možete pokrenuti kako biste stekli praktično iskustvo u izradi AI agenata.
Primjeri koda koriste:
Zahtijeva GitHub račun - besplatno:
1) Semantic Kernel Agent Framework + GitHub Models Marketplace. Označeno kao (semantic-kernel.ipynb) 2) AutoGen Framework + GitHub Models Marketplace. Označeno kao (autogen.ipynb)
Zahtijeva Azure pretplatu: 3) Azure AI Foundry + Azure AI Agent Service. Označeno kao (azureaiagent.ipynb)
Preporučujemo da isprobate sve tri vrste primjera kako biste vidjeli koji vam najbolje odgovara.
Koju god opciju odabrali, ona će odrediti koje korake postavljanja trebate slijediti u nastavku:
NAPOMENA: Ako nemate instaliran Python 3.12, osigurajte da ga instalirate. Zatim kreirajte svoj venv koristeći python3.12 kako biste osigurali da su ispravne verzije instalirane iz datoteke requirements.txt.
Primjer
Kreirajte direktorij za Python venv:
python3 -m venv venv
Zatim aktivirajte venv okruženje za:
macOS i Linux
source venv/bin/activate
Windows
venv\Scripts\activate
U korijenu ovog repozitorija uključili smo datoteku requirements.txt koja sadrži sve potrebne Python pakete za pokretanje primjera koda.
Možete ih instalirati pokretanjem sljedeće naredbe u terminalu na korijenu repozitorija:
pip install -r requirements.txt
Preporučujemo kreiranje Python virtualnog okruženja kako biste izbjegli konflikte i probleme.
Provjerite koristite li ispravnu verziju Pythona u VSCodeu.
Ovaj tečaj koristi GitHub Models Marketplace, koji pruža besplatan pristup velikim jezičnim modelima (LLM-ovima) koje ćete koristiti za izradu AI agenata.
Za korištenje GitHub modela, trebate kreirati GitHub osobni pristupni token.
To možete učiniti odlaskom na postavke osobnih pristupnih tokena u svom GitHub računu.
Molimo slijedite Princip najmanjih privilegija prilikom kreiranja tokena. To znači da tokenu trebate dodijeliti samo one dozvole koje su potrebne za pokretanje primjera koda u ovom tečaju.
Odaberite opciju Fine-grained tokens na lijevoj strani ekrana prelaskom na Developer settings.

Zatim odaberite Generate new token.

Unesite opisno ime za svoj token koje odražava njegovu svrhu, kako biste ga kasnije lako identificirali.
🔐 Preporuka za trajanje tokena
Preporučeno trajanje: 30 dana Za sigurniji pristup možete odabrati kraći period—na primjer, 7 dana 🛡️ To je odličan način da postavite osobni cilj i završite tečaj dok je vaš entuzijazam za učenje visok 🚀.

Ograničite opseg tokena na vaš fork ovog repozitorija.

Ograničite dozvole tokena: Pod Permissions, kliknite karticu Account, zatim kliknite gumb “+ Add permissions”. Pojavit će se padajući izbornik. Potražite Models i označite okvir za to.

Provjerite potrebne dozvole prije generiranja tokena. 
Prije generiranja tokena, osigurajte da ste spremni pohraniti token na sigurno mjesto poput trezora upravitelja lozinki, jer neće biti prikazan ponovno nakon što ga kreirate. 
Kopirajte svoj novi token koji ste upravo kreirali. Sada ćete ga dodati u svoju .env datoteku uključenu u ovaj tečaj.
.env datotekuZa kreiranje .env datoteke pokrenite sljedeću naredbu u terminalu.
cp .env.example .env
Ovo će kopirati primjer datoteke i kreirati .env u vašem direktoriju gdje ćete popuniti vrijednosti za varijable okruženja.
S kopiranim tokenom, otvorite .env datoteku u svom omiljenom uređivaču teksta i zalijepite svoj token u polje GITHUB_TOKEN.

Sada biste trebali moći pokrenuti primjere koda iz ovog tečaja.
Slijedite korake za kreiranje huba i projekta u Azure AI Foundryju ovdje: Pregled resursa huba
Nakon što ste kreirali svoj projekt, trebate dohvatiti vezni niz za svoj projekt.
To možete učiniti odlaskom na stranicu Overview vašeg projekta u Azure AI Foundry portalu.

.env datotekuZa kreiranje .env datoteke pokrenite sljedeću naredbu u terminalu.
cp .env.example .env
Ovo će kopirati primjer datoteke i kreirati .env u vašem direktoriju gdje ćete popuniti vrijednosti za varijable okruženja.
S kopiranim tokenom, otvorite .env datoteku u svom omiljenom uređivaču teksta i zalijepite svoj token u polje PROJECT_ENDPOINT.
Kao sigurnosnu najbolju praksu, koristit ćemo autentifikaciju bez ključa za autentifikaciju na Azure OpenAI s Microsoft Entra ID-om.
Zatim otvorite terminal i pokrenite az login --use-device-code kako biste se prijavili na svoj Azure račun.
Nakon što ste se prijavili, odaberite svoju pretplatu u terminalu.
Za lekciju Agentic RAG - Lekcija 5 - postoje primjeri koji koriste Azure Search i Azure OpenAI.
Ako želite pokrenuti te primjere, trebate dodati sljedeće varijable okruženja u svoju .env datoteku:
AZURE_SUBSCRIPTION_ID - Provjerite Project details na stranici Overview vašeg projekta.
AZURE_AI_PROJECT_NAME - Pogledajte vrh stranice Overview vašeg projekta.
AZURE_OPENAI_SERVICE - Pronađite ovo na kartici Included capabilities za Azure OpenAI Service na stranici Overview.
AZURE_OPENAI_RESOURCE_GROUP - Idite na Project properties na stranici Overview u Management Centeru.
GLOBAL_LLM_SERVICE - Pod Connected resources, pronađite naziv veze za Azure AI Services. Ako nije navedeno, provjerite Azure portal pod vašom grupom resursa za naziv resursa AI Services.
AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME - Odaberite svoj model za ugrađivanje (npr. text-embedding-ada-002) i zabilježite Deployment name iz detalja modela.
AZURE_OPENAI_CHAT_DEPLOYMENT_NAME - Odaberite svoj model za chat (npr. gpt-4o-mini) i zabilježite Deployment name iz detalja modela.
AZURE_OPENAI_ENDPOINT - Potražite Azure AI services, kliknite na to, zatim idite na Resource Management, Keys and Endpoint, pomaknite se dolje do “Azure OpenAI endpoints” i kopirajte onaj koji kaže “Language APIs”.
AZURE_OPENAI_API_KEY - S iste stranice, kopirajte KLJUČ 1 ili KLJUČ 2.
AZURE_SEARCH_SERVICE_ENDPOINT - Pronađite svoj Azure AI Search resurs, kliknite na njega i pogledajte Overview.
AZURE_SEARCH_API_KEY - Zatim idite na Settings i zatim Keys kako biste kopirali primarni ili sekundarni administratorski ključ.
AZURE_OPENAI_API_VERSION - Posjetite stranicu API verzija životnog ciklusa pod Latest GA API release.Umjesto da hardkodiramo vaše vjerodajnice, koristit ćemo vezu bez ključa s Azure OpenAI. Za to ćemo uvesti DefaultAzureCredential i kasnije pozvati funkciju DefaultAzureCredential kako bismo dobili vjerodajnicu.
from azure.identity import DefaultAzureCredential, InteractiveBrowserCredential
Ako imate bilo kakvih problema s pokretanjem ove postavke, pridružite se našem Azure AI Community Discordu ili otvorite problem.
Sada ste spremni pokrenuti kod za ovaj tečaj. Sretno u daljnjem učenju o svijetu AI agenata!
Uvod u AI agente i primjere upotrebe agenata
Odricanje od odgovornosti:
Ovaj dokument je preveden pomoću AI usluge za prevođenje Co-op Translator. Iako nastojimo osigurati točnost, imajte na umu da automatski prijevodi mogu sadržavati pogreške ili netočnosti. Izvorni dokument na izvornom jeziku treba smatrati autoritativnim izvorom. Za ključne informacije preporučuje se profesionalni prijevod od strane čovjeka. Ne preuzimamo odgovornost za nesporazume ili pogrešna tumačenja koja proizlaze iz korištenja ovog prijevoda.