Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Többügynökös használati esetek

16. lecke 18 közül Frissítve 2026. november 2. Fejlesztő
Ezen az oldalon
  1. Az elmélettől a valóságig
  2. 1. eset: Többszintű ügyféltámogatás
  3. 2. eset: Stratégiai hírszerzési folyamat
  4. 3. eset: A sokoldalú asszisztens
  5. Mi különbözteti meg a prototípust a rendszertől
  6. Főbb megállapítások

Az elmélettől a valóságig

Most már érted az átadásokat, a végrehajtási módokat és a láncolást. Ez a lecke ezeket az építőköveket három teljes rendszerbe állítja össze, amelyek mindegyike eltérő topológiára épül: egy eszkalációs láncra, egy folyamatra és egy útválasztóra. Olvasás közben figyeld meg, hogyan következik az architektúra a problémából, és nem fordítva: a szükséglet jellege diktálja a formát, nem pedig a technológia.

1. eset: Többszintű ügyféltámogatás

A támogatási műveletek szinteken működnek: a kérések többsége az első kapcsolattartáskor megoldódik, egy kisebbség technikai diagnózist igényel, és csak maroknyi esetben kerül sor emberi beavatkozásra. Ez a valóság közvetlenül leképezhető egy eszkalációs láncra, ahol minden szint csak a következőnek adja át az ügyet.

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

Két döntés emelkedik ki. Az 1. szint a mistral-medium-latest modellt futtatja, míg a következő szintek a mistral-large-latest modellt használják. Az 1. szint nyeli el a legnagyobb forgalmat, így ha erre a szintre rendelnéd a legdrágább modellt, akkor felesleges szakértelemért fizetnél olyan kérdések esetén, mint például a nyitvatartási idő. A 3. szint eközben nem old meg semmit; csupán egy esetfájlt készít. Pontosan ezt várod el egy emberi eszkalációtól: a beavatkozó mérnök megkapja a kontextust, a már elvégzett diagnosztikai lépéseket és a már kipróbált megoldásokat, ahelyett, hogy nulláról kellene újrakezdenie a kikérdezést.

A gyakorlatban egy ügyfél azt írja: „Nem tudok bejelentkezni a fiókomba.“ Az 1. szint ellenőrzi a GYIK-et, nem talál egyező esetet, és továbbítja az ügyet. A 2. szint diagnosztizál egy adatbázis-problémát, amely a hatáskörén kívül esik, és ismét továbbít. A 3. szint elkészíti a jegyet a teljes előzményekkel.

2. eset: Stratégiai hírszerzési folyamat

Itt a sorrend rögzített és előre ismert: nem elemezhetsz olyat, amit még nem gyűjtöttél össze, és nem írhatsz olyat, amit még nem elemeztél. Ezért egy lineáris lánc kötelező, és a belépési pont nem egy útválasztó, hanem az első láncszem.

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

A jelentés vázlata fekete-fehéren szerepel a riporter utasításaiban, egészen az összefoglaló mondatainak számáig. Ez a szintű pontosság teszi a hírszerzést időtállóan cselekvőképessé: minden jelentés ugyanabban a formátumban készül, így hetről hétre összehasonlíthatod őket, és szerkesztés nélkül terjesztheted őket. Figyeld meg azt az utasítást is, amely előírja a gyűjtő számára a megjelenési dátumok rögzítését – enélkül egy hírszerzési jelentés szilárdnak tűnhet, miközben elavult forrásokra támaszkodik.

3. eset: A sokoldalú asszisztens

Amikor a kérések egymástól független készségeket igényelnek, nincs sem eszkaláció, sem folyamat; csak útválasztás létezik. A központi útválasztó elolvassa a lekérdezést, és elküldi azt az egyik négy szakemberének, akiknek egyikének sem kell tudnia a másikról.

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

Minden szakember pontosan egy eszközt hordoz, és a négy leírás sehol sem fedi át egymást. Ez az átfedés hiánya teszi stabillá az útválasztást: ha két ügynök is hitelesen kezelhetne ugyanazt a kérést, a választás végrehajtásról végrehajtásra változna, és a felhasználóid inkonzisztens minőséget tapasztalnának anélkül, hogy értenék, miért.

Mi különbözteti meg a prototípust a rendszertől

Ez a három rendszer ugyanazt a tervezési szabályt osztja meg: egy ügynök, egy felelősség. Amint egy ügynök két szerepet halmoz fel, utasításai ellentmondanak egymásnak, és leírása túl homályossá válik ahhoz, hogy az útválasztó helyesen döntsön. Ezért minden leírást úgy írj meg, hogy szem előtt tartsd a döntést, amelyet lehetővé kell tennie, és minden utasításkészletet úgy fogalmazz meg, hogy kifejezze, mit nem szabad tennie az ügynöknek, ugyanúgy, mint azt, amit meg kell tennie.

A éles környezetbe való átállás négy olyan követelményt ad hozzá, amelyet a prototípus figyelmen kívül hagy. Először is a naplózás: a kliens mód lehetővé teszi, hogy saját azonosítóiddal kövess nyomon minden átadást, ami az egyetlen mentsvárad lesz azon a napon, amikor egy felhasználó rendellenes választ jelent. Másodszor az időtúllépések (timeouts), amelyek elengedhetetlenek hosszú láncok esetén, ahol egy beragadt láncszem megbénítja a többit. Harmadszor a tartalék megoldások (fallbacks), mert a „mi történik, ha ez az ügynök meghibásodik?“ kérdésre írásos választ kell adni az éles indulás előtt, nem pedig az első incidens után. Végül a költségkövetés: egy háromügynökös lánc minden továbbításnál tokeneket fogyaszt, és csak a beszélgetésenkénti számláló mondja meg neked, hogy a hírszerzési folyamatod néhány centbe vagy sokkal többe kerül.

Főbb megállapítások

  • A többszintű ügyféltámogatás az átadások természetes használati esete
  • A hírszerzési folyamatok (gyűjtés → elemzés → írás) lineáris láncolást használnak
  • A sokoldalú asszisztensek központi útválasztót alkalmaznak a szakemberek felé
  • Éles környezetben a naplózás, az időtúllépések, a tartalék megoldások és a költségfigyelés elengedhetetlen
  • Egy ügynök = egy felelősség, pontos leírással az útválasztáshoz