Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Każijiet ta' Użu Multi-Aġent

Lezzjoni 16 / 18 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Mill-Kunċett għar-Realtà
  2. Każ 1: Appoġġ għall-Klijenti Multi-Livell
  3. Każ 2: Pipeline ta’ Intelliġenza Strateġika
  4. Każ 3: L-Assistent Versatili
  5. X’Jiddistingwi Prototip minn Sistema
  6. Punti Ewlenin

Mill-Kunċett għar-Realtà

Issa tifhem it-trasferimenti (handoffs), il-modalitajiet ta’ eżekuzzjoni u l-katina (chaining). Din il-lezzjoni tgħaqqad dawn il-blokki tal-bini f’tliet sistemi sħaħ, kull wieħed ibni fuq topoloġija differenti: katina ta’ eskalazzjoni, pipeline u router. Hekk kif taqra, innota kif l-arkitettura tgħodd mill-problema, mhux bil-maqlub—in-natura tal-ħtieġa timla d-ditta forma, mhux it-teknoloġija.

Każ 1: Appoġġ għall-Klijenti Multi-Livell

L-operazzjonijiet ta’ appoġġ jimxu b’livelli: il-biċċa l-kbira tat-talbiet issolvu fl-ewwel kuntatt, minoranza teħtieġ dijanjosi teknika, u ftit jispiċċaw f’idejn bniedem. Din ir-realtà timmappja direttament ma’ katina ta’ eskalazzjoni, fejn kull livell jittrasferixxi biss għal dak li jmiss.

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

Żewġ deċiżjonijiet jispikkaw. Il-Livell 1 jaħdem fuq mistral-medium-latest filwaqt li l-livelli sussegwenti jużaw mistral-large-latest. Il-Livell 1 jassorbi l-akbar volum, allura li tassenjah lill-aktar mudell għali jfisser li tħallas għal għarfien mhux meħtieġ fuq mistoqsijiet dwar sigħat ta’ xogħol. Il-Livell 3, min-naħa l-oħra, ma jsolvi xejn; jikteb fajl tal-każ. Dan huwa eżattament dak li trid minn eskalazzjoni umana—l-inġinier li jieħu f’idejh jirċievi l-kuntest, il-passi dijanjostiċi diġà mwettqa, u s-soluzzjonijiet diġà ppruvati, minflok ma jerġa’ jibda l-interrogazzjoni minn żero.

Fil-prattika, klijent jikteb, “Ma nistax nidħol fil-kont tiegħi.” Il-Livell 1 jiċċekkja l-FAQ, isib li m’hemm l-ebda każ li jaqbel, u jittrasferixxi. Il-Livell 2 jiddijanjożja problema fil-bażi tad-data li hija barra mill-kompetenza tiegħu u jittrasferixxi mill-ġdid. Il-Livell 3 iħejji t-ticket bl-istorja sħiħa.

Każ 2: Pipeline ta’ Intelliġenza Strateġika

Hawnhekk l-ordni hija fissa u magħrufa minn qabel: ma tistax tanalizza dak li ma ġiex miġbur, jew tikteb dak li ma ġiex analizzat. Għalhekk, katina lineari hija obbligatorja, u l-punt tad-dħul mhuwiex router iżda l-ewwel ħolqa.

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

L-istruttura tar-rapport hija miktuba b’mod ċar ħafna fl-istruzzjonijiet tar-reporter, saħansitra n-numru ta’ sentenzi fis-sommarju eżekuttiv. Dan il-livell ta’ preċiżjoni huwa dak li jagħmel l-intelliġenza azzjonabbli maż-żmien: kull rapport joħroġ bl-istess format, u jippermettilek tqabbel ġimgħa b’ġimgħa u tqassamhom mingħajr ma teħtieġ editjar. Innota wkoll l-istruzzjoni għall-collector biex jirreġistra d-dati tal-pubblikazzjoni—mingħajrha, rapport ta’ intelliġenza jista’ jidher sod waqt li jiddependi fuq sorsi antikwati.

Każ 3: L-Assistent Versatili

Meta t-talbiet jinvolvu ħiliet mhux relatati, ma jkun hemm la eskalazzjoni u lanqas pipeline; ikun hemm routing. Ir-router ċentrali jaqra l-mistoqsija u jibgħatha lil wieħed mill-erba’ speċjalisti tiegħu, l-ebda wieħed minnhom m’għandu bżonn jaf dwar l-oħrajn.

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

Kull speċjalista ġġorr eżattament għodda waħda, u d-deskrizzjonijiet erbgħa ma jikkoinċidu mkien. Din in-nuqqas ta’ sovrappożizzjoni huwa dak li jagħmel ir-routing stabbli: jekk żewġ aġenti setgħu possibbilment jittrattaw l-istess talba, l-għażla kienet tvarja minn eżekuzzjoni għal oħra, u l-utenti tiegħek jesperjenzaw kwalità inkonsistenti mingħajr ma jifhmu għaliex.

X’Jiddistingwi Prototip minn Sistema

Dawn it-tliet sistemi jaqsmu l-istess regola tad-disinn: aġent wieħed, responsabbiltà waħda. Hekk kif aġent jakkumula żewġ rwoli, l-istruzzjonijiet tiegħu jikkontradixxu lil xulxin u d-deskrizzjoni tiegħu ssir vaga wisq biex ir-router jiddeċiedi b’mod korrett. Għalhekk, ikteb kull deskrizzjoni bil-ħsieb tad-deċiżjoni li trid tippermetti, u ikteb kull sett ta’ istruzzjonijiet biex tiddikjara x’għandu jagħmel l-aġent kif ukoll x’m’għandux jagħmel.

Il-passaġġ għall-produzzjoni jżid erba’ rekwiżiti li prototip jinjora. L-ewwel, il-logging: il-modalità tal-klijent tippermettilek issegwi kull trasferiment bl-identifikaturi tiegħek stess, li se jkunu l-uniku rikors tiegħek il-jum li utent jirrapporta tweġiba aberranti. It-tieni, it-timeouts, essenzjali fuq katini twal fejn ħolqa mwaqqfa timmobilizza l-bqija. It-tielet, il-fallbacks, għax il-mistoqsija “x’jiġri jekk dan l-aġent ifalli?” trid ikollha tweġiba miktuba qabel il-varar, mhux wara l-ewwel inċident. Fl-aħħar nett, it-traċċar tal-ispejjeż: katina ta’ tliet aġenti tikkonsma tokens f’kull relè, u biss kontatur għal kull konversazzjoni jgħidlek jekk il-pipeline ta’ intelliġenza tiegħek jiswix ftit ċenteżmi jew ħafna aktar.

Punti Ewlenin

  • L-appoġġ għall-klijenti multi-livell huwa każ ta’ użu naturali għat-trasferimenti
  • Il-pipelines ta’ intelliġenza (iġbor → analizza → ikteb) jisfruttaw il-katina lineari
  • L-assistenti versatili jużaw router ċentrali lejn speċjalisti
  • Fil-produzzjoni: il-logging, it-timeouts, il-fallbacks u l-monitoraġġ tal-ispejjeż huma essenzjali
  • Aġent wieħed = responsabbiltà waħda, b’deskrizzjoni preċiża għar-routing