Agent s vyhľadávaním na webe
Na tejto strane
Poskytni svojmu agentovi prístup na web
LLM bez prístupu na internet je obmedzený len na svoje trénovacie dáta. Ak sa ho opýtaš na regulačný text schválený minulý mesiac, buď tvrdí, že nič nevie, alebo – čo je horšie – odpovie na základe svojho zapamätaného stavu sveta bez toho, aby upozornil, že informácie sú zastarané. Povolením nástroja web_search pre svojho agenta mu umožníš nájsť informácie v reálnom čase a citovať ich zdroje, čím zlepšíš aktuálnosť aj overiteľnosť jeho odpovedí.
Vytvorenie agenta s vyhľadávaním na webe
Aktivácia si vyžaduje len jeden riadok konfigurácie, ale inštrukcie určujú kvalitu výstupu. Nasledujúci príklad presadzuje prísnu disciplínu: systematicky vyhľadávaj, cituj URL adresy, uvádzaj dátum zistení a označuj rozpory medzi zdrojmi.
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}
)
Posledná inštrukcia je v praxi najcennejšia. Bez nej by model konfrontovaný s dvoma odlišnými údajmi mohol jeden vybrať a svoju syntézu prezentovať ako overený fakt. Nízka teplota tento setup dopĺňa tým, že znižuje halucinácie pri preformulovávaní výsledkov.
Nástroj web_search poskytuje prístup k štandardnému vyhľadávaču. Pre overené spravodajské zdroje použij web_search_premium:
tools=[{"type": "web_search_premium"}]
Použitie agenta
Volanie sa nelíši od volania agenta bez nástrojov: vyhľadávanie nespúšťaš ty, agent sa sám rozhodne, kedy je potrebné.
response = client.beta.conversations.start(
agent_id=agent.id,
inputs="What are the latest developments in AI regulation in Europe?"
)
Pochopenie štruktúry odpovede
Zmena je najzrejmejšia pri čítaní odpovede. Agent s vyhľadávaním na webe vracia niekoľko typov záznamov. Kód, ktorý by jednoducho čítal prvý záznam, by zobrazil metadáta vyhľadávania namiesto očakávaného textu.
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}")
Všimni si vnorenú slučku: obsah message.output nie je jeden reťazec, ale sekvencia častí (chunkov), ktoré striedajú textové fragmenty a referencie. Každá časť odpovede tak môže obsahovať objekty tool_reference s tromi poľami:
tool– Názov zdrojového nástroja (web_search)title– Nadpis citovanej webovej stránkyurl– Referenčná URL adresa
To je veľká výhoda: tvoj agent nielen odpovedá, ale svoje tvrdenia dokazuje overiteľnými zdrojmi. V rozhraní sa tieto polia stanú klikateľnými odkazmi umiestnenými na správnom mieste v texte, čo používateľom umožní vysledovať každé tvrdenie až k jeho pôvodu.
Čo vyhľadávanie umožňuje
Začni monitorovaním. Agent, ktorého inštrukcie rámujú formát výstupu, premení otvorenú otázku na pravidelnú, porovnateľnú týždennú syntézu.
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"
)
Ďalej prichádza overovanie faktov, kde inštrukcie nadobúdajú formu explicitného postupu. Agent sa nemusí rozhodovať o metóde; metóda je daná, čo robí výstup predvídateľným.
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"}]
)
Sériu uzatvára porovnávanie: tu samotná otázka nesie rozhodovacie kritériá. Čím viac špecifikuješ skutočné obmedzenia – technológiu, objem – tým cielenšie budú spustené vyhľadávania.
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
| Aspekt | web_search | web_search_premium |
|---|---|---|
| Engine | Štandardné vyhľadávanie | Pokročilé vyhľadávanie |
| Zdroje | Všeobecný web | Overení poskytovatelia správ |
| Cena | Súčasť balíka | Dodatočný poplatok |
| Použitie | Všeobecné informácie | Spoľahlivé správy |
Pre väčšinu prípadov použitia stačí web_search. web_search_premium si vyhradź pre aplikácie, kde je kritická spoľahlivosť zdrojov (novinárstvo, compliance, regulačný monitoring). Úvaha by nemala znieť „ktorá možnosť je najlepšia“, ale „aká je cena pochybného zdroja v mojom kontexte“: pre interný súhrn správ je nulová; pre poznámku predloženú regulátorovi nie je.
Kľúčové poznatky
- Nástroj
web_searchumožňuje agentovi vyhľadávať na internete v reálnom čase - Odpovede zahŕňajú citácie s názvom zdroja a URL adresou
web_search_premiumponúka overené spravodajské zdroje za príplatok- Pre faktické úlohy zahŕňajúce vyhľadávanie sa odporúča nízka teplota (0,3)
- Agent sa automaticky rozhoduje, kedy a ako použiť vyhľadávanie na webe