ai-agents-for-beginners

Kursuse seadistamine

Sissejuhatus

Selles õppetükis käsitletakse, kuidas käivitada selle kursuse koodinäiteid.

Liitu teiste õppijatega ja saa abi

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.

Klooni või hargi see repositoorium

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:

Hargitud repositoorium

Madal kloonimine (soovitatav töötubade / Codespaces jaoks)

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.

Kiire madal kloonimine — minimaalne ajalugu, kõik 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

Osaline (hõre) kloonimine — minimaalsed failid + ainult valitud kaustad

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

GitHub Codespaces’i kasutamine (soovitatav kohalike suurte allalaadimiste vältimiseks)

Näpunäited

Koodi käivitamine

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:

Nõuded

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.

VSCode seadistamine

Veendu, et kasutad VSCode’is õiget Python’i versiooni.

pilt

Seadistamine GitHub Models näidete jaoks

Samm 1: Hangi oma GitHubi isiklik juurdepääsuluba (PAT)

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.

  1. Vali ekraani vasakult küljelt Arendaja seaded alt Peenhäälestatud load valik.

    Seejärel vali Loo uus luba.

    Loo luba

  2. 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 🚀.

    Loa nimi ja aegumiskuupäev

  3. Piira loa ulatust oma hargitud repositooriumiga.

    Piira ulatust hargitud repositooriumiga

  4. Piira loa õigusi: Õiguste all klõpsa Konto vahekaardil ja vajuta “+ Lisa õigused” nuppu. Ilmub rippmenüü. Palun otsi Mudelid ja märgi selle kastike. Lisa mudelite õigused

  5. Kontrolli vajalikke õigusi enne loa loomist. Kontrolli õigusi

  6. Enne loa loomist veendu, et oled valmis salvestama loa turvalisse kohta, näiteks paroolihalduri seifi, kuna seda ei kuvata uuesti pärast selle loomist. Salvesta luba turvaliselt

Kopeeri oma äsja loodud luba. Nüüd lisa see oma .env faili, mis on kursusega kaasas.

Samm 2: Loo oma .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. GitHubi loa väli

Nüüd peaksid saama käivitada selle kursuse koodinäiteid.

Seadistamine Azure AI Foundry ja Azure AI Agent Service näidete jaoks

Samm 1: Hangi oma Azure’i projekti lõpp-punkt

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.

Projekti ühenduse string

Samm 2: Loo oma .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.

Samm 3: Logi sisse Azure’i

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.

Täiendavad keskkonnamuutujad - Azure Search ja Azure OpenAI

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:

Ülevaate leht (Projekt)

Halduse keskus

Mudelid + Lõpp-punktid leht

Azure’i portaal

Välisveebileht

Võtmeta autentimise seadistamine

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

Jäid kuskile toppama?

Kui sul tekib probleeme selle seadistuse käivitamisel, liitu meiega Azure AI kogukonna Discordis või loo probleem.

Järgmine õppetund

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.