Táto lekcia sa zaoberá tým, ako spustiť ukážky kódu z tohto kurzu.
Predtým, než začnete klonovať svoje úložisko, pripojte sa na Discord kanál AI Agents For Beginners, kde môžete získať pomoc s nastavením, odpovede na otázky týkajúce sa kurzu alebo sa spojiť s ostatnými študentmi.
Na začiatok si prosím klonujte alebo forknite GitHub úložisko. Tým si vytvoríte vlastnú verziu materiálov kurzu, aby ste mohli spúšťať, testovať a upravovať kód!
Toto môžete urobiť kliknutím na odkaz forknúť úložisko
Teraz by ste mali mať vlastnú forknutú verziu tohto kurzu na nasledujúcom odkaze:

Celé úložisko môže byť veľké (~3 GB) pri sťahovaní celej histórie a všetkých súborov. Ak sa zúčastňujete iba workshopu alebo potrebujete len niekoľko priečinkov z lekcií, plytké klonovanie (alebo riedke klonovanie) zabráni väčšine tohto sťahovania tým, že skráti históriu a/alebo preskočí niektoré súbory.
Nahraďte <your-username> v nasledujúcich príkazoch URL adresou vášho forku (alebo upstream URL, ak preferujete).
Na klonovanie iba najnovšej histórie commitov (malé sťahovanie):
git clone --depth 1 https://github.com/<your-username>/ai-agents-for-beginners.git
Na klonovanie konkrétnej vetvy:
git clone --depth 1 --branch <branch-name> https://github.com/<your-username>/ai-agents-for-beginners.git
Toto využíva čiastočné klonovanie a sparse-checkout (vyžaduje Git 2.25+ a odporúča sa moderný Git s podporou čiastočného klonovania):
git clone --depth 1 --filter=blob:none --sparse https://github.com/<your-username>/ai-agents-for-beginners.git
Prejdite do priečinka úložiska:
Pre bash:
cd ai-agents-for-beginners
Pre Powershell:
Set-Location ai-agents-for-beginners
Potom špecifikujte, ktoré priečinky chcete (príklad nižšie ukazuje dva priečinky):
git sparse-checkout set 00-course-setup 01-intro-to-ai-agents
Po klonovaní a overení súborov, ak potrebujete iba súbory a chcete uvoľniť miesto (bez histórie git), prosím, odstráňte metadáta úložiska (💀nevratné — stratíte všetky funkcie Git: žiadne commity, pull, push alebo prístup k histórii).
Pre Linux/macOS:
rm -rf .git
Pre Windows:
Remove-Item -Recurse -Force .git
Vytvorte nový Codespace pre toto úložisko cez GitHub UI.
Tento kurz ponúka sériu Jupyter Notebooks, ktoré môžete spustiť, aby ste získali praktické skúsenosti s vytváraním AI agentov.
Ukážky kódu používajú buď:
Vyžaduje účet na GitHub - zdarma:
1) Semantic Kernel Agent Framework + GitHub Models Marketplace. Označené ako (semantic-kernel.ipynb) 2) AutoGen Framework + GitHub Models Marketplace. Označené ako (autogen.ipynb)
Vyžaduje predplatné Azure: 3) Azure AI Foundry + Azure AI Agent Service. Označené ako (azureaiagent.ipynb)
Odporúčame vám vyskúšať všetky tri typy príkladov, aby ste zistili, ktorý vám najviac vyhovuje.
Nech si vyberiete akúkoľvek možnosť, určí to, ktoré kroky nastavenia budete musieť vykonať nižšie:
NOTE: Ak nemáte nainštalovaný Python 3.12, uistite sa, že ho nainštalujete. Potom vytvorte svoj venv pomocou python3.12, aby ste zabezpečili správne verzie z súboru requirements.txt.
Príklad
Vytvorte adresár Python venv:
python3 -m venv venv
Potom aktivujte prostredie venv pre:
macOS a Linux
source venv/bin/activate
Windows
venv\Scripts\activate
V koreňovom adresári tohto úložiska sme zahrnuli súbor requirements.txt, ktorý obsahuje všetky potrebné Python balíčky na spustenie ukážok kódu.
Môžete ich nainštalovať spustením nasledujúceho príkazu vo vašom termináli v koreňovom adresári úložiska:
pip install -r requirements.txt
Odporúčame vytvoriť virtuálne prostredie Python, aby ste sa vyhli akýmkoľvek konfliktom a problémom.
Uistite sa, že používate správnu verziu Pythonu vo VSCode.
Tento kurz využíva GitHub Models Marketplace, ktorý poskytuje bezplatný prístup k veľkým jazykovým modelom (LLM), ktoré budete používať na vytváranie AI agentov.
Na použitie GitHub Models budete musieť vytvoriť osobný prístupový token na GitHub.
Toto môžete urobiť tak, že prejdete na nastavenia osobných prístupových tokenov vo svojom účte na GitHub.
Prosím, dodržiavajte princíp minimálnych oprávnení pri vytváraní tokenu. To znamená, že by ste mali tokenu prideliť iba tie oprávnenia, ktoré sú potrebné na spustenie ukážok kódu v tomto kurze.
Vyberte možnosť Fine-grained tokens na ľavej strane obrazovky prechodom na Developer settings

Potom vyberte Generate new token.

Zadajte popisný názov pre váš token, ktorý odráža jeho účel, aby ste ho neskôr ľahko identifikovali.
🔐 Odporúčanie pre trvanie tokenu
Odporúčané trvanie: 30 dní Pre bezpečnejší prístup môžete zvoliť kratšie obdobie — napríklad 7 dní 🛡️ Je to skvelý spôsob, ako si nastaviť osobný cieľ a dokončiť kurz, kým je vaša motivácia vysoká 🚀.

Obmedzte rozsah tokenu na váš fork tohto úložiska.

Obmedzte oprávnenia tokenu: V časti Permissions kliknite na kartu Account a stlačte tlačidlo “+ Add permissions”. Zobrazí sa rozbaľovacie menu. Prosím, vyhľadajte Models a zaškrtnite políčko.

Pred generovaním tokenu overte požadované oprávnenia. 
Pred generovaním tokenu sa uistite, že ste pripravení uložiť token na bezpečné miesto, ako je trezor na heslá, pretože po jeho vytvorení ho už nebudete môcť znova zobraziť. 
Skopírujte svoj nový token, ktorý ste práve vytvorili. Teraz ho pridáte do súboru .env, ktorý je súčasťou tohto kurzu.
.env súborNa vytvorenie súboru .env spustite nasledujúci príkaz vo svojom termináli.
cp .env.example .env
Týmto sa skopíruje príkladový súbor a vytvorí sa .env vo vašom adresári, kde vyplníte hodnoty pre premenné prostredia.
S vaším skopírovaným tokenom otvorte súbor .env vo svojom obľúbenom textovom editore a vložte svoj token do poľa GITHUB_TOKEN.

Teraz by ste mali byť schopní spustiť ukážky kódu z tohto kurzu.
Postupujte podľa krokov na vytvorenie hubu a projektu v Azure AI Foundry, ktoré nájdete tu: Prehľad zdrojov hubu
Keď vytvoríte svoj projekt, budete musieť získať reťazec pripojenia k vášmu projektu.
Toto môžete urobiť tak, že prejdete na stránku Overview vášho projektu v portáli Azure AI Foundry.

.env súborNa vytvorenie súboru .env spustite nasledujúci príkaz vo svojom termináli.
cp .env.example .env
Týmto sa skopíruje príkladový súbor a vytvorí sa .env vo vašom adresári, kde vyplníte hodnoty pre premenné prostredia.
S vaším skopírovaným tokenom otvorte súbor .env vo svojom obľúbenom textovom editore a vložte svoj token do poľa PROJECT_ENDPOINT.
Ako najlepšiu bezpečnostnú prax použijeme autentifikáciu bez kľúča na autentifikáciu do Azure OpenAI pomocou Microsoft Entra ID.
Ďalej otvorte terminál a spustite príkaz az login --use-device-code na prihlásenie do svojho účtu Azure.
Po prihlásení vyberte svoje predplatné v termináli.
Pre lekciu Agentic RAG - Lekcia 5 - existujú ukážky, ktoré používajú Azure Search a Azure OpenAI.
Ak chcete spustiť tieto ukážky, budete musieť pridať nasledujúce premenné prostredia do svojho súboru .env:
AZURE_SUBSCRIPTION_ID - Skontrolujte Project details na stránke Overview vášho projektu.
AZURE_AI_PROJECT_NAME - Pozrite sa na vrch stránky Overview vášho projektu.
AZURE_OPENAI_SERVICE - Nájdite to na karte Included capabilities pre Azure OpenAI Service na stránke Overview.
AZURE_OPENAI_RESOURCE_GROUP - Prejdite na Project properties na stránke Overview v Management Center.
GLOBAL_LLM_SERVICE - V časti Connected resources nájdite názov pripojenia Azure AI Services. Ak nie je uvedený, skontrolujte Azure portal vo vašej skupine zdrojov pre názov zdroja AI Services.
AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME - Vyberte svoj embedding model (napr. text-embedding-ada-002) a poznačte si Deployment name z detailov modelu.
AZURE_OPENAI_CHAT_DEPLOYMENT_NAME - Vyberte svoj chat model (napr. gpt-4o-mini) a poznačte si Deployment name z detailov modelu.
AZURE_OPENAI_ENDPOINT - Vyhľadajte Azure AI services, kliknite na to, potom prejdite na Resource Management, Keys and Endpoint, posuňte sa dole na “Azure OpenAI endpoints” a skopírujte ten, ktorý hovorí “Language APIs”.
AZURE_OPENAI_API_KEY - Z tej istej obrazovky skopírujte KEY 1 alebo KEY 2.
AZURE_SEARCH_SERVICE_ENDPOINT - Nájdite svoj zdroj Azure AI Search, kliknite naň a pozrite si Overview.
AZURE_SEARCH_API_KEY - Potom prejdite na Settings a potom Keys, aby ste skopírovali primárny alebo sekundárny administrátorský kľúč.
AZURE_OPENAI_API_VERSION - Navštívte stránku API version lifecycle pod Latest GA API release.Namiesto pevného zakódovania vašich poverení použijeme pripojenie bez kľúča s Azure OpenAI. Na to importujeme DefaultAzureCredential a neskôr zavoláme funkciu DefaultAzureCredential, aby sme získali poverenie.
from azure.identity import DefaultAzureCredential, InteractiveBrowserCredential
Ak máte akékoľvek problémy s týmto nastavením, pripojte sa do našej Azure AI Community Discord alebo vytvorte problém.
Teraz ste pripravení spustiť kód pre tento kurz. Prajem vám veľa zábavy pri objavovaní sveta AI agentov!
Úvod do AI agentov a ich využitia
Upozornenie:
Tento dokument bol preložený pomocou služby AI prekladu Co-op Translator. Hoci sa snažíme o presnosť, prosím, berte na vedomie, že automatizované preklady môžu obsahovať chyby alebo nepresnosti. Pôvodný dokument v jeho rodnom jazyku by mal byť považovaný za autoritatívny zdroj. Pre kritické informácie sa odporúča profesionálny ľudský preklad. Nie sme zodpovední za žiadne nedorozumenia alebo nesprávne interpretácie vyplývajúce z použitia tohto prekladu.