Tässä osiossa käsitellään, miten kurssin koodiesimerkkejä suoritetaan.
Ennen kuin alat kloonata reposi, liity AI Agents For Beginners Discord-kanavalle saadaksesi apua asennukseen, kysymyksiin kurssista tai yhteyden muihin oppijoihin.
Aloittaaksesi, kloonaa tai haarauta GitHub-repositorio. Tämä luo oman version kurssimateriaalista, jotta voit suorittaa, testata ja muokata koodia!
Tämä onnistuu napsauttamalla linkkiä haaraamaan repo.
Sinulla pitäisi nyt olla haarautettu versio tästä kurssista seuraavassa linkissä:
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 parhaiten sinulle.
Valitsemasi vaihtoehto määrittää, mitkä asennusvaiheet sinun tulee suorittaa alla:
NOTE: Jos sinulla ei ole Python 3.12 asennettuna, varmista, että asennat sen. Luo sitten venv käyttämällä python3.12 varmistaaksesi, että oikeat versiot asennetaan requirements.txt-tiedostosta.
Esimerkki
Luo Python venv-hakemisto:
python3 -m venv venv
Aktivoi 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 Python-virtuaaliympäristön luomista välttääksesi konflikteja 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-mallien käyttämiseksi sinun tulee luoda GitHubin henkilökohtainen käyttöoikeustunnus.
Tämä onnistuu siirtymällä henkilökohtaisten käyttöoikeustunnusten asetuksiin GitHub-tililläsi.
Noudata vähimmäisoikeuksien periaatetta luodessasi tunnusta. Tämä tarkoittaa, että sinun tulisi antaa tunnukselle vain ne oikeudet, joita se tarvitsee kurssin koodiesimerkkien suorittamiseen.
Valitse Fine-grained tokens
-vaihtoehto näytön vasemmasta reunasta siirtymällä Developer settings -osioon.
Valitse sitten Generate new token
.
Anna tunnukselle kuvaava nimi, joka heijastaa sen tarkoitusta, jotta se on helppo tunnistaa myöhemmin.
🔐 Tunnuksen keston suositus
Suositeltu kesto: 30 päivää
Turvallisemman käytännön vuoksi voit valita lyhyemmän ajan, kuten 7 päivää 🛡️
Tämä on hyvä tapa asettaa henkilökohtainen tavoite ja suorittaa kurssi, kun oppimisen vauhti on korkea 🚀.
Rajoita tunnuksen käyttöoikeudet haarautettuun repositorioon.
Rajoita tunnuksen käyttöoikeudet: Valitse Permissions-kohdasta Account-välilehti ja napsauta “+ Add permissions” -painiketta. Näyttöön tulee pudotusvalikko. Etsi Models ja valitse sen ruutu.
Varmista tarvittavat käyttöoikeudet ennen tunnuksen luomista.
Ennen tunnuksen luomista varmista, että olet valmis tallentamaan tunnuksen turvalliseen paikkaan, kuten salasananhallintajärjestelmään, sillä sitä ei näytetä uudelleen luomisen jälkeen.
Kopioi juuri luomasi tunnus. Lisää tämä kurssin mukana tulevaan .env
-tiedostoon.
.env
-tiedostoLuo .env
-tiedosto suorittamalla seuraava komento terminaalissa.
cp .env.example .env
Tämä kopioi esimerkkitiedoston ja luo .env
-tiedoston hakemistoosi, jossa täytät ympäristömuuttujien arvot.
Kun tunnus on kopioitu, avaa .env
-tiedosto suosikkitekstieditorissasi ja liitä tunnus GITHUB_TOKEN
-kenttään.
Nyt sinun pitäisi pystyä suorittamaan kurssin koodiesimerkit.
Seuraa ohjeita hubin ja projektin luomiseksi Azure AI Foundryssa täältä: Hub-resurssien yleiskatsaus
Kun olet luonut projektisi, sinun tulee hankkia projektin yhteysmerkkijono.
Tämä onnistuu siirtymällä projektisi Overview-sivulle Azure AI Foundry -portaalissa.
.env
-tiedostoLuo .env
-tiedosto suorittamalla seuraava komento terminaalissa.
cp .env.example .env
Tämä kopioi esimerkkitiedoston ja luo .env
-tiedoston hakemistoosi, jossa täytät ympäristömuuttujien arvot.
Kun tunnus on kopioitu, avaa .env
-tiedosto suosikkitekstieditorissasi ja liitä tunnus PROJECT_ENDPOINT
-kenttään.
Turvallisuuskäytännön mukaisesti käytämme avaimetonta autentikointia 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 -osiossa - osio 5 - on esimerkkejä, jotka käyttävät Azure Searchia ja Azure OpenAI:ta.
Jos haluat suorittaa nämä esimerkit, sinun tulee lisätä seuraavat ympäristömuuttujat .env
-tiedostoosi:
AZURE_SUBSCRIPTION_ID
- Tarkista Project details projektisi Overview-sivulta.
AZURE_AI_PROJECT_NAME
- Katso projektisi Overview-sivun yläosasta.
AZURE_OPENAI_SERVICE
- Löydät tämän Included capabilities-välilehdeltä Azure OpenAI Service kohdasta Overview-sivulla.
AZURE_OPENAI_RESOURCE_GROUP
- Siirry Project properties kohtaan Overview-sivulla Management Centerissä.
GLOBAL_LLM_SERVICE
- Connected resources-kohdassa löydät Azure AI Services-yhteyden nimen. Jos ei ole listattu, tarkista Azure portal-kohdasta resurssiryhmä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, napsauta sitä, siirry Resource Management, Keys and Endpoint, selaa alas kohtaan “Azure OpenAI endpoints” ja kopioi se, jossa lukee “Language APIs”.
AZURE_OPENAI_API_KEY
- Kopioi samalta näytöltä KEY 1 tai KEY 2.
AZURE_SEARCH_SERVICE_ENDPOINT
- Etsi Azure AI Search-resurssi, napsauta sitä ja katso Overview.
AZURE_SEARCH_API_KEY
- Siirry Settings ja sitten Keys kopioidaksesi ensisijaisen tai toissijaisen hallintanäppäimen.
AZURE_OPENAI_API_VERSION
- Käy API version lifecycle -sivulla kohdassa Latest GA API release.Sen sijaan, että kovakoodaisimme tunnistetiedot, käytämme avaimetonta yhteyttä Azure OpenAI:hin. Tätä varten tuomme DefaultAzureCredential
-luokan ja kutsumme myöhemmin DefaultAzureCredential
-funktiota saadaksemme tunnisteen.
from azure.identity import DefaultAzureCredential, InteractiveBrowserCredential
Jos sinulla on ongelmia tämän asennuksen kanssa, liity Azure AI Community Discord-kanavalle tai luo ongelmaraportti.
Olet nyt valmis suorittamaan kurssin koodiesimerkit. Mukavaa oppimista AI-agenttien maailmasta!
Johdatus AI-agentteihin ja agenttien 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ä.