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

Aġent b'Tiftix fil-Web

Lezzjoni 6 / 18 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Agħti lill-Aġent Tiegħek Aċċess għall-Web
  2. Oħloq Aġent b’Tiftix fil-Web
  3. Uża l-Aġent
  4. Ifhem l-Istruttura tar-Rispons
  5. X’Jagħmel Possibbli t-Tiftix
  6. web_search vs. web_search_premium
  7. Punti Ewlenin

Agħti lill-Aġent Tiegħek Aċċess għall-Web

LLM mingħajr aċċess għall-internet huwa limitat għad-dejta tat-taħriġ tiegħu. Jekk tistaqsieh dwar test regolatorju approvat ix-xahar li għadda, jew jgħidlek li ma jafx, jew—agħar minn hekk—iweġibek ibbażat fuq l-istat memorizzat tad-dinja mingħajr ma jindika li l-informazzjoni hija antika. Billi tattivaw l-għodda web_search fuq l-aġent tiegħek, tippermettilu jsib informazzjoni f’ħin reali u jikkwota s-sorsi tiegħu, u b’hekk itejjeb kemm l-aġġornament kif ukoll il-verifikabbiltà tat-tweġibiet tiegħu.

Oħloq Aġent b’Tiftix fil-Web

L-attivazzjoni tieħu biss linja waħda ta’ konfigurazzjoni, iżda l-istruzzjonijiet jiddeterminaw il-kwalità tar-riżultat. L-eżempju hawn taħt jinfurza dixxiplina stretta: fittex b’mod sistematiku, ikkwota l-URLs, iddata s-sejbiet, u ssinnala kontradizzjonijiet bejn is-sorsi.

from mistralai.client import Mistral
import os

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

agent = client.beta.agents.create(
    model="mistral-medium-latest",
    name="News Agent",
    instructions="""You are a news analyst.
- Use web search for every question
- Always cite your sources with URLs
- Specify the date of the information found
- If results are contradictory, mention it""",
    tools=[{"type": "web_search"}],
    completion_args={"temperature": 0.3, "top_p": 0.95}
)

L-aħħar istruzzjoni hija l-aktar waħda prezzjuża fil-prattika. Mingħajrha, mudell li jiffaċċja żewġ figuri diverġenti jista’ jagħżel waħda u jippreżenta s-sinteżi tiegħu bħala fatt stabbilit. Temperatura baxxa tikkomplementa din il-konfigurazzjoni billi tnaqqas l-alluċinazzjonijiet meta terġa’ tifformula r-riżultati.

L-għodda web_search tipprovdi aċċess għal magna standard tat-tiftix. Għal sorsi tal-aħbarijiet ivverifikati, uża web_search_premium:

tools=[{"type": "web_search_premium"}]

Uża l-Aġent

Is-sejħa ma tinbidil xejn minn dik ta’ aġent mingħajr għodod: int ma ttriggerjax it-tiftix; l-aġent jiddeċiedi meta jkun meħtieġ.

response = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="What are the latest developments in AI regulation in Europe?"
)

Ifhem l-Istruttura tar-Rispons

Il-bidla hija l-aktar evidenti meta taqra r-rispons. Aġent b’tiftix fil-web jirritorna diversi tipi ta’ entrati. Kodiċi li sempliċiment jaqra l-ewwel entrata juru l-metadejta tat-tiftix minflok it-test mistenni.

for entry in response.outputs:
    if entry.type == "tool.execution":
        # Web search metadata
        print(f"Tool used: {entry.tool_name}")
        print(f"Search query: {entry.info}")

    elif entry.type == "message.output":
        # Agent response with citations
        for chunk in entry.content:
            if chunk.type == "text":
                print(chunk.text)
            elif chunk.type == "tool_reference":
                print(f"  Source: {chunk.title} — {chunk.url}")

Innota ċ-ċiklu mbejjat: il-kontenut ta’ message.output mhuwiex stringa waħda iżda sekwenza ta’ biċċiet, li jalternaw frammenti ta’ test u referenzi. Kull sezzjoni tar-rispons tista’ għalhekk tinkludi oġġetti tool_reference li fihom tliet oqsma:

  • tool — Isem l-għodda tas-sors (web_search)
  • title — Titlu tal-paġna web ikkwotata
  • url — URL tar-referenza

Dan huwa vantaġġ kbir: l-aġent tiegħek mhux biss iwieġeb; huwa jipprova l-affermazzjonijiet tiegħu b’sorsi verifikabbli. F’interfaċċa, dawn l-oqsma jsiru links li tista’ tikklikkjahom imqiegħda fil-post it-tajjeb fit-test, u jippermettu lill-utenti jsegwu kull affermazzjoni lura għall-oriġini tagħha.

X’Jagħmel Possibbli t-Tiftix

Ibda bil-monitoraġġ. Aġent li l-istruzzjonijiet tiegħu jifframjaw il-format tal-output ibiddel mistoqsija miftuħa f’sinteżi ġimgħanija regolari u komparabbli.

agent = client.beta.agents.create(
    model="mistral-large-latest",
    name="Tech Watch",
    instructions="Conduct technology monitoring. Summarize the 5 most important news items on the requested topic.",
    tools=[{"type": "web_search"}]
)

response = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="Monitoring on AI agents — last 2 weeks"
)

Il-verifika tal-fatti tiġi wara, b’istruzzjonijiet li jieħdu l-forma ta’ proċedura espliċita. L-aġent ma għandux bżonn jiddeċiedi dwar metodu; il-metodu huwa diktat, u jagħmel ir-riżultat prevedibbli.

agent = client.beta.agents.create(
    model="mistral-large-latest",
    name="Fact Checker",
    instructions="""Verify the following claims.
For each claim:
1. Search for reliable sources
2. Indicate if it is true, false, or partially true
3. Cite your sources""",
    tools=[{"type": "web_search"}]
)

Il-paragun jagħlaq is-serje: hawnhekk, il-mistoqsija nnifisha ġġorr il-kriterji tad-deċiżjoni. Aktar ma tispeċifika l-vinċoli attwali—teknoloġija, volum—aktar ikunu mmirati t-tiftixiet li jiġu attivati.

response = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="Compare cloud offerings from OVH, Scaleway, and AWS for hosting a Python application with 10K users/day."
)

web_search vs. web_search_premium

Aspettweb_searchweb_search_premium
MagnaTiftix standardTiftix avvanzat
SorsiWeb ġeneraliFornituri tal-aħbarijiet ivverifikati
KostInklużKost addizzjonali
UżuInformazzjoni ġeneraliAħbarijiet affidabbli

Għall-biċċa l-kbira tal-każijiet ta’ użu, web_search huwa biżżejjed. Irriżerva web_search_premium għal applikazzjonijiet fejn l-affidabbiltà tas-sors hija kritika (ġurnaliżmu, konformità, monitoraġġ regolatorju). Ir-raġunament m’għandux ikun “liema għażla hija l-aħjar” iżda “x’inhu l-kost ta’ sors dubjuż fil-kuntest tiegħi”: għal sommarju intern tal-aħbarijiet, huwa żero; għal nota sottomessa lil regolatur, mhux hekk.

Punti Ewlenin

  • L-għodda web_search tippermetti lill-aġent ifittex fl-internet f’ħin reali
  • Ir-risponsi jinkludu ċitazzjonijiet bit-titlu tas-sors u l-URL
  • web_search_premium joffri sorsi tal-aħbarijiet ivverifikati b’kost addizzjonali
  • Temperatura baxxa (0.3) hija rrakkomandata għal kompiti fattwali li jinvolvu t-tiftix
  • L-aġent jiddeċiedi awtomatikament meta u kif juża t-tiftix fil-web