ai-agents-for-beginners

Kurssin asennus

Johdanto

Tässä osiossa käsitellään, kuinka kurssin koodiesimerkit suoritetaan.

Liity muiden oppijoiden joukkoon ja pyydä apua

Ennen kuin alat kloonata omaa reposi, liity AI Agents For Beginners Discord-kanavalle saadaksesi apua asennukseen, kysymyksiin kurssista tai yhteyden muihin oppijoihin.

Kloonaa tai haarauta tämä repo

Aloittaaksesi, kloonaa tai haarauta GitHub-repositorio. Näin saat oman version kurssimateriaalista, jota voit suorittaa, testata ja muokata!

Tämä onnistuu klikkaamalla linkkiä haaraudu repo

Sinulla pitäisi nyt olla oma haarautettu versio tästä kurssista seuraavassa linkissä:

Haarautettu Repo

Pintakloonaus (suositeltu työpajaa / Codespacesia varten)

Koko repositorio voi olla suuri (~3 GB), kun lataat koko historian ja kaikki tiedostot. Jos osallistut vain työpajaan tai tarvitset vain muutaman oppituntikansion, pintakloonaus (tai osittainen kloonaus) välttää suurimman osan latauksesta rajoittamalla historiaa ja/tai ohittamalla tiedostot.

Nopea pintakloonaus — minimaalinen historia, kaikki tiedostot

Korvaa <your-username> alla olevissa komennoissa haarautumisesi URL-osoitteella (tai alkuperäisellä URL-osoitteella, jos haluat).

Kloonataksesi vain viimeisimmän commit-historian (pieni lataus):

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

Kloonataksesi tietyn haaran:

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

Osittainen (sparse) kloonaus — minimaaliset tiedostot + vain valitut kansiot

Tämä käyttää osittaista kloonausta ja sparse-checkoutia (vaatii Git 2.25+ ja suositellaan modernia Git-versiota, jossa on osittaisen kloonauksen tuki):

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

Siirry repo-kansioon:

Bashille:

cd ai-agents-for-beginners

Powershellille:

Set-Location ai-agents-for-beginners

Määritä sitten haluamasi kansiot (esimerkki alla näyttää kaksi kansiota):

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

Kun olet kloonannut ja varmistanut tiedostot, jos tarvitset vain tiedostoja ja haluat vapauttaa tilaa (ilman git-historiaa), poista repositorion metadata (💀 peruuttamaton — menetät kaikki Git-toiminnot: ei committeja, hakuja, pushauksia tai historian käyttöä).

Linux/macOS:

rm -rf .git

Windows:

Remove-Item -Recurse -Force .git

GitHub Codespacesin käyttö (suositeltu paikallisten suurten latausten välttämiseksi)

Vinkkejä

Koodin suorittaminen

Tämä kurssi tarjoaa sarjan Jupyter Notebooks -tiedostoja, joita voit käyttää saadaksesi käytännön kokemusta AI-agenttien rakentamisesta.

Koodiesimerkit käyttävät joko:

Vaatii GitHub-tilin - Ilmainen:

1) Semantic Kernel Agent Framework + GitHub Models Marketplace. Merkitty nimellä (semantic-kernel.ipynb) 2) AutoGen Framework + GitHub Models Marketplace. Merkitty nimellä (autogen.ipynb)

Vaatii Azure-tilauksen: 3) Azure AI Foundry + Azure AI Agent Service. Merkitty nimellä (azureaiagent.ipynb)

Suosittelemme kokeilemaan kaikkia kolmea esimerkkiä nähdäksesi, mikä toimii sinulle parhaiten.

Valitsemasi vaihtoehto määrittää, mitkä asennusvaiheet sinun tulee suorittaa alla:

Vaatimukset

Olemme sisällyttäneet requirements.txt-tiedoston tämän repositorion juureen, joka sisältää kaikki tarvittavat Python-paketit koodiesimerkkien suorittamiseen.

Voit asentaa ne suorittamalla seuraavan komennon terminaalissa repositorion juuressa:

pip install -r requirements.txt

Suosittelemme luomaan Python-virtuaaliympäristön välttääksesi ristiriitoja ja ongelmia.

VSCode-asennus

Varmista, että käytät oikeaa Python-versiota VSCode:ssa.

image

Näytteiden asennus GitHub Models -käyttöön

Vaihe 1: Hanki GitHubin henkilökohtainen käyttöoikeustoken (PAT)

Tämä kurssi hyödyntää GitHub Models Marketplacea, joka tarjoaa ilmaisen pääsyn suuriin kielimalleihin (LLM), joita käytät AI-agenttien rakentamiseen.

GitHub Models -käyttöön tarvitset GitHubin henkilökohtaisen käyttöoikeustokenin.

Tämä onnistuu menemällä henkilökohtaisten käyttöoikeustokenien asetuksiin GitHub-tililläsi.

Noudata vähimmän oikeuden periaatetta luodessasi tokenia. Tämä tarkoittaa, että sinun tulisi antaa tokenille vain ne oikeudet, joita se tarvitsee kurssin koodiesimerkkien suorittamiseen.

  1. Valitse Fine-grained tokens -vaihtoehto näytön vasemmasta reunasta siirtymällä Developer settings -kohtaan.

    Valitse sitten Generate new token.

    Luo token

  2. Anna tokenille kuvaava nimi, joka heijastaa sen tarkoitusta, jotta se on helppo tunnistaa myöhemmin.

    🔐 Tokenin kestoa koskeva suositus

    Suositeltu kesto: 30 päivää Turvallisemman käytännön vuoksi voit valita lyhyemmän ajanjakson—esimerkiksi 7 päivää 🛡️ Se on hyvä tapa asettaa henkilökohtainen tavoite ja suorittaa kurssi, kun oppimisen motivaatio on korkealla 🚀.

    Tokenin nimi ja voimassaoloaika

  3. Rajoita tokenin käyttöoikeus tämän repositorion haarautumiseen.

    Rajoita käyttöoikeus haarautuneeseen repositorioon

  4. Rajoita tokenin käyttöoikeudet: Permissions-kohdassa, klikkaa Account-välilehteä ja paina “+ Add permissions” -painiketta. Avautuu pudotusvalikko. Etsi Models ja valitse sen ruutu. Lisää Models-käyttöoikeus

  5. Varmista tarvittavat käyttöoikeudet ennen tokenin luomista. Varmista käyttöoikeudet

  6. Ennen tokenin luomista varmista, että olet valmis tallentamaan tokenin turvalliseen paikkaan, kuten salasananhallintaohjelmaan, sillä sitä ei näytetä uudelleen luomisen jälkeen. Tallenna token turvallisesti

Kopioi juuri luomasi token. Lisää se nyt tähän kurssiin sisältyvään .env-tiedostoon.

Vaihe 2: Luo .env-tiedosto

Luo .env-tiedosto suorittamalla seuraava komento terminaalissasi.

cp .env.example .env

Tämä kopioi esimerkkitiedoston ja luo .env-tiedoston hakemistoosi, jossa täytät ympäristömuuttujien arvot.

Kun olet kopioinut tokenisi, avaa .env-tiedosto suosikkitekstieditorissasi ja liitä token GITHUB_TOKEN-kenttään. GitHub Token -kenttä

Nyt sinun pitäisi pystyä suorittamaan tämän kurssin koodiesimerkit.

Azure AI Foundry- ja Azure AI Agent Service -näytteiden asennus

Vaihe 1: Hanki Azure-projektisi päätepiste

Seuraa ohjeita hubin ja projektin luomiseksi Azure AI Foundryssa täältä: Hub-resurssien yleiskatsaus

Kun olet luonut projektisi, sinun täytyy hankkia projektisi yhteysmerkkijono.

Tämä onnistuu menemällä projektisi Yleiskatsaus-sivulle Azure AI Foundry -portaalissa.

Projektin yhteysmerkkijono

Vaihe 2: Luo .env-tiedosto

Luo .env-tiedosto suorittamalla seuraava komento terminaalissasi.

cp .env.example .env

Tämä kopioi esimerkkitiedoston ja luo .env-tiedoston hakemistoosi, jossa täytät ympäristömuuttujien arvot.

Kun olet kopioinut tokenisi, avaa .env-tiedosto suosikkitekstieditorissasi ja liitä token PROJECT_ENDPOINT-kenttään.

Vaihe 3: Kirjaudu Azureen

Turvallisuuskäytännön mukaisesti käytämme avaimetonta autentikointia kirjautuaksemme Azure OpenAI:hin Microsoft Entra ID:n avulla.

Avaa seuraavaksi terminaali ja suorita az login --use-device-code kirjautuaksesi Azure-tilillesi.

Kun olet kirjautunut sisään, valitse tilauksesi terminaalissa.

Lisäympäristömuuttujat - Azure Search ja Azure OpenAI

Agentic RAG -oppitunnille - oppitunti 5 - on näytteitä, jotka käyttävät Azure Searchia ja Azure OpenAI:ta.

Jos haluat suorittaa nämä näytteet, sinun täytyy lisätä seuraavat ympäristömuuttujat .env-tiedostoosi:

Yleiskatsaus-sivu (Projekti)

Hallintakeskus

Mallit + Päätepisteet -sivu

Azure-portaali

Ulkoinen verkkosivu

Avaimeton autentikointi

Sen sijaan, että kovakoodaisimme tunnistetietosi, käytämme avaimetonta yhteyttä Azure OpenAI:n kanssa. Tätä varten tuomme DefaultAzureCredential-luokan ja kutsumme myöhemmin DefaultAzureCredential-funktiota saadaksemme tunnistetiedot.

from azure.identity import DefaultAzureCredential, InteractiveBrowserCredential

Jäikö jokin epäselväksi?

Jos sinulla on ongelmia tämän asennuksen kanssa, liity Azure AI Community Discordiin tai luo ongelmaraportti.

Seuraava oppitunti

Olet nyt valmis suorittamaan kurssin koodin. Mukavia hetkiä AI-agenttien maailmaan tutustuessa!

Johdatus AI-agentteihin ja niiden käyttötapauksiin


Vastuuvapauslauseke:
Tämä asiakirja on käännetty käyttämällä tekoälypohjaista käännöspalvelua Co-op Translator. Vaikka pyrimme tarkkuuteen, huomioithan, että automaattiset käännökset voivat sisältää virheitä tai epätarkkuuksia. Alkuperäinen asiakirja sen alkuperäisellä kielellä tulisi pitää ensisijaisena lähteenä. Kriittisen tiedon osalta suositellaan ammattimaista ihmiskäännöstä. Emme ole vastuussa väärinkäsityksistä tai virhetulkinnoista, jotka johtuvat tämän käännöksen käytöstä.