Grandinėlis su giliais agentais
Šiame puslapyje
Neribotos agentų grandinės
Mistral Agents API nenustato jokio gylio limite agentų grandinėms. Vienas agentas gali perduoti užduotį antram, tas – trečiam ir taip toliau. Ši laisvė leidžia kurti sudėtingas, modulines darbo eigas, tačiau kartu tenka tau pačiam prisiimti atsakomybę už topologiją: tu sprendži, kas kam gali skambinti. Šis žemėlapis lemia sistemos elgseną lygiai taip pat kaip ir kiekvieno atskiro agento instrukcijos.
Trys topologijos ir jų pasekmės
Linijinė grandinė yra paprasčiausias šablonas: kiekvienas agentas perduoda užduotį kitam be šakojimosi.
Agentas A → Agentas B → Agentas C → Atsakymas
Tai tinka procesams, kuriuose eiliškumas iš anksto žinomas ir niekada nekinta. Tipiškas pavyzdys: paieška, tada analizė, tada rašymas. Tu nerašai prieš analizuodamas ir neanalizuoji prieš ieškodamas.
# Tyrimų agentas
research = client.beta.agents.create(
model="mistral-large-latest",
name="research",
description="Search for factual information.",
tools=[{"type": "web_search"}]
)
# Analitikas
analyst = client.beta.agents.create(
model="mistral-large-latest",
name="analyst",
description="Analyze data and extract insights.",
tools=[{"type": "code_interpreter"}]
)
# Rašytojas
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."
)
# Grandinė: 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]
)
Kiekvienas agentas žino tik savo tiesioginį įpėdinį: research net nežino, kad writer egzistuoja. Grandinė egzistuoja tik update kvietimuose ir niekur kitur.
Žvaigždinė grandinė tenkina priešingą poreikį: centrinis maršrutizatorius paskirsto užduotis specialistams, kurie tarpusavyje nebendrauja.
┌→ Web Search Agent
Router ──┼→ Calculator Agent
└→ Writer Agent
router = client.beta.agents.create(
model="mistral-large-latest",
name="router",
description="Orchestrate requests.",
handoffs=[research.id, analyst.id, writer.id]
)
Čia eiliškumas nėra iš anksto nustatytas – pati užklausa nulemia, kur ji bus nukreipta. Ši forma tinka universaliems asistentams, kai kiekviena užklausa patenka į vieną konkrečią kompetencijos sritį.
Hibridinė topologija sujungia abu būdus: maršrutizatorius paskirsto užduotis, o specialistai taip pat gali jas perduoti vienas kitam.
┌→ Research Agent ──→ Analyst Agent
Router ──┤ │
└→ Writer Agent ←───────────┘
# Research gali perduoti Analyst
research = client.beta.agents.update(
agent_id=research.id,
handoffs=[analyst.id]
)
# Analyst gali perduoti Writer
analyst = client.beta.agents.update(
agent_id=analyst.id,
handoffs=[writer.id]
)
# Router turi prieigą prie visų
router = client.beta.agents.update(
agent_id=router.id,
handoffs=[research.id, analyst.id, writer.id]
)
Tai galingiausia forma, tačiau ir sunkiausiai derinama. Ta pati užklausa nuo vieno vykdymo iki kito gali nueiti skirtingais keliais, todėl, išėjus iš bandymų aplinkos (sandbox), perdavimų registravimas tampa būtinas.
Dvi gamybinės duomenų apdorojimo grandinės
Duomenų apdorojimas iliustruoja natūraliausią linijinės grandinės naudojimo atvejį: surinkti, išvalyti, vizualizuoti. Paskutiniuose dviejuose žingsniuose naudojamas tas pats įrankis, tačiau jų atskyrimas leidžia išlaikyti švarias instrukcijų rinkinius – valymas ir vaizdavimas yra skirtingos užduotys.
# 1 žingsnis: Surinkimas
collector = client.beta.agents.create(
model="mistral-large-latest",
name="data-collector",
description="Collect data from the internet.",
tools=[{"type": "web_search"}]
)
# 2 žingsnis: Valymas ir transformavimas
transformer = client.beta.agents.create(
model="mistral-large-latest",
name="data-transformer",
description="Clean and transform raw data.",
tools=[{"type": "code_interpreter"}]
)
# 3 žingsnis: Analizė ir vizualizacija
visualizer = client.beta.agents.create(
model="mistral-large-latest",
name="data-visualizer",
description="Create visualizations and charts.",
tools=[{"type": "code_interpreter"}]
)
# Grandinė
collector = client.beta.agents.update(agent_id=collector.id, handoffs=[transformer.id])
transformer = client.beta.agents.update(agent_id=transformer.id, handoffs=[visualizer.id])
Akademinis tyrimų asistentas laikosi tos pačios struktūros, tačiau su kitokio tipo tarpine grandimi. Sintezatorius neturi jokių įrankių: jo vertė slypi vien jo instrukcijose, kurios liepia jam palyginti šaltinius – bendrus punktus, skirtumus, spragas – o ne tiesiog juos sukrauti vieną ant kito.
# Iškotojas
searcher = client.beta.agents.create(
model="mistral-large-latest",
name="academic-searcher",
description="Search for academic articles and publications.",
tools=[{"type": "web_search"}]
)
# Sintezatorius
synthesizer = client.beta.agents.create(
model="mistral-large-latest",
name="synthesizer",
description="Synthesize and compare multiple sources.",
instructions="Identify common points, divergences, and gaps."
)
# Rašytojas
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."
)
# Grandinė: 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])
Protingo gylio išlaikymas
Techninio limite nebuvimas nėra kvietimas elgtis be saiko. Praktiškai dviejų–keturių agentų grandinės padengia didžiąją dalį poreikių. Viršijus penkis agentus, delsos ir kaštai staigiai išauga. Priežastis mechaninė: kiekvienas agentas pridėja savo konteksto tokenus, įskaitant instrukcijas, prie pokalbio istorijos, kuri nuo pirmojo perdavimo tik auga. Penktas agentas dirba ne su pradine užklausa, o su viskuo, ką sukūrė prieš tai buvę keturi.
Prieš ilginant grandinę, paklausk savęs, ar papildomas žingsnis nusipelno atskiro agento, ar gali tilpti į esamo agento instrukcijas. Pavyzdžiui, formatavimo nurodymas beveik niekada nepateisina papildomos grandies kūrimo.
Taip pat atkreipk dėmesį, kad agentas nėra apribotas vienu tikslu. Jis gali deklaruoti kelis tikslus ir pasirinkti priklausomai nuo konteksto.
analyst = client.beta.agents.update(
agent_id=analyst.id,
handoffs=[writer.id, visualizer.id, calculator.id]
)
Šis analitikas nukreips užduotį rašytojui, jei rezultatas paruoštas pateikti, vizualizatoriui, jei duomenys reikalauja diagramos, arba skaičiuotuvui, jei vis dar trūksta skaitinės reikšmės. Pasirinkimas, kaip visada, remiasi trijų tikslų aprašymais – tai vienintelė informacija, prieinama sprendimui priimti.
Svarbiausi punktai
- Agentų grandinėms nėra gylio limite
- Trys šablonai: linijinis (A→B→C), žvaigždinis (maršrutizatorius→specialistai), hibridinis (grafas)
- Kiekvienas agentas gali turėti kelis perdavimo tikslus
- Gamyboje apribok grandines 2–4 agentais, kad kontroliuotum delsas ir kaštus
- Agentų aprašymai yra kritiškai svarbūs efektyviam maršrutizavimui