Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Mitme agendi kasutusjuhtumid

Õppetund 16 / 18 Värskendatud 2. november 2026 Arendajatele
Sellel lehel
  1. Kontseptsioonist reaalsuseni
  2. Juhtum 1: Mitmetasandiline klienditugi
  3. Juhtum 2: Strateegilise luure torustik
  4. Juhtum 3: Mitmekülgne assistent
  5. Mis eristab prototüüpi süsteemist
  6. Peamised punktid

Kontseptsioonist reaalsuseni

Nüüd mõistad üleandmisi, täitmise režiime ja aheldamist. Selles õppetükis paneme need ehitusplokid kokku kolmeks terviklikuks süsteemiks, millest igaüks põhineb erineval topoloogial: eskaleerimisahel, torustik ja ruuter. Lugedes pane tähele, kuidas arhitektuur tuleneb probleemist, mitte vastupidi – vajaduse olemus dikteerib vormi, mitte tehnoloogia.

Juhtum 1: Mitmetasandiline klienditugi

Tugiteenused töötavad tasanditena: enamik päringuid lahendatakse esimesel kontaktil, vähemus nõuab tehnilist diagnostikat ja käputäis jõuab lõpuks inimeseni. See reaalsus kaardistub otse eskaleerimisahelasse, kus iga tase annab asja edasi ainult järgmisele.

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])

Paistavad silma kaks otsust. 1. tase töötab mudeliga mistral-medium-latest, samas kui järgnevad tasandid kasutavad mudelit mistral-large-latest. 1. tase neelab suurima koormuse, seega tähendaks sellele kõige kallima mudeli määramist tarbetu eksperditeadmiste eest maksmist selliste küsimuste puhul nagu lahtiolekuajad. 3. tase seevastu ei lahenda midagi; see koostab juhtumi faili. See on täpselt see, mida soovid inimesele eskaleerimisel – üle võtev insener saab kätte konteksti, juba tehtud diagnostilised sammud ja proovitud lahendused, selle asemel et alustada ülekuulamist nullist.

Praktikas kirjutab klient: „Ma ei pääse oma kontole sisse.“ 1. tase kontrollib KKK-d, ei leia vastavat juhtumit ja annab asja edasi. 2. tase diagnoosib andmebaasiprobleemi, mis jääb tema pädevusest välja, ja annab asja uuesti edasi. 3. tase koostab pileti koos täieliku ajalooga.

Juhtum 2: Strateegilise luure torustik

Siin on järjekord fikseeritud ja eelnevalt teada: sa ei saa analüüsida seda, mida pole kogutud, ega kirjutada seda, mida pole analüüsitud. Seetõttu on lineaarne ahel kohustuslik ja sisendpunktiks pole ruuter, vaid esimene lüli.

# 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."
)

Aruande struktuur on kirjutatud must-valgelt reporteri juhistesse, kuni juhatuse kokkuvõtte lausete arvuni. Just see täpsus muudab luureandmed ajas tegutsemisvõimeliseks: iga aruanne väljub samas vormingus, võimaldades võrrelda nädalat nädala haaval ja neid levitada ilma toimetamiseta. Pane tähele ka koguja juhiseid salvestada avaldamiskuupäevad – ilma selleta võib luurearuanne tunduda kindel, tuginedes samas aegunud allikatele.

Juhtum 3: Mitmekülgne assistent

Kui päringud hõlmavad omavahel seotamata oskusi, pole tegemist ei eskaleerimise ega torustikuga; tegemist on suunamisega. Keskne ruuter loeb päringu ja saadab selle ühele neljast spetsialistist, kellest ükski ei pea teistest midagi teadma.

# 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]
)

Iga spetsialist kannab täpselt üht tööriista ja nelja kirjeldus ei kattu kusagil. Just see kattumatus muudab suunamise stabiilseks: kui kaks agenti saaksid usutavalt sama päringut käsitleda, varieeruks valik ühest täitmisest teiseni ja kasutajad kogeksid ebajärjekindlat kvaliteeti, mõistmata, miks.

Mis eristab prototüüpi süsteemist

Neid kolme süsteemi ühendab sama disainireegel: üks agent, üks vastutusala. Niipea kui agent kogub endale kaks rolli, hakkavad selle juhised üksteisele vastu rääkima ja selle kirjeldus muutub ruuterile liiga ebamääraseks, et õigesti otsustada. Seega kirjuta iga kirjeldus silmas pidades otsust, mida see peab võimaldama, ja kirjuta iga juhiste komplekt nii, et see sätestaks, mida agent ei tohi teha, samavõrd kui seda, mida ta peab tegema.

Tootmisse viimine lisab neli nõuet, mida prototüüp eirab. Esiteks logimine: kliendirežiim võimaldab sul jälgida iga üleandmist oma identifikaatoritega, mis on sinu ainus pääsetee päeval, kui kasutaja teatab ebaharilikust vastusest. Teiseks ajalõpid, mis on hädavajalikud pikkades ahelates, kus kinni jäänud lüli halvab ülejäänud osa. Kolmandaks varuplahendused, sest küsimusele „mis juhtub, kui see agent ebaõnnestub?“ peab olema kirjalik vastus enne kasutuselevõttu, mitte pärast esimest intsidenti. Lõpuks kulude jälgimine: kolme agendi ahel tarbib tokeneid igas edastusetapis ja ainult vestlusepõhine loendur ütleb sulle, kas sinu luuretorustik maksab mõned sendid või tunduvalt rohkem.

Peamised punktid

  • Mitmetasandiline klienditugi on üleandmiste loomulik kasutusjuhtum
  • Luuretorustikud (kogumine → analüüs → kirjutamine) kasutavad lineaarset aheldamist
  • Mitmekülgsed assistendid kasutavad spetsialistide suunamiseks keskset ruuterit
  • Tootmises on hädavajalikud: logimine, ajalõpid, varuplahendused ja kulude jälgimine
  • Üks agent = üks vastutusala, koos täpse kirjeldusega suunamiseks