# Tamthilia 1: Kutana na Msaidizi Wako wa Utafiti wa AI 🤖

![lab1](../../../../translated_images/sw/lab1.1dd5210a7d114e2e.webp)

## Changamoto

Unazindua "Future Bytes," podcast yako mpya ya teknolojia. Kipindi cha 1 ni kuhusu mafanikio ya hivi karibuni ya AI, lakini una saa 24 za:
1. Kufanya utafiti wa mada
2. Kupata vyanzo vya kuaminika
3. Kuandika maandishi ya kuvutia
4. Kufanya isikike ya asili

**Twist ya hadithi**: Huna haja ya kufanya peke yako. Unakaribia kujenga msaidizi wako wa kwanza wa AI ambaye anaweza kusaidia yote haya. Tumuite Alex — mwenza wako wa utafiti asiye na usingizi.

## Kwa Nini Modeli Ndogo za Lugha? (Spoiler: Ni Za Ajabu)

Fikiria Modeli Ndogo za Lugha (SLMs) kama AI yako binafsi anayekaa kwenye *kompyuta yako*. Hakuna wingu, hakuna ada za mwezi, hakuna kushiriki data kwa njia zisizoeleweka.

**Kwa Nini SLMs ni 🔥:**
- **🏠 Inafanya kazi kwenye Kifaa Chako**: Kompyuta ndogo, desktop, hata Raspberry Pi yenye nguvu
- **💸 Hakuna Gharama Zaidi**: Hakuna ada za API zinazokula pesa zako za chakula cha mchana
- **🔒 Faragha Kwanza**: Data yako haiondoki kifaa chako
- **⚡ Haraka Kama Radi**: Hakuna ucheleweshaji wa mtandao, majibu ya papo hapo
- **🪦 Nyepesi**: Vigezo 1B-10B ukilinganisha na 100B+ kwa wakubwa

**SLMs Maarufu**: Qwen 3, Phi-4, Gemma 3 (tuna tumia Qwen kwa warsha hii)

## Vifaa Vyako

### Ollama: Meneja Wako wa Modeli za AI

[Ollama](https://ollama.com/) ni kama Steam kwa modeli za AI. Pakua, endesha, na simamia modeli kwa amri rahisi.

**Kinachofanya kuwa poa:**
- Amri moja ya kupakua na kuendesha modeli yoyote
- Inafanya kazi kwenye Mac, Windows, Linux
- Inatumia GPU yako moja kwa moja ikiwa una moja
- Hifadhi mwanga wa kumbukumbu

### Microsoft Agent Framework: Mahali Panapotokea Uchawi

[Microsoft Agent Framework](https://github.com/microsoft/agent-framework) ni uwanja wako wa kujenga maajenti wa AI wanaoweza:

- 💬 Kuongea na kukumbuka mnenezi wenu
- 🛠️ Kutumia zana maalum (kama kutafuta mtandaoni au kuhakiki hali ya hewa)
- 🧠 Kufikiria matatizo magumu hatua kwa hatua
- 🤝 Kufanya kazi na maajenti wengine kama timu
- 🔌 Kuunganishwa na watoa huduma mbalimbali za AI (OpenAI, Ollama, Azure)

**Vipu vya kujenga:**
- **Maajenti**: Msaidizi wako wa AI wenye kazi maalum
- **Zana**: Uwezo maalum unaowapa
- **Kumbukumbu**: Ili wasisahau mazungumzo yako
- **Ufikiri**: Kuwafundisha kufikiria, siyo tu kujibu

## Mfululizo wa Mafunzo Yako: Misioni 4

### Misioni 1: Tengeneza Mjaenti Wako wa Kwanza

📓 [Fungua Daftari la Maandishi](../code/01.BasicAgent/00.BasicAgent-agent.ipynb)

**Lengo**: Jenga Alex, AI mwandishi wa maandishi ya podcast yako. Alex anahitaji kuzalisha mazungumzo kati ya wenyeji wawili wakijadili mada za teknolojia.

**Utajifunza:**
- Jinsi ya kumfufua mjaenti wa AI (ni rahisi kuliko kuamka Jumatatu)
- Kumpe sifa na maagizo
- Kumfanya azalisha maandishi halisi ya podcast
- Kuelewa anachosema kurudi kwako

**Masharti ya Ushindi**: Alex anaunda maandishi kwa kipindi chako cha "Future Bytes" kuhusu AI! 🎯

### Misioni 2: Mpe Alex Nguvu Zaidi (Zana!)

📓 [Fungua Daftari la Maandishi](../code/01.BasicAgent/01.BasicAgent-tools.ipynb)

**Lengo**: Alex ni mwerevu, lakini hajui hali ya hewa ya leo au saa ngapi. Tufanye hivyo kwa kumpa zana!

**Utajifunza:**
- Tengeneza kazi za Python maalum kama "zana"
- Mpe Alex uhuru wa kuamua *lini* atumie zana gani
- Uone anavyotatua matatizo kwa uhuru
- Changanya zana nyingi kwa kazi ngumu

**Masharti ya Ushindi**: Muulize "Hali ya hewa Tokyo leo ni vipi?" na Alex afanye utafiti peke yake! ☁️

### Misioni 3: Fundisha Alex Kufikiri

📓 [Fungua Daftari la Maandishi](../code/01.BasicAgent/02.BasicAgent-reasoning.ipynb)

**Lengo**: Mfanye Alex aonyeshe mchakato wake. Unapotatua matatizo, unataka kuona *jinsi* anavyofikiria, siyo majibu tu.

**Utajifunza:**
- Washa "modus reasoning" (ni kama kuonyesha kazi yako darasani)
- Angalia mchakato wa mawazo wa Alex hatua kwa hatua
- Elewa chain-of-thought prompting
- Rekebisha matatizo yanapotokea Alex akachanganyikiwa

**Masharti ya Ushindi**: Muulize swali gumu la hisabati na uone Alex akifikiria! 🧠

### Misioni 4: Unganisha Alex kwa Intaneti

📓 [Fungua Daftari la Maandishi](../code/01.BasicAgent/03.BasicAgent-websearch.ipynb)

**Lengo**: Maarifa ya Alex yana tarehe ya mwisho. Tutamunganisha na mtandao kwa taarifa za sasa!

**Utajifunza:**
- Tengeneza zana ya utafutaji mtandaoni maalum
- Unganisha APIs za nje
- Shughulikia makosa ya mtandao kwa upole
- Pata taarifa zaidi ya akaunti ya mafunzo ya Alex

**Masharti ya Ushindi**: Muulize kuhusu habari mpya za teknolojia leo na upate matokeo mapya! 📰

## Kabla Ya Kuanza 🚀

**Zana Zinazohitajika**:
- Python 3.10+ imewekwa
- Ollama inakimbia (angalia kwa `ollama --version`)
- VS Code yenye programu-jalizi ya Python
- Angalau 8GB RAM (16GB ikiwa unataka utendaji laini)

## Mpangilio wa Misioni

Fuata daftari la mafunzo kwa mpangilio ili kupata hadithi kamili:

1. [00.BasicAgent-agent.ipynb](../code/01.BasicAgent/00.BasicAgent-agent.ipynb) — Kutana na Alex (mjaenti wako wa kwanza)
2. [01.BasicAgent-tools.ipynb](../code/01.BasicAgent/01.BasicAgent-tools.ipynb) — Weka nguvu!
3. [02.BasicAgent-reasoning.ipynb](../code/01.BasicAgent/02.BasicAgent-reasoning.ipynb) — Fundisha Alex kufikiri
4. [03.BasicAgent-websearch.ipynb](../code/01.BasicAgent/03.BasicAgent-websearch.ipynb) — Ufikiaji wa Intaneti umefunguliwa!

## Utaweza Nini

Baada ya Tamthilia 1, utaweza:

- ✅ Kuendesha modeli za AI kwenye vifaa vyako (hakuna wingu linalohitajika!)
- ✅ Kujenga maajenti wenye sifa na ujuzi maalum
- ✅ Kuwapa maajenti zana za kutatua matatizo ya dunia halisi
- ✅ Kufanya maajenti waonyeshe mchakato wao wa kufikiri
- ✅ Kuunganisha maajenti na vyanzo vya data vya nje
- ✅ Kutatua matatizo wanapokukosea

## Katika Matatizo (Na Jinsi ya Kuyarekebisha) 🔧

### "Alex haendi! Kumbukumbu imetumika!"
**Suluhisho**: Kompyuta yako inakabiliwa na mzigo. Jaribu kufunga programu nyingine, au tumia modeli ndogo zaidi. 8GB RAM ni kiwango cha chini kabisa.

### "Alex ni polepole mno"
**Suluhisho**: Washa msaada wa GPU katika mipangilio ya Ollama. Au punguza ukubwa wa dirisha la muktadha. Mode ya kasi imewashwa! 🏎️

### "Zana hazifanyi kazi!"
**Suluhisho**: Angalia mara mbili saini za kazi zako. Alex anahitaji vidokezo sahihi vya aina ili kuelewa zana inavyofanya kazi. Fikiria kama kutoa maagizo wazi.

## Viungo Msaada 🔗

- [Agent Framework Docs](https://github.com/microsoft/agent-framework) — Viongozo rasmi na mifano
- [Maktaba ya Modeli ya Ollama](https://ollama.com/library) — Vinaganizi wote waliopo
- [Modeli ya Qwen](https://ollama.com/library/qwen3) — Kutana na akili ya AI yako
- [Mifano ya Msimbo](https://github.com/microsoft/agent-framework/tree/main/python/samples) — Chukua mawazo kutoka hapa

## Inayofuata: Tamthilia 2 🎬

Una mjaenti mmoja. Lakini je, ungekuwa na *timu* ya maajenti wanaofanya kazi pamoja? Katika Tamthilia 2, utajenga kikosi chako kamili cha uzalishaji wa podcast:
- **Mjaenti Mtafiti**: Anatafuta vyanzo bora
- **Mjaenti Mwandishi**: Anaunda maandishi kamili  
- **Mhariri (Wewe!)**: Anakubali au kuomba mabadiliko

Tuchanganye uchawi wa AI! → [Tamthilia 2: Kusanya Timu Yako ya Uzalishaji](02.AIAgentOrchestrationAndWorkflows.md)

---

**Umekwama?** Uliza maswali wakati wa warsha. Sote tunajifunza pamoja! 🙌

---

<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Kiarifu cha Kutokuwajibika**:  
Nyaraka hii imetafsiriwa kwa kutumia huduma ya tafsiri ya AI [Co-op Translator](https://github.com/Azure/co-op-translator). Ingawa tunajitahidi kwa usahihi, tafadhali fahamu kuwa tafsiri za kiotomatiki zinaweza kuwa na makosa au usahihi mdogo. Nyaraka ya asili katika lugha yake halisi inapaswa kuchukuliwa kama chanzo cha mamlaka. Kwa taarifa muhimu, tafsiri ya kitaalamu ya binadamu inapendekezwa. Hatuwajibiki kwa kutoelewana au tafsiri zisizo sahihi zinazotokana na matumizi ya tafsiri hii.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->