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

Instrumentul web_search: Căutare pe internet în timp real

Lecția 8 din 18 Actualizată 2 noiembrie 2026 Dezvoltator
Pe această pagină
  1. Cele patru instrumente integrate Mistral
  2. Detalierea căutării web
  3. Executarea unei căutări
  4. Anatomia răspunsului
  5. Utilizarea modului direct (fără un agent)
  6. Cele mai bune practici care fac diferența
  7. Puncte cheie

Cele patru instrumente integrate Mistral

Această lecție deschide secțiunea dedicată instrumentelor integrate. Înainte de a aprofunda primul instrument, acordați-vă un moment pentru a prezenta cele patru instrumente disponibile în API-ul Agents și nevoile pe care le acoperă.

Instrument Tip Descriere Caz de utilizare
Căutare web web_search Căutare pe internet în timp real Știri, monitorizare, verificarea faptelor
Interpretor de cod code_interpreter Executarea codului Python într-un mediu izolat (sandbox) Calcule, analiză de date, grafice
Generare de imagini image_generation Creare de imagini din text Ilustrații, machete, creație artistică
Bibliotecă de documente document_library RAG pe documente încărcate Întrebări și răspunsuri despre fișiere, extragere, rezumare

Aceste instrumente rulează în mediul cloud Mistral – nu trebuie să gestionați nicio infrastructură din partea dumneavoastră. Aceasta este o diferență fundamentală față de apelarea clasică de funcții, unde dumneavoastră gestionați execuția: aici, declarați o capacitate, iar furnizorul se ocupă de mediul izolat (sandbox), dependențe și scalabilitate.

Detalierea căutării web

Instrumentul web_search permite agentului dumneavoastră să caute informații pe internet în timp real. Este cel mai utilizat instrument deoarece rezolvă o problemă fundamentală a LLM-urilor: decalajul temporal față de realitate. Un model nu știe nimic despre evenimentele care au avut loc după antrenamentul său și nici măcar nu știe că nu știe – ceea ce duce la răspunsuri date cu încredere, dar bazate pe o viziune învechită asupra lumii.

Configurarea unui agent cu acest instrument necesită doar câteva linii de cod.

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="Web Search Agent",
    instructions="You perform web searches to answer questions. Always cite your sources.",
    tools=[{"type": "web_search"}],
    completion_args={"temperature": 0.3, "top_p": 0.95}
)

Executarea unei căutări

Interogați acest agent ca pe orice altul: decizia de a efectua o căutare aparține agentului.

response = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="Who won the most recent European Football Championship?"
)

În spatele acestui singur apel se ascunde un întreg lanț de evenimente. Agentul analizează mai întâi întrebarea pentru a determina dacă propriile sale cunoștințe sunt suficiente – aici, expresia „cel mai recent“ implică informații datate, deci nu sunt. Apoi, formulează o interogare de căutare optimizată, adesea diferită de fraza dumneavoastră, eliminând formulările conversaționale. Execută căutarea, apoi sintetizează rezultatele cu citările aferente. Nu controlați niciunul dintre acești pași, dar îi puteți vedea pe toți în răspuns.

Anatomia răspunsului

Răspunsul conține mai multe intrări secvențiale pe care trebuie să le parcurgeți în ordine.

for entry in response.outputs:
    print(f"--- {entry.type} ---")

    if entry.type == "tool.execution":
        # Detalii despre căutarea efectuată
        print(f"Tool: {entry.tool_name}")

    elif entry.type == "message.output":
        # Răspuns cu citări
        for chunk in entry.content:
            if chunk.type == "text":
                print(chunk.text)
            elif chunk.type == "tool_reference":
                print(f"[Source] {chunk.title} — {chunk.url}")

Veți vedea mai întâi o intrare tool.execution, care conține metadatele operațiunii, inclusiv interogarea reală trimisă motorului de căutare. Acesta este locul unde trebuie să vă uitați atunci când un răspuns pare hors-sujet, deoarece veți observa adesea că reformularea a deviat. Intrarea message.output conține apoi răspunsul sintetizat, împărțit în blocuri text și tool_reference – de aici bucla imbricată din codul de mai sus.

Utilizarea modului direct (fără un agent)

Instrumentul funcționează și fără un agent înregistrat, ceea ce este convenabil pentru testări rapide.

response = client.beta.conversations.start(
    model="mistral-large-latest",
    inputs=[{"role": "user", "content": "Latest news on Mistral AI"}],
    tools=[{"type": "web_search"}]
)

Cele mai bune practici care fac diferența

Începeți prin a pune întrebări precise. Agentul transformă întrebarea dumneavoastră într-o interogare de căutare: „spune-mi despre IA“ va genera rezultate generice, în timp ce „ce reglementări europene privind IA au fost adoptate în 2026?“ vizează imediat pagini utile. Această regulă se aplică și întrebărilor pe care le pun utilizatorii dumneavoastră: dacă interfața dumneavoastră permite cereri vagi, includeți un pas în instrucțiuni pentru reformulare sau întrebări de clarificare.

În al doilea rând, controlați temperatura. Pentru sarcini factuale, o valoare scăzută – între 0,2 și 0,4 – reduce halucinațiile în timpul sintetizării rezultatelor. Căutarea oferă materia primă, dar modelul este cel care redactează textul, și nimic nu îl împiedică să completeze golurile dacă i se oferă prea multă libertate.

În final, verificați sursele. Citările sunt automate, dar relevanța lor variază: o postare pe un forum și un text oficial arată similar într-o listă de referințe. În contexte critice, deschideți URL-urile returnate înainte de a adopta informația – și expuneți-le utilizatorilor dumneavoastră pentru a face la fel.

Puncte cheie

  • web_search oferă agentului acces în timp real la internet
  • Răspunsurile includ citări automate (titlu + URL)
  • web_search_premium adaugă surse de știri verificate
  • Instrumentul funcționează cu sau fără un agent (modul direct este posibil)
  • Se recomandă o temperatură scăzută pentru sarcinile factuale