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

Għodda web_search: Tiftix fuq l-Internet f'Ħin Reali

Lezzjoni 8 / 18 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. L-Erba’ Għodod Integrati ta’ Mistral
  2. Id-Dettalji tat-Tiftix fuq il-Web
  3. Twettiq ta’ Tiftix
  4. L-Anatomija tar-Rispons
  5. Użu tal-Modalità Diretta (Mingħajr Aġent)
  6. L-Aħjar Prattiki li Jagħmlu d-Differenza
  7. Punti Ewlenin

L-Erba’ Għodod Integrati ta’ Mistral

Din il-lezzjoni tiftaħ is-sezzjoni dwar l-għodod integrati. Qabel ma tidħol fl-ewwel waħda, ħu minuta biex tgħarraf l-erba’ għodod disponibbli fl-API tal-Aġenti u l-ħtiġijiet li jissodisfaw.

Għodda Tip Deskrizzjoni Każ ta' Użu
Tiftix fuq il-Web web_search Tiftix fuq l-internet f'ħin reali Aħbarijiet, monitoraġġ, verifika tal-fatti
Interpretatur tal-Kodiċi code_interpreter Eżekuzzjoni ta' kodiċi Python f'ambjent iżolat (sandbox) Kalkoli, analiżi tad-data, grafiċi
Ġenerazzjoni ta' Immaġni image_generation Ħolqien ta' immaġni minn test Illustrazzjonijiet, mockups, xogħol kreattiv
Librerija tad-Dokumenti document_library RAG fuq dokumenti mibgħuta Mistoqsijiet u tweġibiet dwar fajls, estrazzjoni, sommarju

Dawn l-għodod jaħdmu fl-ambjent cloud ta’ Mistral—m’hemm l-ebda infrastruttura li għandek timmaniġġja int. Din hija differenza fundamentali mis-sejħa klassika tal-funzjonijiet (function calling), fejn int tittratta l-eżekuzzjoni: hawnhekk, inti tiddikjara kapaċità, u l-fornitur jittratta s-sandbox, id-dipendenzi u l-iskalar.

Id-Dettalji tat-Tiftix fuq il-Web

L-għodda web_search tippermetti lill-aġent tiegħek ifittex informazzjoni fuq l-internet f’ħin reali. Hija l-aktar għodda użata ħafna għax issolvi problema fundamentali tal-LLM: id-divarju temporali mar-realtà. Mudell ma jaf xejn dwar avvenimenti li seħħew wara t-taħriġ tiegħu, u anqas ma jaf li ma jafx—li jwassal għal tweġibiet kunfidenti bbażati fuq viżjoni antika tad-dinja.

Il-konfigurazzjoni ta’ aġent b’din l-għodda tieħu biss ftit linji.

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="Web Search Agent",
    instructions="You perform web searches to answer questions. Always cite your sources.",
    tools=[{"type": "web_search"}],
    completion_args={"temperature": 0.3, "top_p": 0.95}
)

Twettiq ta’ Tiftix

Tistaqsi lil dan l-aġent bħal kwalunkwe ieħor: id-deċiżjoni li jsir tiftix tappartjeni lill-aġent.

response = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="Who won the most recent European Football Championship?"
)

Wara din is-sejħa waħda hemm katina sħiħa ta’ avvenimenti. L-aġent l-ewwel janalizza l-mistoqsija biex jiddetermina jekk l-għarfien tiegħu stess huwiex suffiċjenti—hawnhekk, il-kelma “l-aktar riċenti” tissuġġerixxi informazzjoni datata, allura mhix. Imbagħad ifformola mistoqsija ta’ tiftix ottimizzata, spiss differenti mis-sentenza tiegħek, imneħħija minn frażijiet konversazzjonali. Iwettaq it-tiftix, imbagħad jissintetizza r-riżultati b’ċitazzjonijiet mehmuża. Int ma tikkontrollax dawn il-passi, iżda tista’ tarahom kollha fir-rispons.

L-Anatomija tar-Rispons

Ir-rispons fih diversi entrati sekwenzi li trid tgħaddi minnhom f’ordni.

for entry in response.outputs:
    print(f"--- {entry.type} ---")

    if entry.type == "tool.execution":
        # Details of the search performed
        print(f"Tool: {entry.tool_name}")

    elif entry.type == "message.output":
        # 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}")

L-ewwel se tara entrata tool.execution, li ġġorr il-metadejta tal-operazzjoni, inkluża l-mistoqsija attwali mibgħuta lill-magna tat-tiftix. Dan huwa l-post fejn tħares meta tweġiba tidher barra mit-tema, peress li spiss se tara li l- riformulazzjoni ddevjat. L-entrata message.output imbagħad iġġib ir-rispons sintetizzat, maqsum f’biċċiet text u tool_reference—għalhekk iċ-ċiklu nested fil-kodiċi hawn fuq.

Użu tal-Modalità Diretta (Mingħajr Aġent)

L-għodda taħdem ukoll mingħajr aġent irreġistrat, li huwa konvenjenti għal testijiet mgħaġġla.

response = client.beta.conversations.start(
    model="mistral-large-latest",
    inputs=[{"role": "user", "content": "Latest news on Mistral AI"}],
    tools=[{"type": "web_search"}]
)

L-Aħjar Prattiki li Jagħmlu d-Differenza

Ibda billi tagħmel mistoqsijiet preċiżi. L-aġent jittrasforma l-mistoqsija tiegħek f’mistoqsija ta’ tiftix: “għidli dwar l-AI” se jipproduċi riżultati ġeneriċi, filwaqt li “liema regolamenti Ewropej dwar l-AI ġew adottati fl-2026?” jimmira immedjatament lejn paġni azzjonabbli. Din ir-regola tapplika wkoll għall-mistoqsijiet li l-utenti tiegħek jagħmlu: jekk l-interfaċċja tiegħek tippermetti talbiet vagi, inkludi pass fl-istruzzjonijiet tiegħek għar-riformulazzjoni jew mistoqsijiet ta’ ċċariment.

Sussegwentement, ikkontrolla t-temperatura. Għal kompiti fattwali, valur baxx—bejn 0.2 u 0.4—inaqqas l-alluċinazzjonijiet waqt is-sintesi tar-riżultati. It-tiftix jipprovdi l-materja prima, iżda l-mudell għadu jikteb, u xejn ma jwaqqfu milli jimla lakuni jekk jingħata wisq libertà.

Fl-aħħar nett, ivverifika s-sorsi. Iċ-ċitazzjonijiet huma awtomatiċi, iżda r-rilevanza tagħhom tvarja: post fuq forum u test uffiċjali jidhru simili f’lista ta’ referenzi. F’kuntesti kritiċi, iftaħ l-URLs irritornati qabel ma tadotta l-informazzjoni—u esponihom lill-utenti tiegħek biex ikunu jistgħu jagħmlu l-istess.

Punti Ewlenin

  • web_search jagħti lill-aġent aċċess f’ħin reali għall-internet
  • Ir-risponsi jinkludu ċitazzjonijiet awtomatiċi (titlu + URL)
  • web_search_premium iżid sorsi tal-aħbarijiet ivverifikati
  • L-għodda taħdem bi jew mingħajr aġent (il-modalità diretta hija possibbli)
  • Temperatura baxxa hija rrakkomandata għal kompiti fattwali