ai-agents-for-beginners

Postavljanje tečaja

Uvod

Ova lekcija pokriva kako pokrenuti primjere koda iz ovog tečaja.

Pridružite se drugim polaznicima i zatražite pomoć

Prije nego što počnete klonirati svoj repozitorij, pridružite se Discord kanalu AI Agents For Beginners kako biste dobili pomoć oko postavljanja, postavili pitanja o tečaju ili se povezali s drugim polaznicima.

Klonirajte ili forkajte ovaj repozitorij

Za početak, klonirajte ili forkajte GitHub repozitorij. Time ćete dobiti vlastitu verziju materijala tečaja kako biste mogli pokretati, testirati i prilagođavati kod!

To možete učiniti klikom na poveznicu za forkanje repozitorija.

Sada biste trebali imati vlastitu forkanu verziju ovog tečaja na sljedećoj poveznici:

Forkani repozitorij

Pokretanje koda

Ovaj tečaj nudi niz Jupyter Notebooks datoteka koje možete pokrenuti kako biste stekli praktično iskustvo u izradi AI agenata.

Primjeri koda koriste:

Zahtijeva GitHub račun - Besplatno:

1) Semantic Kernel Agent Framework + GitHub Models Marketplace. Označeno kao (semantic-kernel.ipynb) 2) AutoGen Framework + GitHub Models Marketplace. Označeno kao (autogen.ipynb)

Zahtijeva Azure pretplatu: 3) Azure AI Foundry + Azure AI Agent Service. Označeno kao (azureaiagent.ipynb)

Preporučujemo da isprobate sve tri vrste primjera kako biste vidjeli koji vam najbolje odgovara.

Ovisno o opciji koju odaberete, slijedite odgovarajuće korake za postavljanje u nastavku:

Zahtjevi

U korijenu ovog repozitorija uključili smo datoteku requirements.txt koja sadrži sve potrebne Python pakete za pokretanje primjera koda.

Možete ih instalirati pokretanjem sljedeće naredbe u terminalu u korijenu repozitorija:

pip install -r requirements.txt

Preporučujemo kreiranje Python virtualnog okruženja kako biste izbjegli konflikte i probleme.

Postavljanje VSCode-a

Provjerite koristite li ispravnu verziju Pythona u VSCode-u.

image

Postavljanje za primjere koji koriste GitHub modele

Korak 1: Dohvatite svoj GitHub Personal Access Token (PAT)

Ovaj tečaj koristi GitHub Models Marketplace, koji pruža besplatan pristup velikim jezičnim modelima (LLM-ovima) koje ćete koristiti za izradu AI agenata.

Za korištenje GitHub modela, trebate kreirati GitHub Personal Access Token.

To možete učiniti odlaskom na postavke za Personal Access Token u svom GitHub računu.

Molimo slijedite Princip najmanjih privilegija prilikom kreiranja tokena. To znači da tokenu trebate dodijeliti samo one dozvole koje su potrebne za pokretanje primjera koda u ovom tečaju.

  1. Odaberite opciju Fine-grained tokens na lijevoj strani ekrana tako da odete na Developer settings.

    Zatim odaberite Generate new token.

    Generiraj token

  2. Unesite opisni naziv za svoj token koji odražava njegovu svrhu, kako biste ga kasnije lako identificirali.

    🔐 Preporuka za trajanje tokena

    Preporučeno trajanje: 30 dana
    Za sigurniji pristup možete odabrati kraći period—na primjer, 7 dana 🛡️
    To je odličan način da postavite osobni cilj i završite tečaj dok je vaš entuzijazam za učenje visok 🚀.

    Naziv i trajanje tokena

  3. Ograničite opseg tokena na svoj fork ovog repozitorija.

    Ograničite opseg na fork repozitorij

  4. Ograničite dozvole tokena: Pod Permissions, kliknite na karticu Account i pritisnite gumb “+ Add permissions”. Pojavit će se padajući izbornik. Potražite Models i označite okvir za njega. Dodajte dozvolu za modele

  5. Provjerite potrebne dozvole prije generiranja tokena. Provjerite dozvole

  6. Prije generiranja tokena, osigurajte da ste spremni pohraniti token na sigurno mjesto, poput trezora za lozinke, jer se neće ponovno prikazati nakon što ga kreirate. Sigurno pohranite token

Kopirajte svoj novi token koji ste upravo kreirali. Sada ćete ga dodati u svoju .env datoteku uključenu u ovaj tečaj.

Korak 2: Kreirajte svoju .env datoteku

Za kreiranje .env datoteke pokrenite sljedeću naredbu u terminalu.

cp .env.example .env

Ovo će kopirati primjer datoteke i kreirati .env u vašem direktoriju, gdje ćete popuniti vrijednosti za varijable okruženja.

S kopiranim tokenom, otvorite .env datoteku u svom omiljenom uređivaču teksta i zalijepite svoj token u polje GITHUB_TOKEN. Polje za GitHub token

Sada biste trebali moći pokrenuti primjere koda iz ovog tečaja.

Postavljanje za primjere koji koriste Azure AI Foundry i Azure AI Agent Service

Korak 1: Dohvatite svoj Azure projektni endpoint

Slijedite korake za kreiranje huba i projekta u Azure AI Foundryju ovdje: Pregled resursa huba

Nakon što ste kreirali svoj projekt, trebate dohvatiti vezni niz za svoj projekt.

To možete učiniti odlaskom na stranicu Overview svog projekta u Azure AI Foundry portalu.

Vezni niz projekta

Korak 2: Kreirajte svoju .env datoteku

Za kreiranje .env datoteke pokrenite sljedeću naredbu u terminalu.

cp .env.example .env

Ovo će kopirati primjer datoteke i kreirati .env u vašem direktoriju, gdje ćete popuniti vrijednosti za varijable okruženja.

S kopiranim tokenom, otvorite .env datoteku u svom omiljenom uređivaču teksta i zalijepite svoj token u polje PROJECT_ENDPOINT.

Korak 3: Prijavite se na Azure

Kao sigurnosnu najbolju praksu, koristit ćemo autentifikaciju bez ključa za autentifikaciju na Azure OpenAI s Microsoft Entra ID-om.

Zatim otvorite terminal i pokrenite az login --use-device-code kako biste se prijavili na svoj Azure račun.

Nakon što se prijavite, odaberite svoju pretplatu u terminalu.

Dodatne varijable okruženja - Azure Search i Azure OpenAI

Za lekciju Agentic RAG - Lekcija 5 - postoje primjeri koji koriste Azure Search i Azure OpenAI.

Ako želite pokrenuti ove primjere, trebate dodati sljedeće varijable okruženja u svoju .env datoteku:

Stranica Pregled (Projekt)

Centar za upravljanje

Stranica Modeli + Endpointi

Azure portal

Vanjska web stranica

Postavljanje autentifikacije bez ključa

Umjesto da hardkodiramo vaše vjerodajnice, koristit ćemo vezu bez ključa s Azure OpenAI. Za to ćemo uvesti DefaultAzureCredential i kasnije pozvati funkciju DefaultAzureCredential za dobivanje vjerodajnice.

from azure.identity import DefaultAzureCredential, InteractiveBrowserCredential

Imate li problema?

Ako imate bilo kakvih problema s ovim postavljanjem, pridružite se našem Discordu Azure AI zajednice ili kreirajte problem.

Sljedeća lekcija

Sada ste spremni pokrenuti kod za ovaj tečaj. Sretno u učenju o svijetu AI agenata!

Uvod u AI agente i primjene agenata


Odricanje od odgovornosti:
Ovaj dokument je preveden pomoću AI usluge za prevođenje Co-op Translator. Iako nastojimo osigurati točnost, imajte na umu da automatski prijevodi mogu sadržavati pogreške ili netočnosti. Izvorni dokument na izvornom jeziku treba smatrati autoritativnim izvorom. Za ključne informacije preporučuje se profesionalni prijevod od strane čovjeka. Ne preuzimamo odgovornost za nesporazume ili pogrešna tumačenja koja mogu proizaći iz korištenja ovog prijevoda.