Agent s web pretraživanjem
Na ovoj stranici
Omogući svom agentu pristup webu
LLM bez pristupa internetu ograničen je na svoje podatke za obuku. Pitaš li ga o regulatornom tekstu donesenom prošlog mjeseca, ili će tvrditi da ne zna, ili – što je gore – odgovoriti na temelju svog zapamćenog stanja svijeta, a da ne upozori kako su informacije zastarjele. Aktiviranjem alata web_search na svom agentu omogućuješ mu pronalaženje informacija u stvarnom vremenu i citiranje izvora, čime poboljšavaš i svježinu i provjerljivost njegovih odgovora.
Stvori agenta s web pretraživanjem
Aktivacija zahtijeva samo jedan redak konfiguracije, no upute određuju kvalitetu izlaza. Primjer u nastavku nameće strogu disciplinu: sustavno pretražuj, citiraj URL-ove, datiraj nalaze i označi proturječnosti između izvora.
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}
)
Posljednja uputa u praksi je najvrjednija. Bez nje, model suočen s dvjema divergentnim brojčanim vrijednostima mogao bi odabrati jednu i svoju sintezu predstaviti kao utvrđenu činjenicu. Niska temperatura nadopunjuje ovu postavku smanjujući halucinacije prilikom reformuliranja rezultata.
Alat web_search osigurava pristup standardnom tražilicu. Za provjerene izvore vijesti koristi web_search_premium:
tools=[{"type": "web_search_premium"}]
Koristi agenta
Poziv se ne razlikuje od onoga za agenta bez alata: ti ne pokrećeš pretraživanje; agent sam odlučuje kada je to potrebno.
response = client.beta.conversations.start(
agent_id=agent.id,
inputs="What are the latest developments in AI regulation in Europe?"
)
Razumij strukturu odgovora
Promjena je najuočljivija pri čitanju odgovora. Agent s web pretraživanjem vraća nekoliko vrsta unosa. Kod koji jednostavno čita prvi unos prikazao bi metapodatke pretraživanja umjesto očekivanog teksta.
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}")
Obrati pažnju na ugniježđenu petlju: sadržaj message.output nije jedan niz znakova, već niz isječaka koji izmjenjuju tekstualne fragmente i reference. Svaki dio odgovora tako može uključivati objekte tool_reference koji sadrže tri polja:
tool– Naziv izvornog alata (web_search)title– Naslov citirane web straniceurl– Referentni URL
To je velika prednost: tvoj agent ne samo da odgovara, već i dokazuje svoje tvrdnje provjerljivim izvorima. U sučelju ta polja postaju klikabilne poveznice smještene na pravo mjesto u tekstu, omogućujući korisnicima da prate svaku tvrdnju do njezina izvora.
Što pretraživanje omogućuje
Započni s praćenjem. Agent čije upute definiraju format izlaza pretvara otvoreno pitanje u redovitu, usporedivu tjednu sintezu.
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"
)
Slijedi provjera činjenica, pri čemu upute poprimaju oblik eksplicitnog postupka. Agent ne mora odlučivati o metodi; metoda je diktirana, što izlaz čini predvidljivim.
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"}]
)
Usporedba zatvara niz: ovdje samo pitanje nosi kriterije odlučivanja. Što više specificiraš stvarna ograničenja – tehnologiju, obujam – to će pokrenuta pretraživanja biti ciljanija.
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 naspram web_search_premium
| Aspekt | web_search | web_search_premium |
|---|---|---|
| Tražilica | Standardna | Napredna |
| Izvori | Opći web | Provjereni pružatelji vijesti |
| Trošak | Uključeno | Dodatni trošak |
| Upotreba | Opće informacije | Pouzdane vijesti |
Za većinu slučajeva upotrebe web_search je dovoljan. Rezerviraj web_search_premium za aplikacije gdje je pouzdanost izvora ključna (novinarstvo, usklađenost, regulatorno praćenje). Razmišljanje ne bi trebalo biti „koja je opcija najbolja“, već „koliki je trošak sumnjivog izvora u mom kontekstu“: za interni sažetak vijesti on je nula; za bilješku podnesenu regulatoru, nije.
Ključne točke
- Alat
web_searchomogućuje agentu pretraživanje interneta u stvarnom vremenu - Odgovori uključuju citate s naslovom izvora i URL-om
web_search_premiumnudi provjerene izvore vijesti uz dodatni trošak- Niska temperatura (0.3) preporučuje se za činjenične zadatke koji uključuju pretraživanje
- Agent automatski odlučuje kada i kako koristiti web pretraživanje