Primeri uporabe večagentnih sistemov
Na tej strani
Od koncepta do realnosti
Zdaj razumeš predaje, načine izvajanja in veriženje. Ta lekcija združuje te gradnike v tri celovite sisteme, od katerih vsak temelji na drugačni topologiji: verigi eskalacije, cevovodu in usmerjevalniku. Ko bereš, opazi, kako arhitektura izhaja iz problema, ne obratno – narava potrebe narekuje obliko, ne tehnologija.
Primer 1: Večstopenjska podporo strankam
Podporne operacije potekajo po stopnjah: večina zahtevkov se reši ob prvem stiku, manjši del zahteva tehnično diagnozo, le peščica pa konča pri človeku. Ta realnost se neposredno preslika v verigo eskalacije, kjer vsaka raven predaja le naslednji.
from mistralai.client import Mistral
import os
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
# Level 1: FAQ and simple questions
level1 = client.beta.agents.create(
model="mistral-medium-latest",
name="support-level1",
description="Level 1 support: FAQ, common questions, basic information.",
instructions="""You are the first level of support.
- Answer simple questions (hours, rates, FAQ)
- If the question is technical or complex, transfer to level 2
- Be polite and professional""",
tools=[{"type": "document_library", "library_ids": ["faq-library-id"]}]
)
# Level 2: Technical support
level2 = client.beta.agents.create(
model="mistral-large-latest",
name="support-level2",
description="Technical support: diagnosis, troubleshooting, configuration.",
instructions="""You are technical support.
- Diagnose technical issues
- Propose step-by-step solutions
- If the problem requires manual intervention, transfer to level 3""",
tools=[{"type": "web_search"}, {"type": "code_interpreter"}]
)
# Level 3: Human escalation (simulation)
level3 = client.beta.agents.create(
model="mistral-large-latest",
name="support-level3",
description="Escalation: critical issues requiring human intervention.",
instructions="""Prepare a summary of the issue for the technical team:
- Problem context
- Diagnostic steps performed
- Solutions attempted
- Recommendation"""
)
# Chain the escalations
level1 = client.beta.agents.update(agent_id=level1.id, handoffs=[level2.id])
level2 = client.beta.agents.update(agent_id=level2.id, handoffs=[level3.id])
Istopata dve odločitvi. Raven 1 teče na mistral-medium-latest, medtem ko naslednje ravni uporabljajo mistral-large-latest. Raven 1 prevzame največji obseg, zato bi dodelitev najdražjega modela pomenila plačevanje nepotrebnega strokovnega znanja za vprašanja o delovnem času. Raven 3 medtem ne rešuje ničesar; napiše le spis primera. Točno to želiš od človeške eskalacije – inženir, ki prevzame primer, prejme kontekst, že opravljene diagnostične korake in poskušane rešitve, namesto da bi zasliševanje začel znova od ničle.
V praksi stranka napiše: „Ne morem se prijaviti v svoj račun.” Raven 1 preveri pogosta vprašanja (FAQ), ne najde ustreznega primera in predaja zadevo. Raven 2 diagnosticira težavo z bazo podatkov, ki presega njeno pristojnost, in ponovno predaja. Raven 3 pripravi tiket s celotno zgodovino.
Primer 2: Cevovod za strateško obveščanje
Tukaj je vrstni red fiksen in vnaprej znan: analizirati ne moreš tega, kar še ni bilo zbrano, niti pisati tega, kar še ni bilo analizirano. Linearna veriga je zato obvezna, vstopna točka pa ni usmerjevalnik, temveč prva povezava.
# Collector — searches for raw information
collector = client.beta.agents.create(
model="mistral-large-latest",
name="intelligence-collector",
description="Collects strategic information via web search.",
instructions="""Search for information on the requested topic.
- Cover multiple sources
- Include numerical data
- Note publication dates""",
tools=[{"type": "web_search"}]
)
# Analyst — extracts insights
analyst = client.beta.agents.create(
model="mistral-large-latest",
name="intelligence-analyst",
description="Analyzes and extracts insights from raw data.",
instructions="""Analyze the collected data:
- Identify trends
- Spot opportunities and threats
- Quantify when possible""",
tools=[{"type": "code_interpreter"}]
)
# Reporter — produces the report
reporter = client.beta.agents.create(
model="mistral-large-latest",
name="intelligence-reporter",
description="Writes structured intelligence reports.",
instructions="""Write a professional intelligence report:
## Executive Summary (3 sentences)
## Key Facts (bullet points)
## Analysis (2-3 paragraphs)
## Recommendations (concrete actions)
## Sources"""
)
# Pipeline
collector = client.beta.agents.update(agent_id=collector.id, handoffs=[analyst.id])
analyst = client.beta.agents.update(agent_id=analyst.id, handoffs=[reporter.id])
# Launch
response = client.beta.conversations.start(
agent_id=collector.id,
inputs="Strategic intelligence: sovereign AI market in Europe, Q1 2026."
)
Osnutek poročila je v navodilih za poročevalca zapisan črno na belo, vse do števila stavkov v povzetku za vodstvo. Ta stopnja natančnosti je tista, ki sčasoma omogoča uporabnost obveščevalnih podatkov: vsako poročilo izide v isti obliki, kar ti omogoča tedensko primerjavo in distribucijo brez urejanja. Opazi tudi navodilo zbiralcu, naj zabeleži datume objave – brez tega bi lahko obveščevalno poročilo izgledalo trdno, čeprav bi temeljilo na zastarelih virih.
Primer 3: Vsestranski asistent
Ko zahtevki vključujejo nepovezane veščine, ne gre niti za eskalacijo niti za cevovod; gre za usmerjanje. Osrednji usmerjevalnik prebere poizvedbo in jo pošlje enemu od štirih strokovnjakov, od katerih nobenemu ni treba vedeti za druge.
# Specialists
web_researcher = client.beta.agents.create(
model="mistral-large-latest",
name="web-researcher",
description="Searches for current information on the internet.",
tools=[{"type": "web_search"}]
)
data_analyst = client.beta.agents.create(
model="mistral-large-latest",
name="data-analyst",
description="Data analysis, statistics, and visualizations.",
tools=[{"type": "code_interpreter"}]
)
doc_expert = client.beta.agents.create(
model="mistral-large-latest",
name="doc-expert",
description="Queries and synthesizes internal documents.",
tools=[{"type": "document_library", "library_ids": ["docs-lib-id"]}]
)
creative = client.beta.agents.create(
model="mistral-large-latest",
name="creative-agent",
description="Creates visual content and illustrations.",
tools=[{"type": "image_generation"}]
)
# Central router
assistant = client.beta.agents.create(
model="mistral-large-latest",
name="research-assistant",
description="Versatile research assistant.",
instructions="""You are a research assistant. Analyze each request and transfer to the appropriate specialist:
- Current information → web-researcher
- Calculations and data → data-analyst
- Questions about our documents → doc-expert
- Need for illustrations → creative-agent""",
handoffs=[web_researcher.id, data_analyst.id, doc_expert.id, creative.id]
)
Vsak strokovnjak nosi natanko eno orodje in štirje opisi se nikjer ne prekrivajo. Prav to neprekrivanje omogoča stabilno usmerjanje: če bi dva agenta verjetno lahko obravnavala isti zahtevek, bi se izbira spreminjala od izvajanja do izvajanja, tvoji uporabniki pa bi doživljali nedosledno kakovost, ne da bi razumeli zakaj.
Kaj loči prototip od sistema
Ti trije sistemi si delijo isto oblikovno pravilo: en agent, ena odgovornost. Takoj ko agent prevzame dve vlogi, si njegova navodila nasprotujejo in njegov opis postane preveč nejasen, da bi se usmerjevalnik lahko pravilno odločil. Zato vsak opis napiši z mislijo na odločitev, ki jo mora omogočiti, in vsak nabor navodil oblikuj tako, da določa, česa agent ne sme storiti, prav tako kot to, kaj mora storiti.
Prehod v proizvodnjo doda štiri zahteve, ki jih prototip ignorira. Prvič, beleženje (logging): način odjemalca ti omogoča sledenje vsaki predaji z lastnimi identifikatorji, kar bo tvoja edina rešitev, ko bo uporabnik poročal o nenormalnem odzivu. Drugič, časovne omejitve (timeouts), ki so bistvene pri dolgih verigah, kjer zataknjena povezava imobilizira preostanek. Tretjič, nadomestne rešitve (fallbacks), saj mora imeti vprašanje „kaj se zgodi, če ta agent odpove?” pisni odgovor pred zagonom v živo, ne po prvem incidentu. Nazadnje, sledenje stroškom: veriga treh agentov porabi žetone pri vsakem prenosu in le števec na pogovor ti bo povedal, ali tvoj cevovod za obveščanje stane nekaj centov ali precej več.
Ključne ugotovitve
- Večstopenjska podpora strankam je naravni primer uporabe za predaje
- Cevovodi za obveščanje (zbiranje → analiza → pisanje) izkoriščajo linearno veriženje
- Vsestranski asistenti uporabljajo osrednji usmerjevalnik do strokovnjakov
- V proizvodnji so beleženje, časovne omejitve, nadomestne rešitve in spremljanje stroškov nujni
- En agent = ena odgovornost, s natančnim opisom za usmerjanje