Slučajevi upotrebe s više agenata
Na ovoj stranici
Od koncepta do stvarnosti
Sada razumiješ predaje, načine izvršavanja i lančanje. Ova lekcija sastavlja te gradivne blokove u tri cjelovita sustava, od kojih je svaki izgrađen na drugačijoj topologiji: lanac eskalacije, cjevovod i usmjerivač. Dok čitaš, primijeti kako arhitektura proizlazi iz problema, a ne obrnuto – priroda potrebe diktira oblik, a ne tehnologija.
Slučaj 1: Korisnička podrška s više razina
Operacije podrške odvijaju se u razinama: većina zahtjeva rješava se pri prvom kontaktu, manjini je potrebna tehnička dijagnoza, a šačica njih završava kod čovjeka. Ta se stvarnost izravno preslikava na lanac eskalacije, gdje svaka razina prosljeđuje zahtjev samo sljedećoj.
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])
Dvije odluke ističu se. Razina 1 radi na mistral-medium-latest, dok naknadne razine koriste mistral-large-latest. Razina 1 apsorbira najveći obujam, pa bi joj dodjeljivanje najskupljeg modela značilo plaćanje nepotrebne stručnosti za pitanja o radnom vremenu. Razina 3, s druge strane, ništa ne rješava; ona piše dosje slučaja. To je točno ono što želiš od ljudske eskalacije – inženjer koji preuzima slučaj prima kontekst, već provedene dijagnostičke korake i pokušana rješenja, umjesto da ispitivanje pokreće ispočetka.
U praksi, korisnik napiše: „Ne mogu se prijaviti na svoj račun.“ Razina 1 provjerava FAQ, ne pronalazi odgovarajući slučaj i prosljeđuje zahtjev. Razina 2 dijagnosticira problem s bazom podataka koji je izvan njenog dosega i ponovno prosljeđuje. Razina 3 priprema tiket s potpunom poviješću.
Slučaj 2: Cjevovod za stratešku obavještajnu djelatnost
Ovdje je redoslijed fiksan i unaprijed poznat: ne možeš analizirati ono što nije prikupljeno, niti pisati ono što nije analizirano. Linearni lanac je stoga obavezan, a ulazna točka nije usmjerivač, već prva karika.
# 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."
)
Okvir izvješća napisan je crno na bijelo u uputama izvjestitelja, sve do broja rečenica u sažetku za rukovodstvo. Ova razina preciznosti ono je što obavještajne podatke čini djelotvornima tijekom vremena: svako izvješće izlazi u istom formatu, što ti omogućuje usporedbu iz tjedna u tjedan i njihovu distribuciju bez uređivanja. Također, obrati pozornost na uputu prikupljaču da zabilježi datume objave – bez toga, obavještajno izvješće može izgledati čvrsto, a da se oslanja na zastarjele izvore.
Slučaj 3: Svestrani asistent
Kada zahtjevi uključuju nepovezane vještine, ne postoji ni eskalacija ni cjevovod; postoji usmjeravanje. Središnji usmjerivač čita upit i šalje ga jednom od svoja četiri specijalista, od kojih nijedan ne mora znati za ostale.
# 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]
)
Svaki specijalist nosi točno jedan alat, a četiri opisa se nigdje ne preklapaju. Upravo taj nedostatak preklapanja čini usmjeravanje stabilnim: kada bi dva agenta mogla vjerojatno obraditi isti zahtjev, izbor bi varirao od jednog izvršenja do drugog, a tvoji bi korisnici iskusili nekonzistentnu kvalitetu ne shvaćajući zašto.
Što razlikuje prototip od sustava
Ova tri sustava dijele isto pravilo dizajna: jedan agent, jedna odgovornost. Čim agent akumulira dvije uloge, njegove se upute međusobno proturječe, a njegov opis postaje previše nejasan da bi usmjerivač mogao ispravno odlučiti. Stoga svaki opis piši imajući na umu odluku koju mora omogućiti, a svaki skup uputa piši tako da navodi što agent ne smije raditi, kao i što mora raditi.
Prijelaz u proizvodnju dodaje četiri zahtjeva koje prototip ignorira. Prvo, bilježenje (logging): način rada s klijentom omogućuje ti praćenje svake predaje s tvojim vlastitim identifikatorima, što će biti tvoje jedino utočište onog dana kada korisnik prijavi aberrantni odgovor. Drugo, vremenska ograničenja (timeouts), ključna na dugim lancima gdje zaglavljena karika imobilizira ostatak. Treće, rezervne opcije (fallbacks), jer na pitanje „što se događa ako ovaj agent zakaže?“ mora postojati pisani odgovor prije puštanja u rad, a ne nakon prvog incidenta. Konačno, praćenje troškova: lanac od tri agenta troši tokene na svakom releju, a samo brojač po razgovoru reći će ti košta li tvoj obavještajni cjevovod nekoliko centi ili znatno više.
Ključne točke
- Korisnička podrška s više razina prirodan je slučaj upotrebe za predaje
- Obavještajni cjevovodi (prikupi → analiziraj → napiši) iskorištavaju linearno lančanje
- Svestrani asistenti koriste središnji usmjerivač prema specijalistima
- U proizvodnji: bilježenje, vremenska ograničenja, rezervne opcije i praćenje troškova su ključni
- Jedan agent = jedna odgovornost, s preciznim opisom za usmjeravanje