Käyttötapaukset useille agenteille
Tällä sivulla
Käsitteestä todellisuuteen
Ymmärrät nyt siirrot, suoritusmoodit ja ketjutuksen. Tämä oppitunti kokoaa nämä rakennuspalikat kolmeksi kokonaiseksi järjestelmäksi, joista kukin perustuu erilaiseen topologiaan: eskalaatioketjuun, putkeen ja reitittimeen. Lukiessasi kiinnitä huomiota siihen, miten arkkitehturi kumpuaa ongelmasta, ei päinvastoin – tarpeen luonne määrää muodon, ei teknologia.
Tapaus 1: Monitasoinen asiakastuki
Tukitoiminnot toimivat tasoittain: useimmat pyynnöt ratkeavat ensimmäisellä kontaktilla, vähemmistö vaatii teknistä diagnostiikkaa ja kourallinen päätyy ihmiselle. Tämä todellisuus kuvastuu suoraan eskalaatioketjuun, jossa jokainen taso siirtää vain seuraavalle.
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])
Kaksi päätöstä nousevat esiin. Taso 1 käyttää mallia mistral-medium-latest, kun taas myöhemmät tasot käyttävät mallia mistral-large-latest. Taso 1 käsittelee suurimman volyymin, joten kalleimman mallin osoittaminen sille tarkoittaisi tarpeettoman asiantuntemuksen maksamista kysymyksistä, kuten aukioloajoista. Taso 3 ei sitä vastoin ratkaise mitään; se kirjoittaa tapaustiedoston. Juuri sitä haluat ihmiselle tehtävästä eskalaatiosta – insinööri, joka ottaa asian hoitoonsa, saa kontekstin, jo tehdyt diagnostiset vaiheet ja kokeillut ratkaisut sen sijaan, että hän aloittaisi kuulustelun alusta.
Käytännössä asiakas kirjoittaa: “En pääse kirjautumaan tililleni.” Taso 1 tarkistaa FAQ-osion, ei löydä vastaavaa tapausta ja siirtää eteenpäin. Taso 2 diagnosoi tietokantaongelman, joka ylittää sen toimivallan, ja siirtää uudelleen. Taso 3 valmistelee tiketin koko historialla varustettuna.
Tapaus 2: Strateginen tiedusteluputki
Tässä järjestys on kiinteä ja tiedossa etukäteen: et voi analysoida sitä, mitä ei ole kerätty, etkä kirjoittaa sitä, mitä ei ole analysoitu. Lineaarinen ketju on siis pakollinen, ja sisäänmenopiste ei ole reititin vaan ensimmäinen lenkki.
# 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."
)
Raportin runko on kirjoitettu mustaa valkoisella raportoijan ohjeisiin, aina toimeenpanoyhteenvedon lauseiden määrää myöten. Tämä tarkkuustaso tekee tiedustelusta toimintakykyistä ajan myötä: jokainen raportti tulee ulos samassa muodossa, mikä mahdollistaa viikoittaisen vertailun ja jakelun ilman muokkausta. Huomaa myös kerääjän ohje kirjata julkaisupäivät – ilman niitä tiedusteluraportti voi näyttää vankalta nojaten kuitenkin vanhentuneisiin lähteisiin.
Tapaus 3: Monipuolinen avustaja
Kun pyynnöt sisältävät toisiinsa liittymättömiä taitoja, kyseessä ei ole eskalaatio eikä putki, vaan reititys. Keskeinen reititin lukee kyselyn ja lähettää sen yhdelle neljästä asiantuntijastaan, joista kenenkään ei tarvitse tietää muista.
# 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]
)
Jokainen asiantuntija kantaa mukanaan täsmälleen yhtä työkalua, eikä neljän kuvauksessa ole päällekkäisyyttä missään. Tämä päällekkäisyyden puute tekee reitityksestä vakaata: jos kaksi agenttia voisi uskottavasti hoitaa saman pyynnön, valinta vaihtelisi suorituskerrosta toiseen, ja käyttäjäsi kokisivat epäjohdonmukaista laatua ymmärtämättä miksi.
Mikä erottaa prototyypin järjestelmästä
Näillä kolmella järjestelmällä on yhteinen suunnittelusääntö: yksi agentti, yksi vastuu. Heti kun agentti kerää kaksi roolia, sen ohjeet ovat ristiriidassa keskenään ja sen kuvaus muuttuu liian epämääräiseksi, jotta reititin voisi päättää oikein. Kirjoita siis jokainen kuvaus mielessäsi se päätös, jonka sen on mahdollistettava, ja kirjoita jokainen ohjeisto kertomaan, mitä agentin ei tule tehdä yhtä hyvin kuin sen, mitä sen tulee tehdä.
Siirtyminen tuotantoon lisää neljä vaatimusta, jotka prototyyppi jättää huomiotta. Ensinnäkin lokitus: asiakasmoodi antaa sinun jäljittää jokaisen siirron omilla tunnisteillasi, mikä on ainoa keinosi sinä päivänä, kun käyttäjä ilmoittaa poikkeavasta vastauksesta. Toiseksi aikakatkokset, jotka ovat välttämättömiä pitkissä ketjuissa, joissa jumittunut lenkki lamauttaa loput. Kolmanneksi varasuunnitelmat, sillä kysymykseen “mitä tapahtuu, jos tämä agentti epäonnistuu?” on oltava kirjallinen vastaus ennen käyttöönottoa, ei ensimmäisen häiriön jälkeen. Lopuksi kustannusseuranta: kolmen agentin ketju kuluttaa tokenita jokaisessa relaissa, ja vain keskustelukohtainen laskuri kertoo, maksako tiedusteluputesi muutaman sentin vai huomattavasti enemmän.
Keskeiset asiat
- Monitasoinen asiakastuki on luonteva käyttötapaus siirroille
- Tiedusteluputket (kerää → analysoi → kirjoita) hyödyntävät lineaarista ketjutusta
- Monipuoliset avustajat käyttävät keskeistä reititintä asiantuntijoille
- Tuotannossa: lokitus, aikakatkokset, varasuunnitelmat ja kustannusten seuranta ovat välttämättömiä
- Yksi agentti = yksi vastuu, tarkka kuvaus reititystä varten