What is MetaGPT and how does it work?

MetaGPT is a multi-agent framework where role‑based agents (PM, Architect, Engineer, QA) collaborate to produce structured outputs like PRDs, designs, and code. It coordinates tasks, shares context, and lets you plug in local or cloud LLMs for each role.

How do I install and set up MetaGPT?

Install via pip or from source, configure your LLM (OpenAI, Anthropic, or local via Ollama), and set environment variables for model access. Then define agents, create a team, and run a task to generate artifacts like PRDs and code.

Can I use MetaGPT with local LLMs like DeepSeek or Llama?

Yes. Using Ollama, you can run models like DeepSeek‑Coder or Llama locally and point MetaGPT to the local endpoint. This reduces cost and improves privacy for sensitive projects.

What are best practices for prompts in MetaGPT?

Use structured briefs with objectives, users, constraints, success metrics, and deliverables. Assign each agent a clear mandate and provide schema‑based output formats (e.g., JSON/YAML) to reduce ambiguity.

How do I prevent agents from looping or producing low-quality code?

Add step limits and review gates, enforce output schemas, and use specialized models per role (e.g., reasoning‑strong for Architect, code‑strong for Engineer). Include a Tester/Linter agent and run unit tests automatically.

Kako koristiti MetaGPT: Praktični vodič za višestruke radne tokove agenata

Ako ste ikada želeli da vaš AI funkcioniše kao dobro organizovani tim za proizvod—PM, arhitekta, inženjera, testera—koji paralelno radi na zajedničkom cilju, MetaGPT je okvir koji to omogućava. U ovom praktičnom, rešenjima orijentisanom vodiču, vodićemo vas korak po korak kroz korišćenje MetaGPT-a, od instalacije do izgradnje višestrukih radnih tokova agenata, uključujući najbolje prakse, savete za rešavanje problema i stvarne primere koje možete odmah prilagoditi.

Na kraju, moći ćete da instalirate MetaGPT, pokrenete višestruki pipeline agenata, napišete bolje upite, proširite ga alatima i LLM modelima, i brzo isporučite korisno rešenje.

Šta je MetaGPT (i zašto je važan)

MetaGPT je okvir za višestruke agente dizajniran da koordinira specijalizovane agente—kao što su menadžer proizvoda, arhitekta, programer i tester—tako da mogu zajedno da rade na složenim zadacima. Umesto jednog monolitnog AI koji radi sve, MetaGPT sastavlja sistem agenata sa specifičnim ulogama koji dele kontekst, pamćenje i rutiranje zadataka. Rezultat: projekti napreduju od ideje do isporuke uz manje manuelnog upravljanja i više paralelizma.

Uloge višestrukih agenata: Definišite različite odgovornosti (npr. izrada PRD-a, sistemski dizajn, kodiranje).

Zajednički artefakti: Agenti prosleđuju strukturisane izlaske (PRD → dizajn → kod → testovi).

Povezivi LLM modeli: Birajte modele (lokalne ili u oblaku) u zavisnosti od cene, brzine i privatnosti.

Proširivi alati: Dodajte pretragu, izvršavanje koda ili eksterne API-je.

Za dobar pregled i “zašto to funkcioniše”, pogledajte nezavisne vodiče koji detaljno objašnjavaju kako MetaGPT orkestrira timove i generisanje koda. Za konkretan radni tok (automatizacija zahteva proizvoda sa lokalnim modelima), IBM-ov tutorijal prikazuje MetaGPT u kombinaciji sa Ollama i DeepSeek modelima za potpunu izradu PRD-a.

Brzi početak: Instalirajte MetaGPT za 15 minuta

Evo jednostavnog podešavanja koje radi na macOS, Linux-u i WSL-u.

1) Preduslovi

Python 3.10+ i pip

Node.js/npm (za neke alate i integracije ako planirate eksperimente)

Opcionalno: Docker (za reproduktivna okruženja) i Ollama (za lokalne LLM modele)

Proverite svoje okruženje:

python --version
pip --version
node -v
npm -v

Ako se odlučite za lokalni LLM pristup, instalirajte Ollama i preuzmite model (npr. DeepSeek ili varijante Llama 3), kao što je prikazano u primeru automatizacije PRD-a.

2) Instalirajte MetaGPT

# Opcija A: Sa PyPI (ako je dostupno)
pip install metagpt
# Opcija B: Iz izvora (preporučeno za praćenje primera)
git clone <org>/MetaGPT.git
cd MetaGPT
pip install -r requirements.txt

Proverite README projekta za najnovije korake instalacije i dodatne opcije. Vodiči zajednice takođe opisuju lokalno podešavanje uključujući npm i Python podešavanja.

3) Konfigurišite svoje LLM modele

Cloud LLM: Exportujte ključeve (npr. OPENAI_API_KEY, ANTHROPIC_API_KEY).

Lokalni LLM: Pokrenite ollama serve i izaberite model; usmerite MetaGPT na svoj lokalni endpoint.

Primer .env (prilagodite za svog provajdera):

OPENAI_API_KEY=sk-...
MODEL_NAME=gpt-4o-mini
# Ili lokalno
LLM_ENDPOINT=
MODEL_NAME=deepseek-coder

Vaš prvi višestruki radni tok agenata

Napravimo minimalni pipeline „ideja → PRD → dizajn → kod“. Ovo možete prilagoditi web aplikacijama, skriptama ili alatima za obradu podataka.

Konceptualni tok

Agent menadžera proizvoda: Razjašnjava ciljeve, korisnike i metrike uspeha; piše PRD.

Agent arhitekte: Predlaže sistemski dizajn, API-je, kompromise.

Agent inženjera: Piše osnovni kod baziran na dizajnu.

Agent QA/recenzent: Pregledava kod, piše testove, označava probleme.

Primer kostura (Python)

from metagpt import MetaTeam, Agent, Role
from metagpt.llms import LLM
# 1) Definiši LLM backend
llm = LLM(model_name="gpt-4o-mini") # ili lokalni model
# 2) Definiši agente po ulogama
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) Kreiraj tim sa zajedničkom memorijom/kontekstom
team = MetaTeam(agents=.
---
## Pisanje upita koje višestruki agenti razumeju
MetaGPT pokazuje najbolje rezultate kad mu date strukturisane, svesne uloge instrukcije. Razmišljajte kao menadžer koji piše zadatak za četiri specijaliste.
- Cilj: Jedna rečenica koja jasno kaže krajnji cilj.
- Korisnici i obim: Ko ima korist i šta je uključeno/isključeno.
- Ograničenja: Jasne granice (tehnološki stack, latencija, privatnost, budžet).
- Metrike uspeha: Kako izgleda „dobar“ ishod.
- Isporuke: Jasni artefakti (PRD, dijagram, raspored repozitorijuma, testovi).
Primer zadatka:
```yaml
objective: Napraviti Python CLI alat koji čita PDF i pravi jednostranac rezime u Markdown formatu.
users: .
---
## Najbolje prakse za pouzdane rezultate
- Počnite sa malim, pa skalirajte: Validirajte pipeline na minimalnoj specifikaciji pre velikih projekata.
- Jedna uloga, jedan zadatak: Izbegavajte preklapanja odgovornosti zbog smanjenja konfuzije.
- Koristite check-liste: Svakom agentu dajte rubricu (kriterijume prihvatanja) za njihov izlaz.
- Recenzentske kapije: Dodajte ulogu Recenzenta/Vodja koji odobrava ili vraća rad na doradu.
- Održavajte upite strukturisanim: YAML/JSON šeme čine izlaze determinističkijim.
- Spremite artefakte: Sačuvajte PRD/dizajn/kod na disk za praćenje i ponovno pokretanje.
- Kombinujte lokalno i u oblaku: Koristite lokalne modele za nacrte; komplikovane korake prepustite snažnijem cloud modelu.
- Budžetska ograničenja: Postavite limite tokena i kontrole troškova za svaki korak.
---
## Primer projekta: Auto-PRD za zahteve funkcionalnosti
Cilj: Pretvoriti sirovi zahtev za funkcionalnost u doterani PRD sa korisničkim pričama i kriterijumima prihvatanja.
Tok:
1. Parsiranje ulaza: Normalizujte zahtev i izdvojite kontekst (korisnički profil, problemi).
2. Agent PM: Piše nacrt PRD-a sa ciljevima, neciljevima i KPI-evima.
3. Agent arhitekte: Predlaže opcije rešenja sa prednostima i manama.
4. Agent recenzent: Proverava jasnoću, rizike i zavisnosti.
Zašto ovo funkcioniše: Strukturisani prenos zadataka oponaša pravu produktni tim i forsira jasnoću. IBM-ov vodič obrađuje sličan multi-agent PRD tok sa lokalnim modelima koje možete replicirati.
---
## Rešavanje uobičajenih problema
- Looping agenata ili zaglavljivanje
- Smanjite obim i dodajte jasne isporuke.
- Dodajte timeout-ove i limite koraka; omogućite recenzentske kapije.
- Neuredni ili nestrukturisani izlazi
- Primorajte šeme sa JSON/YAML; koristite primer izlaza u upitima.
- Dodajte „Formater“ agenta čiji je jedini zadatak normalizacija izlaza.
- Niska kvaliteta koda
- Koristite model snažan u kodiranju (npr. DeepSeek-Coder lokalno ili vrhunski cloud model) za inženjera.
- Dodajte agenta Tester/Linter; automatski pokrećite jedinicne testove.
- Visoki troškovi
- Koristite lokalne modele za nacrte; završnu doradu prepustite premium LLM-ovima.
- Ograničite kontekst prozore; delite artefakte i dohvatite po potrebi.
- Neusklađenost modela
- Podesite modele prema ulozi (razmišljanje vs. kodiranje vs. uređivanje) i podešavanja temperature.
Nezavisni pregledi ističu snagu MetaGPT-a u generisanju koda i kako izbjeći zamke boljim upitima i alatima.
---
## Dublji nivo: Napredni obrasci
- Retrieval-Augmented Generation (RAG)
- Nahranite svoj tim bazi znanja sa prethodnim PRD-ima, dizajnima i kodovima.
- Dozvolite PM-u/Arhitekti da pretražuju relevantni kontekst pre pisanja.
- Radnje u stilu Toolformer-a
- Omogućite inženjeru da izvršava shell komande, kreira fajlove i pokreće testove.
- Višestruki projekti sa više timova
- Pokrenite više timova paralelno za A/B testiranje rešenja.
- Kontrole sa ljudskim uplitanjem
- Ubacite korake odobrenja (npr. PRD → ljudska recenzija → nastavak).
- Evaluacioni sistem
- Automatski ocenjivanje izlaza (npr. lintovanje, pokrivenost testovima, čitljivost) i povratna informacija agentu Treneru.
---
## Praktične upotrebe koje možete napraviti ove nedelje
- Generisanje ideja za startap → PRD → Prototip sajta
- Interni data alat sa CLI i dokumentacijom
- Dizajn API-ja sa klijentskim bibliotekama u više jezika
- QA pipeline koji generiše testove iz Jira tiketa
- Generator tehničkih blogova sa primerima koda i dijagramima
Zajednički izveštaji prikazuju kako MetaGPT pretvara minimalan ulaz u strukturisane, visokokvalitetne artefakte brzo, naročito za inženjerske i produktne poslove.
---
## Usput: Ubrzajte ideaciju i iteraciju sa [Sider.AI](https://sider.ai)
Vredno je napomenuti: ako pravite upite, pregledate artefakte ili iterirate specifikacije, svestrani asistent poput [Sider.AI](https://sider.ai) može vam pomoći da prototipizujete zadatke, uporedite alternative i izbrusite izlaze pre nego što ih prosledite MetaGPT-u. Posebno je koristan za brainstorming korisničkih priča, kriterijuma prihvatanja i test slučajeva koje vaši agenti mogu koristiti. Istražite [Sider.AI](https://sider.ai) na https://sider.ai./
---
## Akcioni plan: Sledećih 60 minuta
- 10 min: Instalirajte MetaGPT i podesite svoj LLM (lokalni ili u oblaku).
- 15 min: Kreirajte tim od 4 uloge (PM, Arhitekta, Inženjer, QA) i pokrenite mali projekat.
- 15 min: Dodajte šeme za PRD/dizajn i recenzentsku kapiju.
- 20 min: Zamenite modele po ulogama; dodajte alat za pokretanje testova za Inženjera/QA.
Isporučite prvi artefakt danas. Iterirajte sutra.
---
## Ključni zaključci
- MetaGPT vam omogućava da skriptujete tim specijalizovanih agenata koji zajedno rade na složenim zadacima.
- Uspeh zavisi od strukturisanih upita, jasnih isporuka i recenzentskih kapija.
- Kombinujte lokalne i cloud modele za balans troškova, privatnosti i kvaliteta.
- Počnite sa malim pipeline-ima (PRD → dizajn → kod → testovi), pa zatim skalirajte na bogatije alate i upravljanje.
Za dodatni kontekst i praktične primere, pogledajte ove vodiče i tutorijale.
### FAQ
Q1: Šta je MetaGPT i kako funkcioniše?
MetaGPT je okvir za višestruke agente gde agente sa definisanim ulogama (PM, Arhitekta, Inženjer, QA) sarađuju na kreiranju strukturisanih izlaza poput PRD-ova, dizajna i koda. Koordinira zadatke, deli kontekst i omogućava da za svaku ulogu koristite lokalne ili cloud LLM modele.
Q2: Kako da instaliram i podesim MetaGPT?
Instalirajte preko pip-a ili iz izvora, konfigurišite LLM (OpenAI, Anthropic ili lokalno preko Ollama), i podesite promenljive okruženja za pristup modelima. Zatim definišite agente, kreirajte tim i pokrenite zadatak za generisanje artefakata kao što su PRD i kod.
Q3: Mogu li koristiti MetaGPT sa lokalnim LLM modelima kao što su DeepSeek ili Llama?
Da. Korišćenjem Ollama-e, možete lokalno pokrenuti modele kao DeepSeek-Coder ili Llama i usmeriti MetaGPT na lokalni endpoint. Ovo smanjuje troškove i poboljšava privatnost kod osetljivih projekata.
Q4: Koje su najbolje prakse za pisanje upita u MetaGPT?
Koristite strukturisane zadatke sa ciljevima, korisnicima, ograničenjima, metrima uspeha i isporukama. Dodelite svakom agentu jasan mandat i obezbedite izlazni format zasnovan na šemi (npr. JSON/YAML) kako biste smanjili dvosmislenost.
Q5: Kako da sprečim da agenti ulaze u petlju ili proizvode kod niskog kvaliteta?
<a153>Dodajte limite koraka i recenzentske kapije, primorajte na šeme izlaza i koristite specijalizovane modele po ulozi (npr. model sa jakim rezonovanjem za Arhitektu, model jak u kodiranju za Inženjera). Uključite agenta Tester/Linter i automatski pokrećite jedinicne testove.

Kako koristiti MetaGPT: Praktični vodič za radne procese sa više agenata