ai-agents-for-beginners

Usanidi wa Kozi

Utangulizi

Somo hili litafundisha jinsi ya kuendesha sampuli za msimbo wa kozi hii.

Jiunge na Wanafunzi Wengine na Pata Msaada

Kabla ya kuanza kunakili repo yako, jiunge na AI Agents For Beginners Discord channel ili kupata msaada wowote wa usanidi, maswali yoyote kuhusu kozi, au kuungana na wanafunzi wengine.

Nakili au Fork Repo Hii

Ili kuanza, tafadhali nakili au fork Hifadhi ya GitHub. Hii itakupa toleo lako la nyenzo za kozi ili uweze kuendesha, kujaribu, na kurekebisha msimbo!

Hii inaweza kufanyika kwa kubofya kiungo cha fork repo

Sasa unapaswa kuwa na toleo lako la forked la kozi hii katika kiungo kinachofuata:

Forked Repo

Nakili ya Kawaida (inapendekezwa kwa warsha / Codespaces)

Hifadhi nzima inaweza kuwa kubwa (~3 GB) unapopakua historia kamili na faili zote. Ikiwa unahudhuria tu warsha au unahitaji tu folda chache za somo, nakili ya kawaida (au nakili ya sparse) huepuka upakuaji mwingi kwa kufupisha historia na/au kuruka blobs.

Nakili ya haraka ya kawaida — historia ndogo, faili zote

Badilisha <your-username> katika amri zilizo hapa chini na URL ya fork yako (au URL ya upstream ikiwa unapendelea).

Ili kunakili historia ya commit ya hivi karibuni pekee (upakuaji mdogo):

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

Ili kunakili tawi maalum:

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

Nakili ya sehemu (sparse) — blobs ndogo + folda zilizochaguliwa pekee

Hii inatumia nakili ya sehemu na sparse-checkout (inahitaji Git 2.25+ na Git ya kisasa inayopendekezwa na msaada wa nakili ya sehemu):

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

Ingia kwenye folda ya repo:

Kwa bash:

cd ai-agents-for-beginners

Kwa Powershell:

Set-Location ai-agents-for-beginners

Kisha taja ni folda zipi unazotaka (mfano hapa chini unaonyesha folda mbili):

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

Baada ya kunakili na kuthibitisha faili, ikiwa unahitaji tu faili na unataka kuokoa nafasi (hakuna historia ya git), tafadhali futa metadata ya hifadhi (💀isiyoweza kubadilishwa — utapoteza utendaji wote wa Git: hakuna commits, pulls, pushes, au ufikiaji wa historia).

Kwa Linux/macOS:

rm -rf .git

Kwa Windows:

Remove-Item -Recurse -Force .git

Kutumia GitHub Codespaces (inapendekezwa kuepuka upakuaji mkubwa wa ndani)

Vidokezo

Kuendesha Msimbo

Kozi hii inatoa mfululizo wa Jupyter Notebooks ambazo unaweza kuendesha ili kupata uzoefu wa vitendo wa kujenga AI Agents.

Sampuli za msimbo zinatumia:

Inahitaji Akaunti ya GitHub - Bure:

1) Semantic Kernel Agent Framework + GitHub Models Marketplace. Imewekwa alama kama (semantic-kernel.ipynb) 2) AutoGen Framework + GitHub Models Marketplace. Imewekwa alama kama (autogen.ipynb)

Inahitaji Usajili wa Azure: 3) Azure AI Foundry + Azure AI Agent Service. Imewekwa alama kama (azureaiagent.ipynb)

Tunapendekeza ujaribu aina zote tatu za mifano ili kuona ni ipi inakufaa zaidi.

Chaguo lolote unalochagua, litaamua hatua za usanidi unazohitaji kufuata hapa chini:

Mahitaji

Tumeshirikisha faili ya requirements.txt katika mzizi wa hifadhi hii ambayo ina pakiti zote za Python zinazohitajika kuendesha sampuli za msimbo.

Unaweza kuzisakinisha kwa kuendesha amri ifuatayo katika terminal yako kwenye mzizi wa hifadhi:

pip install -r requirements.txt

Tunapendekeza kuunda mazingira ya Python virtual ili kuepuka migogoro na matatizo.

Usanidi wa VSCode

Hakikisha unatumia toleo sahihi la Python katika VSCode.

image

Usanidi wa Sampuli zinazotumia GitHub Models

Hatua ya 1: Pata Token ya Ufikiaji wa Kibinafsi ya GitHub (PAT)

Kozi hii inatumia GitHub Models Marketplace, ikitoa ufikiaji wa bure kwa Large Language Models (LLMs) ambazo utatumia kujenga AI Agents.

Ili kutumia GitHub Models, utahitaji kuunda GitHub Personal Access Token.

Hii inaweza kufanyika kwa kwenda kwenye mipangilio ya Personal Access Tokens katika Akaunti yako ya GitHub.

Tafadhali fuata Kanuni ya Upendeleo wa Chini unapounda token yako. Hii inamaanisha unapaswa tu kutoa token ruhusa zinazohitajika kuendesha sampuli za msimbo katika kozi hii.

  1. Chagua chaguo la Fine-grained tokens upande wa kushoto wa skrini yako kwa kwenda kwenye Developer settings

    Kisha chagua Generate new token.

    Generate Token

  2. Weka jina la kuelezea kwa token yako linaloonyesha kusudi lake, ili iwe rahisi kutambua baadaye.

    🔐 Pendekezo la Muda wa Token

    Muda uliopendekezwa: siku 30 Kwa usalama zaidi, unaweza kuchagua muda mfupi—kama siku 7 🛡️ Ni njia nzuri ya kuweka lengo la kibinafsi na kukamilisha kozi huku kasi yako ya kujifunza ikiwa juu 🚀.

    Token Name and Expiration

  3. Punguza wigo wa token kwa fork yako ya hifadhi hii.

    Limit scope to fork repository

  4. Punguza ruhusa za token: Chini ya Permissions, bofya kichupo cha Account, na bofya kitufe cha “+ Add permissions”. Kutakuwa na dropdown. Tafadhali tafuta Models na weka alama kwenye kisanduku chake. Add Models Permission

  5. Thibitisha ruhusa zinazohitajika kabla ya kuunda token. Verify Permissions

  6. Kabla ya kuunda token, hakikisha uko tayari kuhifadhi token katika sehemu salama kama hifadhi ya meneja wa nywila, kwani haitatolewa tena baada ya kuundwa. Store Token Securely

Nakili token yako mpya ambayo umekuja kuunda. Sasa utaongeza hii kwenye faili yako ya .env iliyojumuishwa katika kozi hii.

Hatua ya 2: Unda Faili Yako ya .env

Ili kuunda faili yako ya .env endesha amri ifuatayo katika terminal yako.

cp .env.example .env

Hii itanakili faili ya mfano na kuunda .env katika folda yako ambapo utaweka maadili ya vigezo vya mazingira.

Kwa token yako iliyokopiwa, fungua faili ya .env katika mhariri wako wa maandishi unaopenda na weka token yako kwenye sehemu ya GITHUB_TOKEN. GitHub Token Field

Sasa unapaswa kuwa na uwezo wa kuendesha sampuli za msimbo wa kozi hii.

Usanidi wa Sampuli zinazotumia Azure AI Foundry na Azure AI Agent Service

Hatua ya 1: Pata Endpoint ya Mradi wa Azure

Fuata hatua za kuunda hub na mradi katika Azure AI Foundry zilizopatikana hapa: Hub resources overview

Baada ya kuunda mradi wako, utahitaji kupata string ya muunganisho wa mradi wako.

Hii inaweza kufanyika kwa kwenda kwenye ukurasa wa Overview wa mradi wako katika portal ya Azure AI Foundry.

Project Connection String

Hatua ya 2: Unda Faili Yako ya .env

Ili kuunda faili yako ya .env endesha amri ifuatayo katika terminal yako.

cp .env.example .env

Hii itanakili faili ya mfano na kuunda .env katika folda yako ambapo utaweka maadili ya vigezo vya mazingira.

Kwa token yako iliyokopiwa, fungua faili ya .env katika mhariri wako wa maandishi unaopenda na weka token yako kwenye sehemu ya PROJECT_ENDPOINT.

Hatua ya 3: Ingia kwenye Azure

Kama mazoea bora ya usalama, tutatumia uthibitishaji bila funguo kuingia kwenye Azure OpenAI na Microsoft Entra ID.

Kisha, fungua terminal na endesha az login --use-device-code ili kuingia kwenye akaunti yako ya Azure.

Baada ya kuingia, chagua usajili wako katika terminal.

Vigezo vya Mazingira vya Ziada - Azure Search na Azure OpenAI

Kwa Somo la Agentic RAG - Somo la 5 - kuna sampuli zinazotumia Azure Search na Azure OpenAI.

Ikiwa unataka kuendesha sampuli hizi, utahitaji kuongeza vigezo vifuatavyo vya mazingira kwenye faili yako ya .env:

Ukurasa wa Muhtasari (Mradi)

Kituo cha Usimamizi

Ukurasa wa Models + Endpoints

Azure Portal

Ukurasa wa Nje

Usanidi wa uthibitishaji bila funguo

Badala ya kuweka maelezo yako ya kuingia, tutatumia muunganisho bila funguo na Azure OpenAI. Ili kufanya hivyo, tutaleta DefaultAzureCredential na baadaye kuita kazi ya DefaultAzureCredential ili kupata uthibitisho.

from azure.identity import DefaultAzureCredential, InteractiveBrowserCredential

Umekwama Mahali Fulani?

Ikiwa unakutana na changamoto yoyote wakati wa kuendesha mpangilio huu, jiunge na Azure AI Community Discord au unda suala.

Somo Linalofuata

Sasa uko tayari kuendesha msimbo wa kozi hii. Furahia kujifunza zaidi kuhusu ulimwengu wa Mawakala wa AI!

Utangulizi wa Mawakala wa AI na Matumizi ya Mawakala


Kanusho:
Hati hii imetafsiriwa kwa kutumia huduma ya tafsiri ya AI Co-op Translator. Ingawa tunajitahidi kwa usahihi, tafadhali fahamu kuwa tafsiri za kiotomatiki zinaweza kuwa na makosa au kutokuwa sahihi. Hati ya asili katika lugha yake ya awali inapaswa kuzingatiwa kama chanzo cha mamlaka. Kwa taarifa muhimu, tafsiri ya kitaalamu ya binadamu inapendekezwa. Hatutawajibika kwa kutoelewana au tafsiri zisizo sahihi zinazotokana na matumizi ya tafsiri hii.