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 seadistamisel, 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, väldib madal kloonimine (või osaline kloonimine) suurema osa sellest 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 ajalugu (väike allalaadimine):

git clone --depth 1 https://github.com/<your-username>/ai-agents-for-beginners.git

Kloonimiseks konkreetne haru:

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 väljaregistreerimist (vajab Git 2.25+ ja soovitatavalt kaasaegset Git’i osalise kloonimise toetusega):

git clone --depth 1 --filter=blob:none --sparse https://github.com/<your-username>/ai-agents-for-beginners.git

Liigu repositooriumi kausta:

cd ai-agents-for-beginners

Seejärel määra, milliseid kaustu soovid (näide allpool näitab kahte 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 commit’e, tõmbeid, push’e ega ajaloo juurdepääsu).

# zsh/bash
rm -rf .git

# PowerShell
Remove-Item -Recurse -Force .git

GitHub Codespaces’i kasutamine (soovitatav vältimaks suuri kohalikke allalaadimisi)

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:

Vajab GitHubi kontot - 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)

Vajab Azure’i tellimust: 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 kindlaks, 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’i seadistamine

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

image

Seadistamine GitHub Models näidiste jaoks

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

See kursus kasutab GitHub Models Marketplace’i, mis pakub tasuta juurdepääsu suurtele keelemudelitele (LLM), mida kasutad AI agentide loomiseks.

GitHub Models’i kasutamiseks pead looma GitHubi isikliku juurdepääsutokeni.

Seda saab teha, minnes oma isikliku juurdepääsutokeni seadistuste lehele oma GitHubi kontol.

Palun järgi väikseima privileegi põhimõtet tokeni loomisel. See tähendab, et peaksid andma tokenile ainult need õigused, mis on vajalikud selle kursuse koodinäidete käitamiseks.

  1. Vali ekraani vasakult küljelt Peenhäälestatud tokenid valik, liikudes Arendaja seadistuste juurde.

    Arendaja seadistused

    Seejärel vali Loo uus token.

    Loo token

  2. Sisesta tokenile kirjeldav nimi, mis peegeldab selle eesmärki, muutes selle hiljem lihtsasti tuvastatavaks.

    🔐 Tokeni 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 õppimise hoogu üleval 🚀.

    Tokeni nimi ja aegumiskuupäev

  3. Piira tokeni ulatust oma repositooriumi hargile.

    Piira ulatus hargitud repositooriumile

  4. Piira tokeni õ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 enne tokeni loomist vajalikke õigusi. Kontrolli õigusi

  6. Enne tokeni loomist veendu, et oled valmis tokeni turvaliselt salvestama, näiteks paroolihalduri seifi, kuna seda ei kuvata uuesti pärast loomist. Salvesta token turvaliselt

Kopeeri oma äsja loodud token. Nüüd lisa see oma .env faili, mis on selle kursuse osaks.

Samm 2: Loo oma .env fail

.env faili loomiseks käivita järgmine käsk oma terminalis.

# zsh/bash
cp .env.example .env

# PowerShell
Copy-Item .env.example .env

See kopeerib näidisfaili ja loob .env faili sinu kataloogi, kuhu täidad keskkonnamuutujate väärtused.

Kopeeritud tokeniga ava .env fail oma lemmiktekstitöötlusprogrammis ja kleebi token GITHUB_TOKEN väljale.

GitHub Token väli

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

Seadistamine Azure AI Foundry ja Azure AI Agent Service näidiste 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 ühendusstringi.

Seda saab teha, minnes Ülevaate lehele oma projektis Azure AI Foundry portaalis.

Projekti ühendusstring

Samm 2: Loo oma .env fail

.env faili loomiseks käivita järgmine käsk oma terminalis.

# zsh/bash
cp .env.example .env

# PowerShell
Copy-Item .env.example .env

See kopeerib näidisfaili ja loob .env faili sinu kataloogi, kuhu täidad keskkonnamuutujate väärtused.

Kopeeritud tokeniga ava .env fail oma lemmiktekstitöötlusprogrammis ja kleebi token 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

Järgmine õppetund

Sa oled nüüd valmis käivitama selle kursuse koodi. Rõõmsat õppimist AI agentide maailma kohta!

Sissejuhatus AI agentidesse 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 selle tõlke kasutamisest tulenevate arusaamatuste või valesti tõlgenduste eest.

This site is open source. Improve this page.