from metagpt import MetaTeam, Agent, Role
from metagpt.llms import LLM
# 1) Bainisha mfumo wa LLM
llm = LLM(model_name="gpt-4o-mini") # au elekeza kwa muundo wa ndani
# 2) Bainisha mawakala maalum kwa majukumu
pm = Agent(name="PM", role=Role.PRODUCT_MANAGER, llm=llm)
arch = Agent(name="Architect", role=Role.ARCHITECT, llm=llm)
eng = Agent(name="Engineer", role=Role.ENGINEER, llm=llm)
qa = Agent(name="QA", role=Role.QA, llm=llm)
# 3) Unda timu na kumbukumbu/mukhtadha wa pamoja
team = MetaTeam(agents=.
---
## Uandishi wa Madokezo Ambayo Mawakala Wengi Wanaelewa
MetaGPT inang'aa unapotoa maagizo yaliyopangwa, yanayofahamu majukumu. Fikiria kama meneja anayeandika muhtasari kwa wataalamu wanne.
- Lengo: Sentensi moja inayoeleza lengo la mwisho.
- Watumiaji na Upeo: Nani anafaidika na nini kimejumuishwa/kimetolewa.
- Vizuizi: Mipaka wazi (msingi, muda wa kusubiri, faragha, bajeti).
- Vipimo vya Mafanikio: Nini "nzuri" inaonekana kama.
- Matokeo Yanayoweza Kuwasilishwa: Vitu dhahiri (PRD, mchoro, mpangilio wa repo, majaribio).
Mfano wa muhtasari:
```yaml
objective: Build a Python CLI that reads a PDF and produces a 1-page summary in Markdown.
users: .
---
## Mbinu Bora za Matokeo ya Kuaminika
- Anza kidogo, kisha upanue: Thibitisha mtiririko kwenye vipimo vidogo kabla ya miradi mikubwa.
- Jukumu moja, mamlaka moja: Epuka majukumu yanayoingiliana ili kupunguza kuchanganyikiwa.
- Tumia orodha hakiki: Mpe kila wakala rubriki (vigezo vya kukubalika) kwa matokeo yao.
- Pitia ukaguzi wa lango: Ongeza jukumu la Mhakiki/Kiongozi ambalo linaidhinisha au linatuma kazi nyuma.
- Weka madokezo yakiwa yamepangwa: Schemas za YAML/JSON hufanya matokeo kuwa ya uhakika zaidi.
- Hifadhi vitu: Hifadhi PRD/muundo/msimbo kwenye diski kwa ufuatiliaji na uendeshaji tena.
- Oanisha ndani + wingu: Tumia miundo ya ndani kwa rasimu; ongeza hatua ngumu kwa muundo wa wingu wenye nguvu zaidi.
- Vizuizi vya bajeti: Weka mipaka ya tokeni na ukaguzi wa gharama kwa kila hatua.
---
## Mfano wa Mradi: PRD ya Kiotomatiki kwa Maombi ya Kipengele
Lengo: Badilisha ombi la kipengele ghafi kuwa PRD iliyosafishwa na hadithi za mtumiaji na vigezo vya kukubalika.
Mtiririko:
1. Uchambuzi wa ingizo: Sanifisha ombi na utoe muktadha (mtumiaji persona, pointi za maumivu).
2. Wakala wa PM: Anaandika PRD na malengo, yasiyo ya malengo, KPI.
3. Wakala wa mbunifu: Anapendekeza chaguzi za suluhisho na faida/hasara.
4. Wakala wa mhakiki: Anahakikisha uwazi, hatari, na utegemezi zimeandikwa.
Kwa nini inafanya kazi: Uwasilishaji uliopangwa unaakisi timu halisi za bidhaa na hulazimisha uwazi. Mwongozo wa IBM unaelezea mtiririko sawa wa PRD wa mawakala wengi na miundo ya ndani unayoweza kuiga.
---
## Utatuzi wa Masuala ya Kawaida
- Mawakala wanazunguka au kusimama
- Punguza upeo na uongeze matokeo dhahiri.
- Ongeza muda wa kumaliza na mipaka ya hatua; wezesha malango ya ukaguzi.
- Matokeo machafu au yasiyopangwa
- Tekeleza schemas na JSON/YAML; dokezo na mifano ya umbizo.
- Ongeza wakala wa "Mwandishi wa Umbizo" ambaye kazi yake pekee ni kusawazisha matokeo.
- Msimbo wa ubora duni
- Tumia muundo wenye nguvu wa msimbo (mfano, DeepSeek‑Coder ndani ya nchi, au muundo wa juu wa wingu) kwa Mhandisi.
- Ongeza wakala wa Mjaribu/Linter; endesha majaribio ya kitengo moja kwa moja.
- Gharama kubwa
- Tumia miundo ya ndani kwa kuandaa; ongeza tu kwa LLM za malipo kwa polishing ya mwisho.
- Punguza madirisha ya muktadha; gawanya vitu na urejeshe inapohitajika.
- Kutolingana kwa muundo
- Rekebisha miundo ya kila jukumu (hoja dhidi ya usimbaji dhidi ya uhariri) na mipangilio ya halijoto.
Muhtasari huru unaangazia nguvu ya MetaGPT katika utengenezaji wa msimbo na jinsi ya kuepuka hatari na madokezo bora na zana.
---
## Kwenda Ndani Zaidi: Mifumo ya Juu
- Uzalishaji Uliokuzwa na Urejeshaji (RAG)
- Lisha timu yako "msingi wa maarifa" wa mradi wa PRD za zamani, miundo, na msimbo.
- Ruhusu PM/Mbunifu kurejesha muktadha muhimu kabla ya kuandika.
- Vitendo vya mtindo wa Toolformer
- Ruhusu Mhandisi kuendesha amri za shell, kuunda faili, na kutekeleza majaribio.
- Miradi ya wapangaji wengi
- Endesha timu nyingi kwa sambamba kwa uchunguzi wa suluhisho la A/B.
- Udhibiti wa binadamu-ndani-ya-kitanzi
- Ingiza hatua za idhini (mfano, PRD → ukaguzi wa binadamu → endelea).
- Uendeshaji wa tathmini
- Matokeo ya daraja la kiotomatiki (mfano, linting, chanjo ya majaribio, alama za usomaji) na ulishe matokeo nyuma kwa wakala wa Kocha.
---
## Visa vya Matumizi Halisi Unavyoweza Kujenga Wiki Hii
- Uanzishaji wa Mawazo → PRD → Tovuti ya Mfano
- Zana ya data ya ndani na CLI na hati
- Muundo wa API na maktaba za mteja katika lugha nyingi
- Mchakato wa QA ambao hutengeneza majaribio kutoka kwa tikiti za Jira
- Jenereta ya blogi ya kiufundi na sampuli za msimbo na michoro
Maandishi ya jumuiya yanaonyesha uwezo wa MetaGPT wa kugeuza ingizo ndogo kuwa vitu vilivyopangwa, vya ubora wa juu haraka, haswa kwa uhandisi na kazi ya bidhaa.
---
## Kwa njia: Harakisha uundaji wa mawazo na marudio na [Sider.AI](https://sider.ai)
Inafaa kuzingatia: ikiwa unaandaa madokezo, unakagua vitu, au unarudia vipimo, msaidizi anayeweza kutumika kama [Sider.AI](https://sider.ai) anaweza kukusaidia kutengeneza muhtasari, kulinganisha njia mbadala, na kuboresha matokeo kabla ya kuyakabidhi kwa MetaGPT. Ni muhimu sana kwa kuchangia mawazo ya hadithi za mtumiaji, vigezo vya kukubalika, na kesi za majaribio ambazo mawakala wako wanaweza kutumia. Gundua [Sider.AI](https://sider.ai) katika https://sider.ai./
---
## Mpango wa Utekelezaji: Dakika Zako 60 Zijazo
- Dakika 10: Sakinisha MetaGPT na uweke LLM yako (ndani au wingu).
- Dakika 15: Unda timu ya majukumu 4 (PM, Mbunifu, Mhandisi, QA) na uendeshe mradi mdogo sana.
- Dakika 15: Ongeza schemas za PRD/muundo na lango la Mhakiki.
- Dakika 20: Badilisha miundo kwa kila jukumu; ongeza zana ya mwendeshaji wa majaribio kwa Mhandisi/QA.
Safirisha kitu cha kwanza leo. Rudia kesho.
---
## Mambo Muhimu ya Kuzingatia
- MetaGPT hukuruhusu kuandika timu ya mawakala maalum ambao hufanya kazi pamoja kwenye kazi ngumu.
- Mafanikio yanategemea madokezo yaliyopangwa, matokeo wazi, na malango ya ukaguzi.
- Changanya miundo ya ndani na wingu ili kusawazisha gharama, faragha, na ubora.
- Anza na mtiririko mdogo (PRD → muundo → msimbo → majaribio), kisha upanue kwa zana tajiri na utawala.
Kwa muktadha wa ziada na mifano ya vitendo, angalia miongozo na mafunzo haya.
### Maswali Yanayoulizwa Mara kwa Mara
Swali la 1: MetaGPT ni nini na inafanyaje kazi?
MetaGPT ni mfumo wa mawakala wengi ambapo mawakala wanaozingatia majukumu (PM, Mbunifu, Mhandisi, QA) hushirikiana kutoa matokeo yaliyopangwa kama vile PRD, miundo, na msimbo. Inaratibu kazi, inashiriki muktadha, na hukuruhusu kuchomeka LLM za ndani au wingu kwa kila jukumu.
Swali la 2: Ninawezaje kusakinisha na kuweka MetaGPT?
Sakinisha kupitia pip au kutoka kwa chanzo, sanidi LLM yako (OpenAI, Anthropic, au ya ndani kupitia Ollama), na uweke vigezo vya mazingira kwa ufikiaji wa muundo. Kisha bainisha mawakala, unda timu, na uendeshe kazi ili kutoa vitu kama vile PRD na msimbo.
Swali la 3: Je, ninaweza kutumia MetaGPT na LLM za ndani kama vile DeepSeek au Llama?
Ndiyo. Kwa kutumia Ollama, unaweza kuendesha miundo kama vile DeepSeek‑Coder au Llama ndani ya nchi na kuelekeza MetaGPT kwenye kituo cha ndani. Hii inapunguza gharama na inaboresha faragha kwa miradi nyeti.
Swali la 4: Ni mbinu gani bora za madokezo katika MetaGPT?
Tumia muhtasari uliopangwa na malengo, watumiaji, vizuizi, vipimo vya mafanikio, na matokeo. Mpe kila wakala mamlaka wazi na utoe miundo ya matokeo kulingana na schema (mfano, JSON/YAML) ili kupunguza utata.
Swali la 5: Ninawezaje kuzuia mawakala kuzunguka au kutoa msimbo wa ubora duni?
Ongeza mipaka ya hatua na malango ya ukaguzi, tekeleza schemas za matokeo, na utumie miundo maalum kwa kila jukumu (mfano, yenye nguvu ya hoja kwa Mbunifu, yenye nguvu ya msimbo kwa Mhandisi). Jumuisha wakala wa Mjaribu/Linter na uendeshe majaribio ya kitengo moja kwa moja.