Veriženje globokih agentov
Na tej strani
Neomejene verige agentov
API za agente Mistral ne nalaga omejitev globine pri veriženju agentov. En agent lahko nalogo pred drugemu, ta tretjemu in tako naprej. Ta svoboda omogoča kompleksne, modularne delovne tokove, vendar prenaša odgovornost za topologijo na tebe: ti odločaš, kdo lahko pokliče koga. Ta zemljevid določa obnašanje sistema prav toliko kot navodila za vsakega posameznega agenta.
Tri topologije in njihove posledice
Linearna veriga je najpreprostejši vzorec: vsak agent nalogo pred naslednjemu brez razvejanja.
Agent A → Agent B → Agent C → Odgovor
To je primerno za procese, kjer je vrstni red vnaprej znan in se nikoli ne spremeni. Tipičen primer je iskanje, nato analiza in nato pisanje: ne pišeš, preden analiziraš, in ne analiziraš, preden iščeš.
# Raziskovalni agent
research = client.beta.agents.create(
model="mistral-large-latest",
name="research",
description="Search for factual information.",
tools=[{"type": "web_search"}]
)
# Analitski agent
analyst = client.beta.agents.create(
model="mistral-large-latest",
name="analyst",
description="Analyze data and extract insights.",
tools=[{"type": "code_interpreter"}]
)
# Pisni agent
writer = client.beta.agents.create(
model="mistral-large-latest",
name="writer",
description="Draft professional reports.",
instructions="Write a structured report based on the analyzed data."
)
# Veriga: research → analyst → writer
research = client.beta.agents.update(
agent_id=research.id,
handoffs=[analyst.id]
)
analyst = client.beta.agents.update(
agent_id=analyst.id,
handoffs=[writer.id]
)
Vsak agent pozna le svojega neposrednega naslednika: research ne ve, da writer sploh obstaja. Veriga obstaja le v klicih update, nikjer drugje.
Zvezdasta veriga naslavlja nasprotno potrebo: osrednji usmerjevalnik razdeljuje naloge med strokovnjake, ki med seboj ne komunicirajo.
┌→ Agent za spletno iskanje
Usmerjevalnik ──┼→ Agent za kalkulator
└→ Pisni agent
router = client.beta.agents.create(
model="mistral-large-latest",
name="router",
description="Orchestrate requests.",
handoffs=[research.id, analyst.id, writer.id]
)
Tukaj vrstni red ni vnaprej določen – usodo določi sama zahteva. Ta oblika ustreza vsestranskim pomočnikom, kjer vsaka zahteva spada pod eno specifično kompetenco.
Hibridna topologija združuje oboje: usmerjevalnik razdeljuje, strokovnjaki pa si lahko naloge predajajo tudi med seboj.
┌→ Raziskovalni agent ──→ Analitski agent
Usmerjevalnik ──┤ │
└→ Pisni agent ←───────────┘
# Raziskovalec lahko predal analitiku
research = client.beta.agents.update(
agent_id=research.id,
handoffs=[analyst.id]
)
# Analitik lahko predal piscu
analyst = client.beta.agents.update(
agent_id=analyst.id,
handoffs=[writer.id]
)
# Usmerjevalnik ima dostop do vseh
router = client.beta.agents.update(
agent_id=router.id,
handoffs=[research.id, analyst.id, writer.id]
)
To je najzmogljivejša oblika, a tudi najtežja za odpravljanje napak. Ista zahteva lahko od ene izvedbe do druge sledi različnim potem, zato je beleženje predaj nujno, ko enkrat zapustiš peskovnik.
Dva produkcijska poteka
Obdelava podatkov ponazarja linearno verigo v njenem najbolj naravnem primeru uporabe: zbiranje, čiščenje, vizualizacija. Zadnja dva koraka uporabljata isto orodje, vendar njuna ločitev ohranja vsak nabor navodil čist – čiščenje in upodabljanje sta ločeni opravili.
# 1. korak: Zbiranje
collector = client.beta.agents.create(
model="mistral-large-latest",
name="data-collector",
description="Collect data from the internet.",
tools=[{"type": "web_search"}]
)
# 2. korak: Čiščenje in transformacija
transformer = client.beta.agents.create(
model="mistral-large-latest",
name="data-transformer",
description="Clean and transform raw data.",
tools=[{"type": "code_interpreter"}]
)
# 3. korak: Analiza in vizualizacija
visualizer = client.beta.agents.create(
model="mistral-large-latest",
name="data-visualizer",
description="Create visualizations and charts.",
tools=[{"type": "code_interpreter"}]
)
# Veriga
collector = client.beta.agents.update(agent_id=collector.id, handoffs=[transformer.id])
transformer = client.beta.agents.update(agent_id=transformer.id, handoffs=[visualizer.id])
Akademski raziskovalni pomočnik sledi isti strukturi, vendar z drugačno vrsto vmesne povezave. Sintetizator nima orodij: njegova vrednost leži izključno v njegovih navodilih, ki od njega zahtevajo, da sooči vire – skupne točke, razhajanja, vrzeli – namesto da bi jih le skladal enega na drugega.
# Iskalnik
searcher = client.beta.agents.create(
model="mistral-large-latest",
name="academic-searcher",
description="Search for academic articles and publications.",
tools=[{"type": "web_search"}]
)
# Sintetizator
synthesizer = client.beta.agents.create(
model="mistral-large-latest",
name="synthesizer",
description="Synthesize and compare multiple sources.",
instructions="Identify common points, divergences, and gaps."
)
# Pisec
academic_writer = client.beta.agents.create(
model="mistral-large-latest",
name="academic-writer",
description="Structured academic writing with citations.",
instructions="Write in academic format with introduction, methodology, results, discussion."
)
# Potek: searcher → synthesizer → writer
searcher = client.beta.agents.update(agent_id=searcher.id, handoffs=[synthesizer.id])
synthesizer = client.beta.agents.update(agent_id=synthesizer.id, handoffs=[academic_writer.id])
Ohranjanje razumne globine
Odsotnost tehnične omejitve ni vabilo k pretiravanju. V praksi veriženje dveh do štirih agentov pokriva veliko večino potreb. Pri petem se tako latenca kot stroški strmo povečata. Razlog je mehaničen: vsak agent doda svoje žetone konteksta, vključno z navodili, poleg zgodovine pogovora, ki je od prve predaje le še rasla. Peti agent ne dela na začetni zahtevi, temveč na vsem, kar so proizvedli prejšnji štirje.
Preden podaljšaš verigo, se vprašaj, ali dodatni korak upravičuje namenskega agenta ali če se prilega obstoječim navodilom agenta. Direktiva za oblikovanje na primer skoraj nikoli ne upravičuje dodatne povezave.
Upoštevaj tudi, da agent ni omejen na eno samo tarčo. Lahko določi več tarč in izbira glede na kontekst.
analyst = client.beta.agents.update(
agent_id=analyst.id,
handoffs=[writer.id, visualizer.id, calculator.id]
)
Ta analitik bo nalogo predal piscu, če je rezultat pripravljen za sporočanje, vizualizatorju, če podatki zahtevajo grafikon, ali kalkulatorju, če še manjka kakšna številka. Izbira temelji, kot vedno, na opisih treh tarč – edinih informacijah, ki so na voljo za to odločitev.
Ključne ugotovitve
- Ni omejitve globine za veriženje agentov
- Trije vzorci: linearni (A→B→C), zvezdasti (usmerjevalnik→strokovnjaki), hibridni (graf)
- Vsak agent ima lahko več ciljev za predajo
- V produkcijskem okolju omeji verige na 2–4 agente za nadzor latency in stroškov
- Opisi agentov so ključni za učinkovito usmerjanje