Każijiet ta' Użu Multi-Aġent
F'din il-paġna
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