Għodda web_search: Tiftix fuq l-Internet f'Ħin Reali
F'din il-paġna
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_searchjagħti lill-aġent aċċess f’ħin reali għall-internet- Ir-risponsi jinkludu ċitazzjonijiet awtomatiċi (titlu + URL)
web_search_premiumiż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