Uirlis web_search: Cuardach Idirlín Fíor-Ama
Ar an leathanach seo
Ceithre Uirlis Inbhunaithe Mistral
Tosaíonn an ceacht seo an t-alt ar uirlisí inbhunaithe. Sula dtéann tú i mbun oibre leis an gcéad cheann, tóg nóiméad chun súil a chaitheamh ar na ceithre uirlis atá ar fáil sa API Agents agus ar na riachtanais a fhreagraíonn siad dóibh.
| Uirlis | Cineál | Cur síos | Cás Úsáide |
|---|---|---|---|
| Cuardach Gréasáin | web_search | Cuardach idirlín fíor-ama | Nuacht, monatóireacht, fíric-seiceáil |
| Ateangaire Cóid | code_interpreter | Feidhmiú cód Python i mbosca gainimh | Ríomhaireachtaí, anailís sonraí, cairteacha |
| Giniúint Íomhánna | image_generation | Cruthú téacs-go-híomhá | Léaráidí, samhlacha, obair chruthaitheach |
| Leabharlann Doiciméad | document_library | RAG ar dhoiciméid uaslódáilte | Ceisteanna & Freagraí faoi Chomhaid, eastóscadh, achoimriú |
Ritheann na huirlisí seo i dtimpeallacht scamaill Mistral—níl aon bhonneagar le bainistiú agatsa. Is difríocht bhunúsach é seo ó ghlao feidhme clasaiceach, áit a ndéanann tusa an fhorghníomhú: anseo, dearann tú cumas, agus déileálann an soláthraí leis an mbosca gainimh, na spleáchais, agus an scálú.
Cuardach Gréasáin go Mion
Ligeann an uirlis web_search do d’ghníomhaire faisnéis a chuardach ar an idirlíon i bhfíor-am. Is í an uirlis is forleithne a úsáidtear toisc go réitíonn sí fadhb bhunúsach LLM: an bhearna ama leis an réaltacht. Níl a fhios ag an tsamhail faoi aon imeachtaí a tharla tar éis a hoiliúna, agus níl a fhios aici fiú nach bhfuil a fhios aici—rud a fhágann go dtugann sí freagraí muiníneacha bunaithe ar radharc dátaithe den domhan.
Ní ghlacann sé ach cúpla líne chun gníomhaire a chumrú leis an uirlis seo.
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}
)
Cuardach a Rith
Déanann tú ceist ar an ngníomhaire seo díreach mar a dhéanfá le haon cheann eile: is leis an ngníomhaire an cinneadh cuardach a dhéanamh.
response = client.beta.conversations.start(
agent_id=agent.id,
inputs="Who won the most recent European Football Championship?"
)
Taobh thiar den ghlao aonair seo tá slabhra iomlán imeachtaí. Déanann an gníomhaire an cheist a anailísiú ar dtús chun a fháil amach an bhfuil a chuid eolais féin leordhóthanach—anseo, ciallaíonn na focail “most recent” go bhfuil eolas dátaithe i gceist, mar sin níl sé. Ansin, cumraíonn sé ceist chuardaigh bharrfheabhsaithe, atá go minic difriúil ó do chuid abairtí, gan frásaíocht chomhráiteach. Déanann sé an cuardach, agus ansin déanann sé na torthaí a shintéisiú le luanna ceangailte. Níl smacht agat ar aon cheann de na céimeanna seo, ach is féidir leat iad go léir a fheiceáil sa fhreagra.
Anatamaíocht na Freagra
Tá roinnt iontrálacha seicheamhacha sa fhreagra ar gá duit dul tríothu in ord.
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}")
Feicfidh tú iontráil tool.execution ar dtús, a iompraíonn meiteashonraí na hoibríochta, lena n-áirítear an cheist iarbhír a seoladh chuig an inneall cuardaigh. Seo an áit le breathnú air nuair a bhíonn freagra dealraitheach as ábhar, toisc go bhfeicfidh tú go minic gur chlaon an athfhrásaíocht. Ansin iompraíonn an iontráil message.output an fhreagra shintéiseach, roinnte ina píosaí text agus tool_reference—sin fáth a bhfuil an lúb neadaithe sa chód thuas.
Mód Díreach a Úsáid (Gan Gníomhaire)
Oibríonn an uirlis freisin gan gníomhaire cláraithe, rud atá áisiúil le haghaidh tástála tapa.
response = client.beta.conversations.start(
model="mistral-large-latest",
inputs=[{"role": "user", "content": "Latest news on Mistral AI"}],
tools=[{"type": "web_search"}]
)
Dea-Chleachtais a Dhéanann an Difríocht
Tosaigh le ceisteanna cruinne a chur. Tiontaíonn an gníomhaire do cheist ina cheist chuardaigh: tabharfaidh “inis dom faoi IA” torthaí ginearálta, ach díreoidh “cé na rialacháin Eorpacha maidir le IA a glacadh in 2026?” láithreach ar leathanaigh inghníomhaithe. Baineann an riail seo freisin le ceisteanna a chuireann do chuid úsáideoirí: má cheadaíonn do chomhéadan iarratais doiléire, cuirimis céim isteach i do threoracha le haghaidh athfhrásaíochta nó ceisteanna soiléirithe.
Ina dhiaidh sin, rialaigh an teocht. Do thascanna fíriciúla, laghdaíonn luach íseal—idir 0.2 agus 0.4—hallúicináin le linn sintéis na dtorthaí. Soláthraíonn an cuardach an t-amhábhar, ach is é an tsamhail fós a dhéanann an scríbhneoireacht, agus ní chuireann aon rud bac uirthi bearnaí a líonadh má thugtar an iomarca saoirse di.
Ar deireadh, fíoraigh foinsí. Tá luanna uathoibríoch, ach athraíonn a n-ábharthacht: dealraíonn post fóraim agus téacs oifigiúil cosúil le chéile i liosta tagartha. I gcomhthéacsanna criticiúla, oscail na URLanna a filltear sula nglacann tú leis an eolas—agus nocht iad do d’úsáideoirí ionas gur féidir leo an rud céanna a dhéanamh.
Príomhphointí
- Tugann
web_searchrochtain fhíor-ama ar an idirlíon don ghníomhaire - Áirítear luanna uathoibríocha sna freagraí (teideal + URL)
- Cuireann
web_search_premiumfoinsí nuachta fíoraithe leis - Oibríonn an uirlis le gníomhaire nó gan é (tá an mód díreach indéanta)
- Moltar teocht íseal do thascanna fíriciúla