Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Agent z dostopom do spleta

Lekcija 6 od 18 Posodobljeno 2. november 2026 Razvijalec
Na tej strani
  1. Omogoči svojemu agentu dostop do spleta
  2. Ustvari agenta z dostopom do spleta
  3. Uporaba agenta
  4. Razumevanje strukture odgovora
  5. Kaj omogoča iskanje
  6. web_search proti web_search_premium
  7. Ključne ugotovitve

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 strani
  • url – 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

Vidikweb_searchweb_search_premium
IskalnikStandardno iskanjeNapredno iskanje
ViriSplošni spletPreverjeni ponudniki novic
StrošekVključenoDodatni strošek
UporabaSplošne informacijeZanesljive 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_search omogoča agentu iskanje po internetu v realnem času
  • Odgovori vključujejo citate z naslovom vira in URL-jem
  • web_search_premium ponuja 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