Ta lekcija bo zajemala, kako zagnati vzorčne kode tega tečaja.
Preden začnete klonirati svoj repozitorij, se pridružite Discord kanalu AI Agents For Beginners, kjer lahko dobite pomoč pri nastavitvi, postavite vprašanja o tečaju ali se povežete z drugimi udeleženci.
Za začetek prosimo, da klonirate ali razvejite GitHub repozitorij. Tako boste ustvarili svojo različico gradiva tečaja, da boste lahko zagnali, testirali in prilagodili kodo!
To lahko storite s klikom na povezavo za razvejitev repozitorija.
Sedaj bi morali imeti svojo razvejano različico tega tečaja na naslednji povezavi:

Celoten repozitorij je lahko velik (~3 GB), če prenesete celotno zgodovino in vse datoteke. Če se udeležujete le delavnice ali potrebujete le nekaj map lekcij, plitvo kloniranje (ali redko kloniranje) prepreči večino prenosa z omejevanjem zgodovine in/ali preskakovanjem datotek.
Zamenjajte <your-username> v spodnjih ukazih z URL-jem vaše razvejane različice (ali z URL-jem izvornega repozitorija, če to raje).
Za kloniranje le najnovejše zgodovine (majhen prenos):
git clone --depth 1 https://github.com/<your-username>/ai-agents-for-beginners.git
Za kloniranje določene veje:
git clone --depth 1 --branch <branch-name> https://github.com/<your-username>/ai-agents-for-beginners.git
To uporablja delno kloniranje in redko preverjanje (zahteva Git 2.25+ in priporočeno sodobno Git različico s podporo za delno kloniranje):
git clone --depth 1 --filter=blob:none --sparse https://github.com/<your-username>/ai-agents-for-beginners.git
Premaknite se v mapo repozitorija:
Za bash:
cd ai-agents-for-beginners
Za Powershell:
Set-Location ai-agents-for-beginners
Nato določite, katere mape želite (primer spodaj prikazuje dve mapi):
git sparse-checkout set 00-course-setup 01-intro-to-ai-agents
Po kloniranju in preverjanju datotek, če potrebujete le datoteke in želite sprostiti prostor (brez zgodovine git), prosimo, da izbrišete metapodatke repozitorija (💀nepovratno — izgubili boste vse funkcionalnosti Git: brez commitov, pullov, pushov ali dostopa do zgodovine).
Za Linux/macOS:
rm -rf .git
Za Windows:
Remove-Item -Recurse -Force .git
Ustvarite nov Codespace za ta repozitorij prek GitHub uporabniškega vmesnika.
Ta tečaj ponuja serijo Jupyter zvezkov, ki jih lahko zaženete za praktično izkušnjo pri gradnji AI agentov.
Vzorčne kode uporabljajo:
Zahteva GitHub račun - Brezplačno:
1) Semantic Kernel Agent Framework + GitHub Models Marketplace. Označeno kot (semantic-kernel.ipynb) 2) AutoGen Framework + GitHub Models Marketplace. Označeno kot (autogen.ipynb)
Zahteva naročnino na Azure: 3) Azure AI Foundry + Azure AI Agent Service. Označeno kot (azureaiagent.ipynb)
Spodbujamo vas, da preizkusite vse tri vrste primerov, da vidite, kateri vam najbolj ustreza.
Katero koli možnost izberete, bo določila, katere korake za nastavitev morate slediti spodaj:
NOTE: Če nimate nameščenega Python3.12, poskrbite, da ga namestite. Nato ustvarite svoj venv z uporabo python3.12, da zagotovite, da so nameščene pravilne različice iz datoteke requirements.txt.
Primer
Ustvarite mapo za Python venv:
python3 -m venv venv
Nato aktivirajte venv okolje za:
macOS in Linux
source venv/bin/activate
Windows
venv\Scripts\activate
V korenskem direktoriju tega repozitorija smo vključili datoteko requirements.txt, ki vsebuje vse potrebne Python pakete za zagon vzorčnih kod.
Namestite jih lahko z naslednjim ukazom v terminalu v korenskem direktoriju repozitorija:
pip install -r requirements.txt
Priporočamo ustvarjanje Python virtualnega okolja, da se izognete konfliktom in težavam.
Poskrbite, da uporabljate pravo različico Pythona v VSCode.
Ta tečaj uporablja GitHub Models Marketplace, ki omogoča brezplačen dostop do velikih jezikovnih modelov (LLMs), ki jih boste uporabili za gradnjo AI agentov.
Za uporabo GitHub modelov boste morali ustvariti GitHub osebni dostopni žeton.
To lahko storite tako, da obiščete nastavitve osebnih dostopnih žetonov v svojem GitHub računu.
Prosimo, da sledite načelu najmanjše privilegiranosti pri ustvarjanju žetona. To pomeni, da žetonu dodelite le dovoljenja, ki jih potrebuje za zagon vzorčnih kod v tem tečaju.
Na levi strani zaslona izberite možnost Fine-grained tokens z navigacijo do Developer settings

Nato izberite Generate new token.

Vnesite opisno ime za svoj žeton, ki odraža njegov namen, da ga boste kasneje lažje prepoznali.
🔐 Priporočilo za trajanje žetona
Priporočeno trajanje: 30 dni Za bolj varno držo se lahko odločite za krajše obdobje—na primer 7 dni 🛡️ To je odličen način, da si postavite osebni cilj in dokončate tečaj, medtem ko je vaš učni zagon visok 🚀.

Omejite obseg žetona na svojo razvejano različico tega repozitorija.

Omejite dovoljenja žetona: Pod Permissions, kliknite zavihek Account in kliknite gumb “+ Add permissions”. Prikaže se spustni meni. Prosimo, poiščite Models in označite polje za to.

Preden ustvarite žeton, preverite zahtevana dovoljenja. 
Preden ustvarite žeton, poskrbite, da ste pripravljeni shraniti žeton na varno mesto, kot je trezor upravitelja gesel, saj ne bo več prikazan po ustvarjanju. 
Kopirajte svoj novi žeton, ki ste ga pravkar ustvarili. Sedaj ga boste dodali v svojo .env datoteko, vključeno v ta tečaj.
.env datotekoZa ustvarjanje .env datoteke zaženite naslednji ukaz v terminalu.
cp .env.example .env
To bo kopiralo primer datoteke in ustvarilo .env v vašem direktoriju, kjer izpolnite vrednosti za okoljske spremenljivke.
S kopiranim žetonom odprite .env datoteko v svojem najljubšem urejevalniku besedila in prilepite žeton v polje GITHUB_TOKEN.

Sedaj bi morali biti sposobni zagnati vzorčne kode tega tečaja.
Sledite korakom za ustvarjanje vozlišča in projekta v Azure AI Foundry, ki jih najdete tukaj: Pregled virov vozlišča
Ko ustvarite svoj projekt, boste morali pridobiti povezovalni niz za svoj projekt.
To lahko storite tako, da obiščete stran Overview svojega projekta v portalu Azure AI Foundry.

.env datotekoZa ustvarjanje .env datoteke zaženite naslednji ukaz v terminalu.
cp .env.example .env
To bo kopiralo primer datoteke in ustvarilo .env v vašem direktoriju, kjer izpolnite vrednosti za okoljske spremenljivke.
S kopiranim žetonom odprite .env datoteko v svojem najljubšem urejevalniku besedila in prilepite žeton v polje PROJECT_ENDPOINT.
Kot varnostno najboljšo prakso bomo uporabili avtentikacijo brez ključev za avtentikacijo v Azure OpenAI z Microsoft Entra ID.
Nato odprite terminal in zaženite az login --use-device-code, da se prijavite v svoj Azure račun.
Ko se prijavite, v terminalu izberite svojo naročnino.
Za lekcijo Agentic RAG - Lekcija 5 - so na voljo vzorci, ki uporabljajo Azure Search in Azure OpenAI.
Če želite zagnati te vzorce, boste morali dodati naslednje okoljske spremenljivke v svojo .env datoteko:
AZURE_SUBSCRIPTION_ID - Preverite Project details na strani Overview svojega projekta.
AZURE_AI_PROJECT_NAME - Poglejte na vrh strani Overview za svoj projekt.
AZURE_OPENAI_SERVICE - Poiščite to na zavihku Included capabilities za Azure OpenAI Service na strani Overview.
AZURE_OPENAI_RESOURCE_GROUP - Pojdite na Project properties na strani Overview v Management Center.
GLOBAL_LLM_SERVICE - Pod Connected resources poiščite ime povezave Azure AI Services. Če ni navedeno, preverite Azure portal pod svojo skupino virov za ime vira AI Services.
AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME - Izberite svoj model vdelave (npr. text-embedding-ada-002) in zabeležite Deployment name iz podrobnosti modela.
AZURE_OPENAI_CHAT_DEPLOYMENT_NAME - Izberite svoj model za klepet (npr. gpt-4o-mini) in zabeležite Deployment name iz podrobnosti modela.
AZURE_OPENAI_ENDPOINT - Poiščite Azure AI services, kliknite nanj, nato pojdite na Resource Management, Keys and Endpoint, se pomaknite navzdol do “Azure OpenAI endpoints” in kopirajte tistega, ki pravi “Language APIs”.
AZURE_OPENAI_API_KEY - Na istem zaslonu kopirajte KLJUČ 1 ali KLJUČ 2.
AZURE_SEARCH_SERVICE_ENDPOINT - Poiščite svoj Azure AI Search vir, kliknite nanj in si oglejte Overview.
AZURE_SEARCH_API_KEY - Nato pojdite na Settings in nato Keys, da kopirate primarni ali sekundarni skrbniški ključ.
AZURE_OPENAI_API_VERSION - Obiščite stran API version lifecycle pod Latest GA API release.Namesto da bi trdo kodirali svoje poverilnice, bomo uporabili povezavo brez ključev z Azure OpenAI. Za to bomo uvozili DefaultAzureCredential in kasneje poklicali funkcijo DefaultAzureCredential, da pridobimo poverilnico.
from azure.identity import DefaultAzureCredential, InteractiveBrowserCredential
Če imate kakršne koli težave pri zagonu te nastavitve, se pridružite našemu Discord strežniku Azure AI Community ali ustvarite težavo.
Sedaj ste pripravljeni na zagon kode za ta tečaj. Veselo raziskovanje sveta AI agentov!
Uvod v AI agente in primere uporabe agentov
Omejitev odgovornosti:
Ta dokument je bil preveden z uporabo storitve za prevajanje AI Co-op Translator. Čeprav si prizadevamo za natančnost, vas prosimo, da upoštevate, da lahko avtomatizirani prevodi vsebujejo napake ali netočnosti. Izvirni dokument v njegovem maternem jeziku naj se šteje za avtoritativni vir. Za ključne informacije priporočamo profesionalni človeški prevod. Ne odgovarjamo za morebitna nesporazumevanja ali napačne razlage, ki izhajajo iz uporabe tega prevoda.