ai-agents-for-beginners

Kurssin asennus

Johdanto

Tässä osiossa käsitellään, miten kurssin koodiesimerkkejä suoritetaan.

Liity muiden oppijoiden joukkoon ja pyydä apua

Ennen kuin alat kloonata 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. 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ä:

Haarautettu repo

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 parhaiten sinulle.

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 Python-virtuaaliympäristön luomista välttääksesi konflikteja ja ongelmia.

VSCode-asennus

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

image

Asennus GitHub Models -esimerkeille

Vaihe 1: Hanki GitHubin henkilökohtainen käyttöoikeustunnus (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-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.

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

    Valitse sitten Generate new token.

    Luo tunnus

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

    Tunnuksen nimi ja voimassaoloaika

  3. Rajoita tunnuksen käyttöoikeudet haarautettuun repositorioon.

    Rajoita käyttöoikeudet haarautettuun repositorioon

  4. 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. Lisää Models-käyttöoikeus

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

  6. Ennen tunnuksen luomista varmista, että olet valmis tallentamaan tunnuksen turvalliseen paikkaan, kuten salasananhallintajärjestelmään, sillä sitä ei näytetä uudelleen luomisen jälkeen. Tallenna tunnus turvallisesti

Kopioi juuri luomasi tunnus. Lisää tämä kurssin mukana tulevaan .env-tiedostoon.

Vaihe 2: Luo .env-tiedosto

Luo .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.
GitHub Token -kenttä

Nyt sinun pitäisi pystyä suorittamaan kurssin koodiesimerkit.

Asennus Azure AI Foundry- ja Azure AI Agent Service -esimerkeille

Vaihe 1: Hanki Azure-projektin päätepiste

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.

Projektin yhteysmerkkijono

Vaihe 2: Luo .env-tiedosto

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

Vaihe 3: Kirjaudu Azureen

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.

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

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:

Yleiskatsaus-sivu (Projekti)

Hallintakeskus

Models + Endpoints -sivu

Azure-portaali

Ulkoinen verkkosivu

Avaimeton autentikointi

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

Jäikö jokin epäselväksi?

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

Seuraava osio

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