Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Agent koos veebiotsinguga

Õppetund 6 / 18 Värskendatud 2. november 2026 Arendajatele
Sellel lehel
  1. Anna oma agendile juurdepääs veebile
  2. Loo agent koos veebiotsinguga
  3. Kasuta agenti
  4. Mõista vastuse struktuuri
  5. Mida otsing võimaldab
  6. web_search vs. web_search_premium
  7. Peamised punktid

Anna oma agendile juurdepääs veebile

LLM-il, millel puudub internetiühendus, on ligipääs vaid oma treeningandmetele. Kui küsid sellelt eelmisel kuul vastu võetud regulatiivse teksti kohta, väidab see kas teadmatust või – mis veel hullem – vastab oma mällu salvestatud maailmapildi põhjal, märkimata, et teave on aegunud. Lubades oma agendil kasutada tööriista web_search, võimaldad sellel leida reaalajas teavet ja viidata allikatele, parandades nii vastuste ajakohasust kui ka kontrollitavust.

Loo agent koos veebiotsinguga

Aktiveerimine nõuab vaid ühte konfiguratsioonirida, kuid juhised määravad väljundi kvaliteedi. Allpool toodud näide rakendab ranget distsipliini: otsi süstemaatiliselt, viita URL-idele, märgi leidude kuupäev ja too välja allikatevahelised vastuolud.

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}
)

Viimane juhise on praktikas kõige väärtuslikum. Ilma selleta võib mudel kahe erineva arvu ees seistes valida ühe ja esitada oma sünteesi faktina. Madal temperatuur täiendab seda seadistust, vähendades tulemuste ümber sõnastamisel hallutsinatsioone.

Tööriist web_search annab juurdepääsu tavalisele otsingumootorile. Kontrollitud uudisteallikate kasutamiseks kasuta web_search_premium:

tools=[{"type": "web_search_premium"}]

Kasuta agenti

Väljakutse ei erine tööriistadeta agendi omast: sina ei käivita otsingut; agent otsustab ise, millal see vajalik on.

response = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="What are the latest developments in AI regulation in Europe?"
)

Mõista vastuse struktuuri

Muutus on kõige ilmsem vastuse lugemisel. Veebiotsinguga agent tagastab mitut tüüpi kirjeid. Kood, mis loeb lihtsalt esimest kirjet, kuvaks otsingu metaandmed oodatud teksti asemel.

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}")

Pane tähele sisestatud tsüklit: message.output sisu ei ole üksainus string, vaid fragmentide jada, kus vahelduvad tekstilõigud ja viited. Seega võib iga vastuse osa sisaldada objekte tool_reference, mis koosnevad kolmest väljast:

  • tool — Allikatööriista nimi (web_search)
  • title — Viidatud veebilehe pealkiri
  • url — Viite URL

See on suur eelis: sinu agent ei vasta lihtsalt, vaid tõestab oma väiteid kontrollitavate allikatega. Liideses muutuvad need väljad klõpsatavateks linkideks, mis asetatakse teksti õigesse kohta, võimaldades kasutajatel iga väite algallikani jälitada.

Mida otsing võimaldab

Alusta jälgimisest. Agent, mille juhised raamistavad väljundiformaati, muudab avatud küsimuse regulaarseks, võrreldavaks nädalasünteesiks.

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"
)

Järgmisena tuleb faktikontroll, kus juhised võtavad selge protseduuri kuju. Agent ei pea meetodit ise otsustama; meetod on ette kirjutatud, muutes väljundi ennustatavaks.

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"}]
)

Seeria lõpetab võrdlus: siin kannab küsimus ise otsustuskriteeriume. Mida täpsemalt sa tegelikud piirangud – tehnoloogia, maht – määratled, seda sihipärasemad on käivituvad otsingud.

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 vs. web_search_premium

Aspektweb_searchweb_search_premium
MootorTavaline otsingTäiustatud otsing
AllikadÜldine veebKontrollitud uudistepakkujad
HindKaasatudLisatasu
KasutusÜldine teaveUsaldusväärne uudisvoog

Enamiku kasutusjuhtude puhul piisab web_search-ist. Jäta web_search_premium rakendustele, kus allika usaldusväärsus on kriitiline (ajakirjandus, vastavus, regulatiivne jälgimine). Arutelu ei tohiks kõlada „milline variant on parim“, vaid „milline on kaheldava allika hind minu kontekstis“: sisemise uudisteülevaate puhul on see null; regulaatorile esitatava märkuse puhul mitte.

Peamised punktid

  • Tööriist web_search võimaldab agendil otsida internetist reaalajas
  • Vastused sisaldavad viiteid allika pealkirja ja URL-iga
  • web_search_premium pakub lisatasu eest kontrollitud uudisteallikaid
  • Faktiliste ülesannete puhul, mis hõlmavad otsingut, soovitatakse madalat temperatuuri (0,3)
  • Agent otsustab automaatselt, millal ja kuidas veebiotsingut kasutada