Agent z dostopom do spleta
Na tej strani
Omogoči svojemu agentu dostop do spleta
LLM brez dostopa do interneta je omejen na svoje učne podatke. Če ga vprašaš za regulativno besedilo, sprejeto prejšnji mesec, bo bodisi trdil, da ne ve, ali – kar je še huje – odgovoril na podlagi svojega zapomnjenega stanja sveta, ne da bi opozoril, da so informacije zastarele. Z omogočitvijo orodja web_search na svojem agentu mu dovoliš, da najde informacije v realnem času in navede svoje vire, s čimer izboljša tako svežino kot preverljivost svojih odgovorov.
Ustvari agenta z dostopom do spleta
Aktivacija zahteva le eno vrstico konfiguracije, vendar navodila določajo kakovost izhoda. Spodnji primer uveljavlja strogo disciplino: sistematično iskanje, navajanje URL-jev, datiranje ugotovitev in označevanje nasprotij med viri.
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}
)
Zadnje navodilo je v praksi najbolj dragoceno. Brez njega bi model, soočen z dvema različnima številkama, morda izbral eno in svojo sintezo predstavil kot uveljavljeno dejstvo. Nizka temperatura dopolnjuje to nastavitev z zmanjševanjem halucinacij pri preoblikovanju rezultatov.
Orodje web_search zagotavlja dostop do standardnega iskalnika. Za preverjene novičarske vire uporabi web_search_premium:
tools=[{"type": "web_search_premium"}]
Uporaba agenta
Klic se ne razlikuje od klica agenta brez orodij: iskanja ne sprožiš ti, temveč se agent sam odloči, kdaj je to potrebno.
response = client.beta.conversations.start(
agent_id=agent.id,
inputs="What are the latest developments in AI regulation in Europe?"
)
Razumevanje strukture odgovora
Sprememba je najbolj očitna pri branju odgovora. Agent z dostopom do spleta vrne več vrst vnosov. Koda, ki bi preprosto prebrala prvi vnos, bi namesto pričakovanega besedila izpisala metapodatke iskanja.
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}")
Opazi gnezdeno zanko: vsebina message.output ni en sam niz, temveč zaporedje kosov, ki izmenjujejo besedilne fragmente in reference. Vsak del odgovora lahko tako vključuje predmete tool_reference, ki vsebujejo tri polja:
tool– Ime izvornega orodja (web_search)title– Naslov citirane spletne straniurl– Referenčni URL
To je velika prednost: tvoj agent ne le odgovarja, temveč svoje trditve dokazuje s preverljivimi viri. V vmesniku ta polja postanejo klikabilne povezave, postavljene na pravo mesto v besedilu, kar uporabnikom omogoča, da vsako trditev sledijo nazaj do njenega izvora.
Kaj omogoča iskanje
Začni z nadzorom. Agent, katerega navodila določajo format izhoda, spremeni odprto vprašanje v redno, primerljivo tedensko sintezo.
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"
)
Sledi preverjanje dejstev, pri čemer navodila prevzamejo obliko eksplicitnega postopka. Agentu ni treba odločati o metodi; metoda je narekovana, kar naredi izhod predvidljiv.
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"}]
)
Zapira serijo primerjava: tukaj samo vprašanje nosi merila za odločanje. Bolj ko določiš dejanske omejitve – tehnologija, obseg – bolj ciljno usmerjena bodo sprožena iskanja.
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 proti web_search_premium
| Vidik | web_search | web_search_premium |
|---|---|---|
| Iskalnik | Standardno iskanje | Napredno iskanje |
| Viri | Splošni splet | Preverjeni ponudniki novic |
| Strošek | Vključeno | Dodatni strošek |
| Uporaba | Splošne informacije | Zanesljive novice |
Za večino primerov uporabe je web_search zadosten. web_search_premium prihrani za aplikacije, kjer je zanesljivost virov ključna (novinarstvo, skladnost, regulativni nadzor). Razmišljanje ne sme biti „katera možnost je najboljša”, temveč „kakšni so stroški dvomljivega vira v mojem kontekstu”: za interni povzetek novic so ničelni, za dopis, predložen regulatorju, pa ne.
Ključne ugotovitve
- Orodje
web_searchomogoča agentu iskanje po internetu v realnem času - Odgovori vključujejo citate z naslovom vira in URL-jem
web_search_premiumponuja preverjene novičarske vire za dodatno plačilo- Za faktografske naloge, ki vključujejo iskanje, je priporočljiva nizka temperatura (0,3)
- Agent samodejno odloči, kdaj in kako uporabiti iskanje po spletu