ai-agents-for-beginners
Kurzus Beállítása
Bevezetés
Ebben a leckében megtanulhatod, hogyan futtathatod a kurzus kódmintáit.
Csatlakozz más tanulókhoz és kérj segítséget
Mielőtt elkezdenéd klónozni a repót, csatlakozz az AI Agents For Beginners Discord csatornához, hogy segítséget kapj a beállításhoz, kérdéseket tegyél fel a kurzussal kapcsolatban, vagy kapcsolatba lépj más tanulókkal.
Klónozd vagy forkolj egy repót
Először klónozd vagy forkolj egy GitHub repót. Ezáltal létrehozod a kurzus anyagainak saját verzióját, amelyet futtathatsz, tesztelhetsz és módosíthatsz!
Ezt úgy teheted meg, hogy rákattintasz a linkre:
A kód futtatása
Ez a kurzus Jupyter Notebookokat kínál, amelyeket futtathatsz, hogy gyakorlati tapasztalatot szerezz az AI Agentek építésében.
A kódminták az alábbiakat használják:
GitHub fiók szükséges - Ingyenes:
1) Semantic Kernel Agent Framework + GitHub Models Marketplace. Jelölve: (semantic-kernel.ipynb) 2) AutoGen Framework + GitHub Models Marketplace. Jelölve: (autogen.ipynb)
Azure előfizetés szükséges: 3) Azure AI Foundry + Azure AI Agent Service. Jelölve: (azureaiagent.ipynb)
Javasoljuk, hogy próbáld ki mindhárom példát, hogy megtudd, melyik működik a legjobban számodra.
Az általad választott opció határozza meg, hogy melyik beállítási lépéseket kell követned az alábbiakban:
Követelmények
- Python 3.12+
- MEGJEGYZÉS: Ha nincs telepítve a Python 3.12, győződj meg róla, hogy telepíted. Ezután hozz létre egy virtuális környezetet (venv) a Python 3.12 használatával, hogy biztosítsd a requirements.txt fájlban szereplő megfelelő verziók telepítését.
- GitHub fiók - A GitHub Models Marketplace eléréséhez
- Azure előfizetés - Az Azure AI Foundry eléréséhez
- Azure AI Foundry fiók - Az Azure AI Agent Service eléréséhez
A repó gyökérkönyvtárában található egy requirements.txt fájl, amely tartalmazza az összes szükséges Python csomagot a kódminták futtatásához.
Ezeket az alábbi parancs futtatásával telepítheted a terminálban, a repó gyökérkönyvtárában:
pip install -r requirements.txt
Javasoljuk, hogy hozz létre egy Python virtuális környezetet, hogy elkerüld az esetleges konfliktusokat és problémákat.
VSCode Beállítása
Győződj meg róla, hogy a megfelelő Python verziót használod a VSCode-ban.
Beállítás GitHub Modellek használatához
1. lépés: GitHub személyes hozzáférési token (PAT) beszerzése
Ez a kurzus a GitHub Models Marketplace-t használja, amely ingyenes hozzáférést biztosít a Nagy Nyelvi Modellekhez (LLM-ek), amelyeket az AI Agentek építéséhez fogsz használni.
A GitHub modellek használatához létre kell hoznod egy GitHub személyes hozzáférési tokent.
Ezt a GitHub fiókodban teheted meg.
Kérjük, kövesd a Legkisebb jogosultság elve irányelvet a token létrehozásakor. Ez azt jelenti, hogy csak azokat a jogosultságokat add meg a tokennek, amelyek szükségesek a kurzus kódmintáinak futtatásához.
-
Válaszd ki a
Fine-grained tokensopciót a képernyő bal oldalán, a Fejlesztői beállítások menüpontban.
Ezután válaszd a
Generate new tokenopciót.
-
Adj meg egy leíró nevet a tokennek, amely tükrözi annak célját, hogy később könnyen azonosítható legyen.
🔐 Token időtartam ajánlás
Ajánlott időtartam: 30 nap A biztonságosabb megközelítés érdekében választhatsz rövidebb időtartamot, például 7 napot 🛡️ Ez egy remek módja annak, hogy személyes célt állíts be, és befejezd a kurzust, miközben a tanulási lendületed magas 🚀.
-
Korlátozd a token hatókörét a repód forkjára.
-
Korlátozd a token jogosultságait: A Jogosultságok alatt kattints az Account fülre, majd az “+ Add permissions” gombra. Egy legördülő menü jelenik meg. Keresd meg a Models opciót, és jelöld be a négyzetet.
-
Ellenőrizd a szükséges jogosultságokat a token létrehozása előtt.
-
A token létrehozása előtt győződj meg róla, hogy készen állsz a token biztonságos tárolására, például egy jelszókezelőben, mivel a token nem lesz újra látható a létrehozás után.
Másold ki az újonnan létrehozott tokent. Most hozzáadod ezt a .env fájlhoz, amelyet a kurzus tartalmaz.
2. lépés: .env fájl létrehozása
A .env fájl létrehozásához futtasd az alábbi parancsot a terminálban.
cp .env.example .env
Ez lemásolja a példa fájlt, és létrehoz egy .env fájlt a könyvtáradban, ahol kitöltheted a környezeti változók értékeit.
A tokened bemásolásával nyisd meg a .env fájlt a kedvenc szövegszerkesztődben, és illeszd be a tokent a GITHUB_TOKEN mezőbe.
Most már képesnek kell lenned futtatni a kurzus kódmintáit.
Beállítás Azure AI Foundry és Azure AI Agent Service használatához
1. lépés: Azure projekt végpontjának beszerzése
Kövesd az Azure AI Foundry hub és projekt létrehozásának lépéseit itt: Hub erőforrások áttekintése
Miután létrehoztad a projektedet, be kell szerezned a projekt kapcsolatának karakterláncát.
Ezt a projekt Áttekintés oldalán teheted meg az Azure AI Foundry portálon.
2. lépés: .env fájl létrehozása
A .env fájl létrehozásához futtasd az alábbi parancsot a terminálban.
cp .env.example .env
Ez lemásolja a példa fájlt, és létrehoz egy .env fájlt a könyvtáradban, ahol kitöltheted a környezeti változók értékeit.
A tokened bemásolásával nyisd meg a .env fájlt a kedvenc szövegszerkesztődben, és illeszd be a tokent a PROJECT_ENDPOINT mezőbe.
3. lépés: Bejelentkezés az Azure-ba
A biztonsági legjobb gyakorlatok érdekében kulcs nélküli hitelesítést fogunk használni az Azure OpenAI-hoz a Microsoft Entra ID-val.
Ezután nyiss meg egy terminált, és futtasd az az login --use-device-code parancsot, hogy bejelentkezz az Azure fiókodba.
Miután bejelentkeztél, válaszd ki az előfizetésedet a terminálban.
További környezeti változók - Azure Search és Azure OpenAI
Az Agentic RAG lecke - 5. lecke - mintái az Azure Search és Azure OpenAI használatát igénylik.
Ha futtatni szeretnéd ezeket a mintákat, hozzá kell adnod az alábbi környezeti változókat a .env fájlhoz:
Áttekintés oldal (Projekt)
-
AZURE_SUBSCRIPTION_ID- Ellenőrizd a Projekt részletek részt a projekt Áttekintés oldalán. -
AZURE_AI_PROJECT_NAME- Nézd meg a projekt Áttekintés oldalának tetejét. -
AZURE_OPENAI_SERVICE- Ezt az Azure OpenAI Service Tartalmazott képességek fülén találod az Áttekintés oldalon.
Menedzsment Központ
-
AZURE_OPENAI_RESOURCE_GROUP- Menj a Projekt tulajdonságok részhez az Áttekintés oldalon a Menedzsment Központban. -
GLOBAL_LLM_SERVICE- Az Kapcsolódó erőforrások alatt keresd meg az Azure AI Services kapcsolat nevét. Ha nem található, ellenőrizd az Azure portálon az erőforráscsoportodban az AI Services erőforrás nevét.
Modellek + Végpontok oldal
-
AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME- Válaszd ki az embedding modelledet (pl.text-embedding-ada-002), és jegyezd fel a Deployment name-et a modell részleteiből. -
AZURE_OPENAI_CHAT_DEPLOYMENT_NAME- Válaszd ki a chat modelledet (pl.gpt-4o-mini), és jegyezd fel a Deployment name-et a modell részleteiből.
Azure Portál
-
AZURE_OPENAI_ENDPOINT- Keresd meg az Azure AI services-t, kattints rá, majd menj a Resource Management, Keys and Endpoint részhez, görgess le az “Azure OpenAI endpoints” részhez, és másold ki azt, amelyik “Language APIs”-t mond. -
AZURE_OPENAI_API_KEY- Ugyanerről a képernyőről másold ki az 1. vagy 2. kulcsot. -
AZURE_SEARCH_SERVICE_ENDPOINT- Keresd meg az Azure AI Search erőforrásodat, kattints rá, és nézd meg az Áttekintés részt. -
AZURE_SEARCH_API_KEY- Ezután menj a Beállítások részhez, majd a Kulcsok részhez, hogy lemásold az elsődleges vagy másodlagos admin kulcsot.
Külső weboldal
AZURE_OPENAI_API_VERSION- Látogasd meg az API verzió életciklus oldalt a Legújabb GA API kiadás alatt.
Kulcs nélküli hitelesítés beállítása
A hitelesítő adatok kódba való beágyazása helyett kulcs nélküli kapcsolatot fogunk használni az Azure OpenAI-val. Ehhez importáljuk a DefaultAzureCredential-t, majd később meghívjuk a DefaultAzureCredential függvényt a hitelesítő adat megszerzéséhez.
from azure.identity import DefaultAzureCredential, InteractiveBrowserCredential
Elakadtál valahol?
Ha bármilyen problémád van a beállítás futtatásával, ugorj be a Discord csatornánkra.
Következő lecke
Most már készen állsz a kurzus kódjának futtatására. Jó tanulást az AI Agentek világáról!
Bevezetés az AI Agentekbe és az Agentek felhasználási esetei
Felelősség kizárása:
Ez a dokumentum az AI fordítási szolgáltatás, a Co-op Translator segítségével lett lefordítva. Bár törekszünk a pontosságra, kérjük, vegye figyelembe, hogy az automatikus fordítások hibákat vagy pontatlanságokat tartalmazhatnak. Az eredeti dokumentum az eredeti nyelvén tekintendő hiteles forrásnak. Kritikus információk esetén javasolt professzionális, emberi fordítást igénybe venni. Nem vállalunk felelősséget semmilyen félreértésért vagy téves értelmezésért, amely a fordítás használatából eredhet.