Tässä osiossa käsitellään, kuinka kurssin koodiesimerkit suoritetaan.
Ennen kuin alat kloonata omaa reposi, liity AI Agents For Beginners Discord-kanavalle saadaksesi apua asennukseen, kysymyksiin kurssista tai yhteyden muihin oppijoihin.
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ä:

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.
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
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
Luo uusi Codespace tälle repolle GitHub-käyttöliittymän kautta.
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:
NOTE: Jos sinulla ei ole Python3.12 asennettuna, varmista, että asennat sen. Luo sitten venv python3.12:lla varmistaaksesi, että oikeat versiot asennetaan requirements.txt-tiedostosta.
Esimerkki
Luo Python venv-hakemisto:
python3 -m venv venv
Aktivoi sitten venv-ympäristö:
macOS ja Linux
source venv/bin/activate
Windows
venv\Scripts\activate
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.
Varmista, että käytät oikeaa Python-versiota VSCode:ssa.
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.
Valitse Fine-grained tokens -vaihtoehto näytön vasemmasta reunasta siirtymällä Developer settings -kohtaan.

Valitse sitten Generate new token.

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 🚀.

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

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

Varmista tarvittavat käyttöoikeudet ennen tokenin luomista. 
Ennen tokenin luomista varmista, että olet valmis tallentamaan tokenin turvalliseen paikkaan, kuten salasananhallintaohjelmaan, sillä sitä ei näytetä uudelleen luomisen jälkeen. 
Kopioi juuri luomasi token. Lisää se nyt tähän kurssiin sisältyvään .env-tiedostoon.
.env-tiedostoLuo .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.

Nyt sinun pitäisi pystyä suorittamaan tämän kurssin koodiesimerkit.
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.

.env-tiedostoLuo .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.
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.
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:
AZURE_SUBSCRIPTION_ID - Tarkista Projektin tiedot projektisi Yleiskatsaus-sivulta.
AZURE_AI_PROJECT_NAME - Katso projektisi Yleiskatsaus-sivun yläosasta.
AZURE_OPENAI_SERVICE - Löydät tämän Sisältyvät ominaisuudet-välilehdeltä Azure OpenAI Service -kohdasta Yleiskatsaus-sivulla.
AZURE_OPENAI_RESOURCE_GROUP - Mene Projektin ominaisuudet-kohtaan Yleiskatsaus-sivulla Hallintakeskuksessa.
GLOBAL_LLM_SERVICE - Liitetyt resurssit-kohdassa, etsi Azure AI Services -yhteyden nimi. Jos ei ole listattu, tarkista Azure-portaali resurssiryhmästäsi AI Services -resurssin nimi.
AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME - Valitse upotusmallisi (esim. text-embedding-ada-002) ja huomioi Deployment name mallin tiedoista.
AZURE_OPENAI_CHAT_DEPLOYMENT_NAME - Valitse chat-mallisi (esim. gpt-4o-mini) ja huomioi Deployment name mallin tiedoista.
AZURE_OPENAI_ENDPOINT - Etsi Azure AI services, klikkaa sitä, mene Resurssien hallinta, Avaimet ja päätepiste, selaa alas “Azure OpenAI endpoints” kohtaan ja kopioi se, jossa lukee “Language APIs”.
AZURE_OPENAI_API_KEY - Samalta näytöltä, kopioi AVAIN 1 tai AVAIN 2.
AZURE_SEARCH_SERVICE_ENDPOINT - Etsi Azure AI Search -resurssisi, klikkaa sitä ja katso Yleiskatsaus.
AZURE_SEARCH_API_KEY - Mene sitten Asetukset ja sitten Avaimet kopioidaksesi ensisijaisen tai toissijaisen hallinta-avaimen.
AZURE_OPENAI_API_VERSION - Käy API-version elinkaari -sivulla kohdassa Viimeisin GA API -julkaisu.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
Jos sinulla on ongelmia tämän asennuksen kanssa, liity Azure AI Community Discordiin tai luo ongelmaraportti.
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ä.