ai-agents-for-beginners

Configurarea Cursului

Introducere

Această lecție va acoperi modul de rulare a exemplelor de cod din acest curs.

Alătură-te altor cursanți și obține ajutor

Înainte de a începe clonarea depozitului, alătură-te canalului AI Agents For Beginners Discord pentru a primi ajutor cu configurarea, pentru orice întrebări legate de curs sau pentru a te conecta cu alți cursanți.

Clonează sau Fork-uiește acest depozit

Pentru a începe, te rugăm să clonezi sau să fork-uiești depozitul GitHub. Acest lucru va crea propria ta versiune a materialului cursului, astfel încât să poți rula, testa și ajusta codul!

Acest lucru poate fi realizat făcând clic pe linkul pentru a fork-ui depozitul

Ar trebui să ai acum propria ta versiune fork-uită a acestui curs la următorul link:

Forked Repo

Clonare superficială (recomandată pentru workshop-uri / Codespaces)

Depozitul complet poate fi mare (~3 GB) atunci când descarci istoricul complet și toate fișierele. Dacă participi doar la workshop sau ai nevoie doar de câteva foldere de lecții, o clonare superficială (sau o clonare parțială) evită cea mai mare parte a descărcării prin trunchierea istoricului și/sau sărirea fișierelor.

Clonare superficială rapidă — istoric minim, toate fișierele

Înlocuiește <your-username> în comenzile de mai jos cu URL-ul fork-ului tău (sau URL-ul original dacă preferi).

Pentru a clona doar istoricul ultimului commit (descărcare mică):

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

Pentru a clona o ramură specifică:

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

Clonare parțială (sparse) — fișiere minime + doar folderele selectate

Aceasta folosește clonarea parțială și sparse-checkout (necesită Git 2.25+ și este recomandată o versiune modernă de Git cu suport pentru clonare parțială):

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

Accesează folderul depozitului:

Pentru bash:

cd ai-agents-for-beginners

Pentru Powershell:

Set-Location ai-agents-for-beginners

Apoi specifică ce foldere dorești (exemplul de mai jos arată două foldere):

git sparse-checkout set 00-course-setup 01-intro-to-ai-agents

După ce ai clonat și verificat fișierele, dacă ai nevoie doar de fișiere și vrei să eliberezi spațiu (fără istoric git), te rugăm să ștergi metadatele depozitului (💀ireversibil — vei pierde toate funcționalitățile Git: fără commit-uri, pull-uri, push-uri sau acces la istoric).

Pentru Linux/macOS:

rm -rf .git

Pentru Windows:

Remove-Item -Recurse -Force .git

Utilizarea GitHub Codespaces (recomandat pentru a evita descărcările mari locale)

Sfaturi

Rularea codului

Acest curs oferă o serie de Jupyter Notebooks pe care le poți rula pentru a obține experiență practică în construirea agenților AI.

Exemplele de cod folosesc fie:

Necesită cont GitHub - Gratuit:

1) Semantic Kernel Agent Framework + GitHub Models Marketplace. Etichetat ca (semantic-kernel.ipynb) 2) AutoGen Framework + GitHub Models Marketplace. Etichetat ca (autogen.ipynb)

Necesită abonament Azure: 3) Azure AI Foundry + Azure AI Agent Service. Etichetat ca (azureaiagent.ipynb)

Te încurajăm să încerci toate cele trei tipuri de exemple pentru a vedea care funcționează cel mai bine pentru tine.

Oricare opțiune alegi, aceasta va determina ce pași de configurare trebuie să urmezi mai jos:

Cerințe

Am inclus un fișier requirements.txt în rădăcina acestui depozit care conține toate pachetele Python necesare pentru a rula exemplele de cod.

Le poți instala rulând următoarea comandă în terminalul tău, la rădăcina depozitului:

pip install -r requirements.txt

Recomandăm crearea unui mediu virtual Python pentru a evita conflictele și problemele.

Configurarea VSCode

Asigură-te că folosești versiunea corectă de Python în VSCode.

image

Configurarea pentru exemplele care folosesc modelele GitHub

Pasul 1: Obține token-ul personal de acces GitHub (PAT)

Acest curs utilizează GitHub Models Marketplace, oferind acces gratuit la modele de limbaj extins (LLMs) pe care le vei folosi pentru a construi agenți AI.

Pentru a utiliza modelele GitHub, va trebui să creezi un token personal de acces GitHub.

Acest lucru poate fi realizat accesând setările pentru token-uri personale de acces din contul tău GitHub.

Te rugăm să urmezi Principiul Privilegiului Minim atunci când creezi token-ul. Acest lucru înseamnă că ar trebui să oferi token-ului doar permisiunile necesare pentru a rula exemplele de cod din acest curs.

  1. Selectează opțiunea Fine-grained tokens din partea stângă a ecranului, accesând Developer settings.

    Apoi selectează Generate new token.

    Generate Token

  2. Introdu un nume descriptiv pentru token-ul tău care să reflecte scopul acestuia, astfel încât să fie ușor de identificat mai târziu.

    🔐 Recomandare pentru durata token-ului

    Durata recomandată: 30 de zile Pentru o securitate mai mare, poți opta pentru o perioadă mai scurtă—cum ar fi 7 zile 🛡️ Este o modalitate excelentă de a-ți seta un obiectiv personal și de a finaliza cursul în timp ce ai un ritm bun de învățare 🚀.

    Token Name and Expiration

  3. Limitează domeniul de aplicare al token-ului la fork-ul acestui depozit.

    Limit scope to fork repository

  4. Restricționează permisiunile token-ului: Sub Permissions, fă clic pe fila Account și apasă butonul “+ Add permissions”. Va apărea un meniu derulant. Te rugăm să cauți Models și să bifezi caseta pentru aceasta. Add Models Permission

  5. Verifică permisiunile necesare înainte de a genera token-ul. Verify Permissions

  6. Înainte de a genera token-ul, asigură-te că ești pregătit să stochezi token-ul într-un loc sigur, cum ar fi un seif de parole, deoarece nu va fi afișat din nou după ce îl creezi. Store Token Securely

Copiază noul token pe care tocmai l-ai creat. Acum îl vei adăuga în fișierul .env inclus în acest curs.

Pasul 2: Creează fișierul .env

Pentru a crea fișierul .env, rulează următoarea comandă în terminalul tău.

cp .env.example .env

Aceasta va copia fișierul exemplu și va crea un .env în directorul tău, unde vei completa valorile pentru variabilele de mediu.

Cu token-ul copiat, deschide fișierul .env în editorul tău preferat de text și lipește token-ul în câmpul GITHUB_TOKEN. GitHub Token Field

Ar trebui să poți rula acum exemplele de cod din acest curs.

Configurarea pentru exemplele care folosesc Azure AI Foundry și Azure AI Agent Service

Pasul 1: Obține punctul de acces al proiectului Azure

Urmează pașii pentru crearea unui hub și a unui proiect în Azure AI Foundry, găsiți aici: Prezentare generală a resurselor hub

După ce ai creat proiectul, va trebui să obții șirul de conexiune pentru proiectul tău.

Acest lucru poate fi realizat accesând pagina Overview a proiectului tău în portalul Azure AI Foundry.

Project Connection String

Pasul 2: Creează fișierul .env

Pentru a crea fișierul .env, rulează următoarea comandă în terminalul tău.

cp .env.example .env

Aceasta va copia fișierul exemplu și va crea un .env în directorul tău, unde vei completa valorile pentru variabilele de mediu.

Cu token-ul copiat, deschide fișierul .env în editorul tău preferat de text și lipește token-ul în câmpul PROJECT_ENDPOINT.

Pasul 3: Autentificare în Azure

Ca o bună practică de securitate, vom folosi autentificarea fără cheie pentru a ne autentifica în Azure OpenAI cu Microsoft Entra ID.

Apoi, deschide un terminal și rulează az login --use-device-code pentru a te autentifica în contul tău Azure.

După ce te-ai autentificat, selectează abonamentul tău în terminal.

Variabile suplimentare de mediu - Azure Search și Azure OpenAI

Pentru lecția Agentic RAG - Lecția 5 - există exemple care folosesc Azure Search și Azure OpenAI.

Dacă dorești să rulezi aceste exemple, va trebui să adaugi următoarele variabile de mediu în fișierul .env:

Pagina de prezentare generală (Proiect)

Centrul de management

Pagina de modele + puncte de acces

Portalul Azure

Pagină externă

Configurarea autentificării fără cheie

În loc să codificăm datele de autentificare, vom folosi o conexiune fără cheie cu Azure OpenAI. Pentru a face acest lucru, vom importa DefaultAzureCredential și ulterior vom apela funcția DefaultAzureCredential pentru a obține acreditarea.

from azure.identity import DefaultAzureCredential, InteractiveBrowserCredential

Te-ai blocat undeva?

Dacă întâmpinați probleme în utilizarea acestei configurații, intrați pe Discord-ul Comunității Azure AI sau creați o problemă.

Lecția următoare

Acum sunteți pregătit să rulați codul pentru acest curs. Învățare plăcută despre lumea agenților AI!

Introducere în Agenții AI și Cazuri de Utilizare ale Agenților


Declinare de responsabilitate:
Acest document a fost tradus folosind serviciul de traducere AI Co-op Translator. Deși ne străduim să asigurăm acuratețea, vă rugăm să fiți conștienți că traducerile automate pot conține erori sau inexactități. Documentul original în limba sa natală ar trebui considerat sursa autoritară. Pentru informații critice, se recomandă traducerea profesională realizată de oameni. Nu ne asumăm responsabilitatea pentru neînțelegerile sau interpretările greșite care pot apărea din utilizarea acestei traduceri.