Salt la conținutul principal
Română— Alege o limbă
Meniu

Agent cu căutare pe web

Lecția 6 din 18 Actualizată 2 noiembrie 2026 Dezvoltator
Pe această pagină
  1. Oferiți agentului dumneavoastră acces la web
  2. Crearea unui agent cu căutare pe web
  3. Utilizarea agentului
  4. Înțelegerea structurii răspunsului
  5. Ce face posibilă căutarea
  6. web_search vs. web_search_premium
  7. Puncte cheie

Oferiți agentului dumneavoastră acces la web

Un LLM fără acces la internet este limitat la datele sale de antrenament. Dacă îl întrebați despre un text reglementator adoptat luna trecută, acesta fie va pretinde că nu știe, fie – și mai grav – va răspunde pe baza stării memorate a lumii, fără să semnaleze că informația este învechită. Prin activarea instrumentului web_search pentru agentul dumneavoastră, îi permiteți să găsească informații în timp real și să își citeze sursele, îmbunătățind astfel atât prospețimea, cât și verificabilitatea răspunsurilor sale.

Crearea unui agent cu căutare pe web

Activarea necesită o singură linie de configurare, dar instrucțiunile determină calitatea rezultatului. Exemplul de mai jos impune o disciplină strictă: căutați sistematic, citați URL-urile, datați constatările și semnalați contradicțiile dintre surse.

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

Ultima instrucțiune este cea mai valoroasă în practică. Fără ea, un model confruntat cu două cifre divergente ar putea să aleagă una dintre ele și să prezinte sinteza sa ca pe un fapt stabilit. O temperatură scăzută completează această configurare prin reducerea halucinațiilor la reformularea rezultatelor.

Instrumentul web_search oferă acces la un motor de căutare standard. Pentru surse de știri verificate, utilizați web_search_premium:

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

Utilizarea agentului

Apelul nu diferă de cel al unui agent fără instrumente: nu declanșați dumneavoastră căutarea; agentul decide când este necesară.

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

Înțelegerea structurii răspunsului

Modificarea este cel mai vizibilă la citirea răspunsului. Un agent cu căutare pe web returnează mai multe tipuri de intrări. Un cod care citește doar prima intrare ar afișa metadatele căutării în loc de textul așteptat.

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

Observați bucla imbricată: conținutul unui message.output nu este un singur șir de caractere, ci o secvență de fragmente, alternând porțiuni de text și referințe. Fiecare secțiune a răspunsului poate include astfel obiecte tool_reference care conțin trei câmpuri:

  • tool — Numele instrumentului sursă (web_search)
  • title — Titlul paginii web citate
  • url — URL-ul de referință

Acesta este un avantaj major: agentul dumneavoastră nu doar răspunde, ci își dovește afirmațiile prin surse verificabile. Într-o interfață, aceste câmpuri devin link-uri clicabile plasate la locul potrivit în text, permițând utilizatorilor să urmărească fiecare afirmație până la originea sa.

Ce face posibilă căutarea

Începeți cu monitorizarea. Un agent ale cărui instrucțiuni definesc formatul de ieșire transformă o întrebare deschisă într-o sinteză săptămânală regulată și comparabilă.

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

Verificarea faptelor vine apoi, cu instrucțiuni sub forma unei proceduri explicite. Agentul nu trebuie să decidă asupra unei metode; metoda este dictată, ceea ce face ca rezultatul să fie predictibil.

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

Comparația încheie seria: aici, întrebarea însăși poartă criteriile de decizie. Cu cât specificați mai multe constrângeri reale – tehnologie, volum – cu atât căutările declanșate vor fi mai țintite.

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

Aspectweb_searchweb_search_premium
EngineStandard searchAdvanced search
SourcesGeneral webVerified news providers
CostIncludedExtra cost
UsageGeneral informationReliable news

Pentru majoritatea cazurilor de utilizare, web_search este suficient. Rezervați web_search_premium pentru aplicațiile în care fiabilitatea sursei este critică (jurnalism, conformitate, monitorizare reglementară). Raționamentul nu ar trebui să fie „care opțiune este cea mai bună“, ci „care este costul unei surse dubioase în contextul meu“: pentru un rezumat intern de știri, acesta este zero; pentru o notă depusă unui organism de reglementare, nu este.

Puncte cheie

  • Instrumentul web_search permite agentului să caute pe internet în timp real
  • Răspunsurile includ citări cu titlul sursei și URL-ul acesteia
  • web_search_premium oferă surse de știri verificate contra unui cost suplimentar
  • Se recomandă o temperatură scăzută (0.3) pentru sarcinile factuale care implică căutarea
  • Agentul decide automat când și cum să utilizeze căutarea pe web