Táto lekcia sa zameriava na to, ako spustiť ukážky kódu z tohto kurzu.
Predtým, než začnete klonovať svoje úložisko, pripojte sa k Discord kanálu 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ýmto 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:
Tento kurz ponúka sériu Jupyter Notebookov, ktoré môžete spustiť, aby ste získali praktické skúsenosti s tvorbou AI agentov.
Ukážky kódu používajú:
Vyžaduje GitHub účet - 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 Azure predplatné: 3) Azure AI Foundry + Azure AI Agent Service. Označené ako (azureaiagent.ipynb)
Odporúčame vyskúšať všetky tri typy príkladov, aby ste zistili, ktorý vám najviac vyhovuje.
Podľa toho, ktorú možnosť si vyberiete, sa určí, ktoré kroky nastavenia musíte vykonať nižšie:
POZNÁMKA: 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 requirements.txt súboru.
Príklad
Vytvorte adresár Python venv:
python3 -m venv venv
Potom aktivujte venv prostredie 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ť Python virtuálne prostredie, aby ste sa vyhli 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 (LLMs), ktoré budete používať na tvorbu AI agentov.
Na používanie GitHub Models budete musieť vytvoriť GitHub Personal Access Token.
Toto môžete urobiť tak, že prejdete na nastavenia Personal Access Tokens vo vašom GitHub účte.
Prosím, dodržujte princíp minimálnych oprávnení pri vytváraní tokenu. To znamená, že by ste mali tokenu poskytnúť iba tie oprávnenia, ktoré sú potrebné na spustenie ukážok kódu v tomto kurze.
Na ľavej strane obrazovky vyberte možnosť Fine-grained tokens
v sekcii 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 vyššiu bezpečnosť môžete zvoliť kratšie obdobie, napríklad 7 dní 🛡️
Je to skvelý spôsob, ako si stanoviť osobný cieľ a dokončiť kurz, kým je vaše učenie v plnom prúde 🚀.
Obmedzte rozsah tokenu na váš fork tohto úložiska.
Obmedzte oprávnenia tokenu: V sekcii Permissions kliknite na záložku Account a stlačte tlačidlo “+ Add permissions”. Zobrazí sa rozbaľovacie menu. 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 správcu hesiel, pretože po jeho vytvorení už nebude zobrazený.
Skopírujte svoj nový token, ktorý ste práve vytvorili. Teraz ho pridáte do súboru .env
zahrnutého v tomto kurze.
.env
súborNa vytvorenie .env
súboru spustite nasledujúci príkaz vo vašom termináli.
cp .env.example .env
Týmto sa skopíruje príkladový súbor a vytvorí .env
vo vašom adresári, kde vyplníte hodnoty pre premenné prostredia.
So skopírovaným tokenom otvorte .env
súbor vo vašom obľúbenom textovom editore a vložte 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 hubových zdrojov
Keď ste vytvorili svoj projekt, budete musieť získať reťazec pripojenia pre váš projekt.
Toto môžete urobiť tak, že prejdete na stránku Overview vášho projektu v Azure AI Foundry portáli.
.env
súborNa vytvorenie .env
súboru spustite nasledujúci príkaz vo vašom termináli.
cp .env.example .env
Týmto sa skopíruje príkladový súbor a vytvorí .env
vo vašom adresári, kde vyplníte hodnoty pre premenné prostredia.
So skopírovaným tokenom otvorte .env
súbor vo vašom obľúbenom textovom editore a vložte token do poľa PROJECT_ENDPOINT
.
Ako bezpečnostné odporúčanie použijeme autentifikáciu bez kľúčov na autentifikáciu do Azure OpenAI pomocou Microsoft Entra ID.
Ďalej otvorte terminál a spustite az login --use-device-code
, aby ste sa prihlásili do svojho Azure účtu.
Po prihlásení vyberte svoje predplatné v termináli.
Pre lekciu Agentic RAG - Lekcia 5 - sú tu ukážky, ktoré používajú Azure Search a Azure OpenAI.
Ak chcete spustiť tieto ukážky, budete musieť pridať nasledujúce premenné prostredia do vášho .env
súboru:
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 v záložke 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
- Pod 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 Azure AI Search zdroj, kliknite na to a pozrite si Overview.
AZURE_SEARCH_API_KEY
- Potom prejdite na Settings a potom Keys, aby ste skopírovali primárny alebo sekundárny admin kľúč.
AZURE_OPENAI_API_VERSION
- Navštívte stránku API version lifecycle pod Latest GA API release.Namiesto pevného kódovania vašich poverení použijeme pripojenie bez kľúčov s Azure OpenAI. Na tento účel 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 nášho Azure AI Community Discord alebo vytvorte issue.
Teraz ste pripravení spustiť kód z tohto kurzu. Prajeme vám veľa úspechov 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. Nenesieme zodpovednosť za akékoľvek nedorozumenia alebo nesprávne interpretácie vyplývajúce z použitia tohto prekladu.