ai-agents-for-beginners

Nastavení kurzu

Úvod

Tato lekce se zaměřuje na spuštění ukázkového kódu z tohoto kurzu.

Připojte se k ostatním studentům a získejte pomoc

Než začnete klonovat svůj repozitář, připojte se na Discord kanál AI Agents For Beginners, kde můžete získat pomoc s nastavením, odpovědi na otázky ohledně kurzu nebo se spojit s ostatními studenty.

Klonování nebo forkování tohoto repozitáře

Začněte klonováním nebo forkováním GitHub repozitáře. Tím si vytvoříte vlastní verzi materiálů kurzu, abyste mohli spouštět, testovat a upravovat kód!

To můžete udělat kliknutím na odkaz fork repozitáře.

Nyní byste měli mít vlastní forkovanou verzi tohoto kurzu na následujícím odkazu:

Forkovaný repozitář

Spouštění kódu

Tento kurz nabízí sérii Jupyter Notebooků, které můžete spouštět, abyste získali praktické zkušenosti s tvorbou AI agentů.

Ukázky kódu využívají:

Vyžaduje GitHub účet - zdarma:

1) Semantic Kernel Agent Framework + GitHub Models Marketplace. Označeno jako (semantic-kernel.ipynb) 2) AutoGen Framework + GitHub Models Marketplace. Označeno jako (autogen.ipynb)

Vyžaduje Azure předplatné: 3) Azure AI Foundry + Azure AI Agent Service. Označeno jako (azureaiagent.ipynb)

Doporučujeme vyzkoušet všechny tři typy příkladů, abyste zjistili, který vám nejlépe vyhovuje.

Podle toho, kterou možnost si vyberete, budete muset postupovat podle příslušných kroků nastavení níže:

Požadavky

V kořenovém adresáři tohoto repozitáře jsme zahrnuli soubor requirements.txt, který obsahuje všechny požadované Python balíčky pro spuštění ukázek kódu.

Můžete je nainstalovat spuštěním následujícího příkazu v terminálu v kořenovém adresáři repozitáře:

pip install -r requirements.txt

Doporučujeme vytvořit Python virtuální prostředí, abyste předešli konfliktům a problémům.

Nastavení VSCode

Ujistěte se, že používáte správnou verzi Pythonu ve VSCode.

image

Nastavení pro ukázky využívající GitHub Models

Krok 1: Získání GitHub Personal Access Token (PAT)

Tento kurz využívá GitHub Models Marketplace, který poskytuje bezplatný přístup k modelům velkých jazykových modelů (LLMs), které budete používat k tvorbě AI agentů.

Pro použití GitHub Models budete muset vytvořit GitHub Personal Access Token.

To můžete udělat přechodem na nastavení Personal Access Tokens ve vašem GitHub účtu.

Postupujte podle Principu minimálních oprávnění při vytváření tokenu. To znamená, že byste měli tokenu přidělit pouze oprávnění, která jsou nezbytná pro spuštění ukázek kódu v tomto kurzu.

  1. Na levé straně obrazovky vyberte možnost Fine-grained tokens v sekci Developer settings.

    Poté vyberte Generate new token.

    Vytvořit token

  2. Zadejte popisný název pro váš token, který odráží jeho účel, aby bylo snadné jej později identifikovat.

    🔐 Doporučení pro dobu platnosti tokenu

    Doporučená doba platnosti: 30 dní
    Pro větší bezpečnost můžete zvolit kratší dobu, například 7 dní 🛡️
    Je to skvělý způsob, jak si stanovit osobní cíl a dokončit kurz, zatímco vaše učební motivace je vysoká 🚀.

    Název tokenu a datum vypršení platnosti

  3. Omezte rozsah tokenu na váš fork tohoto repozitáře.

    Omezit rozsah na fork repozitáře

  4. Omezte oprávnění tokenu: V sekci Permissions klikněte na záložku Account a poté na tlačítko “+ Add permissions”. Zobrazí se rozbalovací nabídka. Vyhledejte Models a zaškrtněte políčko. Přidat oprávnění Models

  5. Ověřte požadovaná oprávnění před vytvořením tokenu. Ověřit oprávnění

  6. Před vytvořením tokenu se ujistěte, že jste připraveni token uložit na bezpečné místo, například do trezoru správce hesel, protože po jeho vytvoření již nebude zobrazen. Bezpečně uložit token

Zkopírujte svůj nový token, který jste právě vytvořili. Nyní jej přidáte do souboru .env zahrnutého v tomto kurzu.

Krok 2: Vytvoření souboru .env

Pro vytvoření souboru .env spusťte následující příkaz ve svém terminálu.

cp .env.example .env

Tím se zkopíruje příkladový soubor a vytvoří .env ve vašem adresáři, kde vyplníte hodnoty pro proměnné prostředí.

S tokenem zkopírovaným, otevřete soubor .env ve svém oblíbeném textovém editoru a vložte token do pole GITHUB_TOKEN. Pole GitHub Token

Nyní byste měli být schopni spustit ukázky kódu z tohoto kurzu.

Nastavení pro ukázky využívající Azure AI Foundry a Azure AI Agent Service

Krok 1: Získání Azure Project Endpoint

Postupujte podle kroků pro vytvoření hubu a projektu v Azure AI Foundry zde: Přehled zdrojů hubu

Jakmile vytvoříte svůj projekt, budete muset získat připojovací řetězec pro váš projekt.

To lze provést přechodem na stránku Overview vašeho projektu v portálu Azure AI Foundry.

Připojovací řetězec projektu

Krok 2: Vytvoření souboru .env

Pro vytvoření souboru .env spusťte následující příkaz ve svém terminálu.

cp .env.example .env

Tím se zkopíruje příkladový soubor a vytvoří .env ve vašem adresáři, kde vyplníte hodnoty pro proměnné prostředí.

S tokenem zkopírovaným, otevřete soubor .env ve svém oblíbeném textovém editoru a vložte token do pole PROJECT_ENDPOINT.

Krok 3: Přihlášení do Azure

Jako bezpečnostní nejlepší praxi použijeme autentizaci bez klíče pro autentizaci do Azure OpenAI pomocí Microsoft Entra ID.

Otevřete terminál a spusťte az login --use-device-code pro přihlášení do svého Azure účtu.

Jakmile se přihlásíte, vyberte své předplatné v terminálu.

Další proměnné prostředí - Azure Search a Azure OpenAI

Pro lekci Agentic RAG - Lekce 5 - jsou zde ukázky, které využívají Azure Search a Azure OpenAI.

Pokud chcete tyto ukázky spustit, budete muset přidat následující proměnné prostředí do svého souboru .env:

Stránka přehledu (Projekt)

Centrum správy

Stránka Models + Endpoints

Azure Portal

Externí webová stránka

Nastavení autentizace bez klíče

Namísto pevného kódování vašich přihlašovacích údajů použijeme připojení bez klíče s Azure OpenAI. K tomu importujeme DefaultAzureCredential a později zavoláme funkci DefaultAzureCredential, abychom získali přihlašovací údaje.

from azure.identity import DefaultAzureCredential, InteractiveBrowserCredential

Máte problém?

Pokud máte jakékoli problémy s tímto nastavením, připojte se na náš Discord Azure AI Community nebo vytvořte issue.

Další lekce

Nyní jste připraveni spustit kód tohoto kurzu. Přejeme vám příjemné učení o světě AI agentů!

Úvod do AI agentů a jejich využití

Prohlášení:
Tento dokument byl přeložen pomocí služby AI pro překlady Co-op Translator. I když se snažíme o přesnost, mějte prosím na paměti, že automatizované překlady mohou obsahovat chyby nebo nepřesnosti. Původní dokument v jeho původním jazyce by měl být považován za autoritativní zdroj. Pro důležité informace se doporučuje profesionální lidský překlad. Neodpovídáme za žádná nedorozumění nebo nesprávné interpretace vyplývající z použití tohoto překladu.

This site is open source. Improve this page.