Salt la conținutul principal
Română— Alege o limbă
Meniu

Cazuri de utilizare multi-agent

Lecția 16 din 18 Actualizată 2 noiembrie 2026 Dezvoltator
Pe această pagină
  1. De la concept la realitate
  2. Cazul 1: Suport Clienți pe Mai Multe Niveluri
  3. Cazul 2: Pipeline de Informații Strategice
  4. Cazul 3: Asistentul Versatil
  5. Ce distinge un prototip de un sistem
  6. Puncte cheie

De la concept la realitate

Acum că ați înțeles transferurile (handoffs), modurile de execuție și înlănțuirea, această lecție asamblează aceste blocuri de construcție în trei sisteme complete, fiecare bazat pe o topologie diferită: un lanț de escaladare, un pipeline (flux de lucru) și un router. Pe măsură ce citiți, observați cum arhitectura decurge din problemă, nu invers – natura nevoii dictează forma, nu tehnologia.

Cazul 1: Suport Clienți pe Mai Multe Niveluri

Operațiunile de suport funcționează pe niveluri: majoritatea solicitărilor se rezolvă la primul contact, o minoritate necesită diagnostic tehnic, iar câteva ajung la un operator uman. Această realitate se mapează direct pe un lanț de escaladare, unde fiecare nivel transferă doar către următorul.

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

Două decizii ies în evidență. Nivelul 1 rulează pe mistral-medium-latest, în timp ce nivelurile ulterioare folosesc mistral-large-latest. Nivelul 1 absoarbe cel mai mare volum, așa că atribuirea celui mai scump model ar însemna să plătiți pentru o expertiză inutilă la întrebări despre programul de lucru. Nivelul 3, în schimb, nu rezolvă nimic; el redactează un dosar de caz. Exact asta doriți de la o escaladare umană – inginerul care preia cazul primește contextul, pașii de diagnostic deja efectuați și soluțiile deja încercate, în loc să repornească interogarea de la zero.

În practică, un client scrie: „Nu mă pot conecta la contul meu.“ Nivelul 1 verifică FAQ-ul, nu găsește niciun caz corespunzător și transferă. Nivelul 2 diagnostichează o problemă de bază de date care depășește sfera sa de competență și transferă din nou. Nivelul 3 pregătește tichetul cu istoricul complet.

Cazul 2: Pipeline de Informații Strategice

Aici ordinea este fixă și cunoscută dinainte: nu puteți analiza ceea ce nu a fost colectat și nu puteți scrie ceea ce nu a fost analizat. Un lanț liniar este, prin urmare, obligatoriu, iar punctul de intrare nu este un router, ci prima verigă.

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

Structura raportului este scrisă negru pe alb în instrucțiunile agentului reporter, până la numărul de propoziții din rezumatul executiv. Acest nivel de precizie este ceea ce face informațiile acționabile în timp: fiecare raport apare în același format, permițându-vă să comparați săptămână de săptămână și să le distribuiți fără editare. De asemenea, remarcați instrucțiunea pentru agentul colector de a înregistra datele de publicare – fără aceasta, un raport de informații poate părea solid, bazându-se totuși pe surse învechite.

Cazul 3: Asistentul Versatil

Când solicitările implică abilități neînrudite, nu există nici escaladare, nici pipeline; există rutare. Routerul central citește interogarea și o trimite către unul dintre cei patru specialiști ai săi, dintre care niciunul nu trebuie să știe despre ceilalți.

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

Fiecare specialist deține exact un instrument, iar cele patru descrieri nu se suprapun nicăieri. Această lipsă de suprapunere este ceea ce face rutarea stabilă: dacă doi agenți ar putea gestiona în mod plauzibil aceeași solicitare, alegerea ar varia de la o execuție la alta, iar utilizatorii dumneavoastră ar experimenta o calitate inconsistentă fără a înțelege de ce.

Ce distinge un prototip de un sistem

Aceste trei sisteme partajează aceeași regulă de design: un agent, o responsabilitate. De îndată ce un agent acumulează două roluri, instrucțiunile sale se contrazic reciproc, iar descrierea sa devine prea vagă pentru ca routerul să decidă corect. Așadar, scrieți fiecare descriere având în minte decizia pe care trebuie să o permită și formulați fiecare set de instrucțiuni pentru a preciza atât ceea ce agentul trebuie să facă, cât și ceea ce nu trebuie să facă.

Trecerea la producție adaugă patru cerințe pe care un prototip le ignoră. În primul rând, jurnalizarea (logging): modul client vă permite să urmăriți fiecare transfer cu propriii identificatori, ceea ce va fi singura dumneavoastră resursă în ziua în care un utilizator raportează un răspuns aberant. În al doilea rând, timeout-urile, esențiale în lanțurile lungi unde o verigă blocată imobilizează restul. În al treilea rând, mecanismele de fallback (soluții de rezervă), deoarece întrebarea „ce se întâmplă dacă acest agent eșuează?“ trebuie să aibă un răspuns scris înainte de lansare, nu după primul incident. În final, urmărirea costurilor: un lanț de trei agenți consumă token-uri la fiecare releu, iar doar un contor per conversație vă va spune dacă pipeline-ul dumneavoastră de informații costă câțiva cenți sau mult mai mult.

Puncte cheie

  • Suportul clienților pe mai multe niveluri este un caz de utilizare natural pentru transferuri (handoffs)
  • Pipeline-urile de informații (colectare → analiză → scriere) valorifică înlănțuirea liniară
  • Asistenții versatili utilizează un router central către specialiști
  • În producție: jurnalizarea, timeout-urile, fallback-urile și monitorizarea costurilor sunt esențiale
  • Un agent = o responsabilitate, cu o descriere precisă pentru rutare