Selles õppetükis käsitletakse, kuidas käivitada selle kursuse koodinäiteid.
Enne kui hakkad oma repositooriumi kloonima, liitu AI Agents For Beginners Discord kanaliga, et saada abi seadistamisega, esitada küsimusi kursuse kohta või luua ühendust teiste õppijatega.
Alustamiseks klooni või hargi GitHubi repositoorium. See loob sinu enda versiooni kursuse materjalidest, et saaksid koodi käivitada, testida ja kohandada!
Seda saab teha, klõpsates lingil hargi repositoorium.
Nüüd peaks sul olema selle kursuse enda hargitud versioon järgmisel lingil:
Täielik repositoorium võib olla suur (~3 GB), kui alla laadida kogu ajalugu ja kõik failid. Kui osaled ainult töötoas või vajad ainult mõnda õppetüki kausta, siis madal kloonimine (või osaline kloonimine) väldib suurema osa allalaadimisest, kärpides ajalugu ja/või vahele jättes failid.
Asenda <your-username>
allolevates käskudes oma hargi URL-iga (või algse URL-iga, kui eelistad).
Kloonimiseks ainult viimase commit’i ajalooga (väike allalaadimine):
git clone --depth 1 https://github.com/<your-username>/ai-agents-for-beginners.git
Kloonimiseks kindla haruga:
git clone --depth 1 --branch <branch-name> https://github.com/<your-username>/ai-agents-for-beginners.git
See kasutab osalist kloonimist ja hõredat kontrolli (vajab Git 2.25+ ja soovitatavalt kaasaegset Giti osalise kloonimise toetusega):
git clone --depth 1 --filter=blob:none --sparse https://github.com/<your-username>/ai-agents-for-beginners.git
Liigu repositooriumi kausta:
Bash’i jaoks:
cd ai-agents-for-beginners
Powershell’i jaoks:
Set-Location ai-agents-for-beginners
Seejärel määra, milliseid kaustu soovid (näiteks allpool on näidatud kaks kausta):
git sparse-checkout set 00-course-setup 01-intro-to-ai-agents
Pärast kloonimist ja failide kontrollimist, kui vajad ainult faile ja soovid ruumi vabastada (ilma git’i ajaloota), kustuta repositooriumi metaandmed (💀 pöördumatu — kaotad kogu Git’i funktsionaalsuse: ei saa teha commit’e, tõmmata, lükata ega ajalugu vaadata).
Linux/macOS jaoks:
rm -rf .git
Windowsi jaoks:
Remove-Item -Recurse -Force .git
Loo uus Codespace selle repositooriumi jaoks GitHubi kasutajaliidese kaudu.
See kursus pakub Jupyter Notebook’e, mida saad käivitada, et saada praktilisi kogemusi AI agentide loomisel.
Koodinäited kasutavad kas:
Vajalik GitHubi konto - Tasuta:
1) Semantic Kernel Agent Framework + GitHub Models Marketplace. Märgistatud kui (semantic-kernel.ipynb) 2) AutoGen Framework + GitHub Models Marketplace. Märgistatud kui (autogen.ipynb)
Vajalik Azure’i tellimus: 3) Azure AI Foundry + Azure AI Agent Service. Märgistatud kui (azureaiagent.ipynb)
Soovitame proovida kõiki kolme tüüpi näiteid, et näha, milline neist sulle kõige paremini sobib.
Sõltuvalt valitud variandist määratakse, milliseid seadistusetappe allpool järgida:
NOTE: Kui sul pole Python 3.12 paigaldatud, veendu, et paigaldad selle. Seejärel loo oma venv, kasutades python3.12, et tagada õige versioonide paigaldamine requirements.txt failist.
Näide
Loo Python venv kataloog:
python3 -m venv venv
Seejärel aktiveeri venv keskkond:
macOS ja Linux
source venv/bin/activate
Windows
venv\Scripts\activate
Me oleme lisanud requirements.txt
faili selle repositooriumi juurkausta, mis sisaldab kõiki vajalikke Python’i pakette koodinäidete käivitamiseks.
Sa saad need paigaldada, käivitades järgmise käsu oma terminalis repositooriumi juurkaustas:
pip install -r requirements.txt
Soovitame luua Python’i virtuaalse keskkonna, et vältida konflikte ja probleeme.
Veendu, et kasutad VSCode’is õiget Python’i versiooni.
See kursus kasutab GitHub Models Marketplace’i, mis pakub tasuta juurdepääsu suurtele keelemudelitele (LLM), mida saad kasutada AI agentide loomiseks.
GitHub Models’i kasutamiseks pead looma GitHubi isikliku juurdepääsuloa.
Seda saab teha, minnes oma isikliku juurdepääsuloa seadete lehele oma GitHubi kontol.
Palun järgi väikseima privileegi põhimõtet oma loa loomisel. See tähendab, et peaksid andma loale ainult need õigused, mis on vajalikud selle kursuse koodinäidete käivitamiseks.
Vali ekraani vasakult küljelt Arendaja seaded alt Peenhäälestatud load
valik.
Seejärel vali Loo uus luba
.
Sisesta oma loale kirjeldav nimi, mis peegeldab selle eesmärki, et seda hiljem oleks lihtne tuvastada.
🔐 Loa kestuse soovitus
Soovitatav kestus: 30 päeva Turvalisuse suurendamiseks võid valida lühema perioodi—näiteks 7 päeva 🛡️ See on suurepärane viis seada isiklik eesmärk ja lõpetada kursus, hoides oma õppimise hoogu 🚀.
Piira loa ulatust oma hargitud repositooriumiga.
Piira loa õigusi: Õiguste all klõpsa Konto vahekaardil ja vajuta “+ Lisa õigused” nuppu. Ilmub rippmenüü. Palun otsi Mudelid ja märgi selle kastike.
Kontrolli vajalikke õigusi enne loa loomist.
Enne loa loomist veendu, et oled valmis salvestama loa turvalisse kohta, näiteks paroolihalduri seifi, kuna seda ei kuvata uuesti pärast selle loomist.
Kopeeri oma äsja loodud luba. Nüüd lisa see oma .env
faili, mis on kursusega kaasas.
.env
fail.env
faili loomiseks käivita järgmine käsk oma terminalis.
cp .env.example .env
See kopeerib näidisfaili ja loob .env
faili sinu kataloogi, kuhu saad täita keskkonnamuutujate väärtused.
Kopeeri oma luba ja ava .env
fail oma lemmikteksti redaktoris ning kleebi oma luba GITHUB_TOKEN
väljale.
Nüüd peaksid saama käivitada selle kursuse koodinäiteid.
Järgi juhiseid Azure AI Foundry keskuse ja projekti loomiseks siin: Keskuse ressursside ülevaade
Kui oled oma projekti loonud, pead hankima oma projekti ühenduse stringi.
Seda saab teha, minnes Ülevaate lehele oma projektis Azure AI Foundry portaalis.
.env
fail.env
faili loomiseks käivita järgmine käsk oma terminalis.
cp .env.example .env
See kopeerib näidisfaili ja loob .env
faili sinu kataloogi, kuhu saad täita keskkonnamuutujate väärtused.
Kopeeri oma luba ja ava .env
fail oma lemmikteksti redaktoris ning kleebi oma luba PROJECT_ENDPOINT
väljale.
Turvalisuse parima tava järgi kasutame võtmeta autentimist, et autentida Azure OpenAI Microsoft Entra ID-ga.
Järgmiseks ava terminal ja käivita az login --use-device-code
, et logida sisse oma Azure’i kontole.
Kui oled sisse loginud, vali oma tellimus terminalis.
Agentic RAG õppetüki - õppetükk 5 - jaoks on näited, mis kasutavad Azure Search’i ja Azure OpenAI-d.
Kui soovid neid näiteid käivitada, pead lisama järgmised keskkonnamuutujad oma .env
faili:
AZURE_SUBSCRIPTION_ID
- Kontrolli Projekti üksikasju oma projekti Ülevaate lehel.
AZURE_AI_PROJECT_NAME
- Vaata oma projekti Ülevaate lehe ülaosas.
AZURE_OPENAI_SERVICE
- Leia see Kaasa arvatud võimaluste vahekaardilt Azure OpenAI Service jaoks Ülevaate lehel.
AZURE_OPENAI_RESOURCE_GROUP
- Mine Projekti omadused Ülevaate lehel Halduse keskuses.
GLOBAL_LLM_SERVICE
- Ühendatud ressursid all leia Azure AI Services ühenduse nimi. Kui pole loetletud, kontrolli Azure’i portaali oma ressursigrupis AI Services ressursi nime.
AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME
- Vali oma sisseehitatud mudel (nt text-embedding-ada-002
) ja märgi Paigutuse nimi mudeli üksikasjadest.
AZURE_OPENAI_CHAT_DEPLOYMENT_NAME
- Vali oma vestlusmudel (nt gpt-4o-mini
) ja märgi Paigutuse nimi mudeli üksikasjadest.
AZURE_OPENAI_ENDPOINT
- Otsi Azure AI teenuseid, klõpsa sellel, mine Ressursside haldus, Võtmed ja lõpp-punkt, kerige alla “Azure OpenAI lõpp-punktid” ja kopeerige see, mis ütleb “Keelte API-d”.
AZURE_OPENAI_API_KEY
- Samalt ekraanilt kopeerige VÕTI 1 või VÕTI 2.
AZURE_SEARCH_SERVICE_ENDPOINT
- Leidke oma Azure AI Search ressurss, klõpsake sellel ja vaadake Ülevaade.
AZURE_SEARCH_API_KEY
- Seejärel minge Seaded ja seejärel Võtmed, et kopeerida esmane või sekundaarne administraatori võti.
AZURE_OPENAI_API_VERSION
- Külastage API versiooni elutsükli lehte Viimane GA API väljalase all.Selle asemel, et oma mandaate kõvakodeerida, kasutame võtmeta ühendust Azure OpenAI-ga. Selleks impordime DefaultAzureCredential
ja hiljem kutsume DefaultAzureCredential
funktsiooni, et saada mandaati.
from azure.identity import DefaultAzureCredential, InteractiveBrowserCredential
Kui sul tekib probleeme selle seadistuse käivitamisel, liitu meiega Azure AI kogukonna Discordis või loo probleem.
Nüüd oled valmis selle kursuse koodi käivitama. Rõõmsat õppimist AI agentide maailma kohta!
AI agentide tutvustus ja agentide kasutusjuhtumid
Lahtiütlus:
See dokument on tõlgitud AI tõlketeenuse Co-op Translator abil. Kuigi püüame tagada täpsust, palume arvestada, et automaatsed tõlked võivad sisaldada vigu või ebatäpsusi. Algne dokument selle algses keeles tuleks pidada autoriteetseks allikaks. Olulise teabe puhul soovitame kasutada professionaalset inimtõlget. Me ei vastuta arusaamatuste või valesti tõlgenduste eest, mis võivad tekkida selle tõlke kasutamise tõttu.