Strumenti integrati: web_search, x_search e altri
In questa pagina
- Strumenti al servizio degli agenti
- web_search, il motore della ricerca parallela
- x_search, lo strumento che gli altri non hanno
- code_execution, quando devi calcolare invece di leggere
- collections_search, i tuoi documenti nel ciclo
- Remote MCP, una porta verso i tuoi sistemi
- Far lavorare insieme gli strumenti
- Punti chiave
Strumenti al servizio degli agenti
Un team di agenti privo di strumenti rimane bloccato dentro ciò che il modello ha memorizzato durante l’addestramento. L’intero valore del lavoro multi-agente emerge quando quegli agenti vanno a cercare informazioni nel momento esatto in cui poni la domanda: la parallelizzazione aiuta solo se ci sono diversi percorsi da esplorare simultaneamente. Grok mette a loro disposizione cinque strumenti integrati e ogni agente decide autonomamente quali utilizzare.
web_search, il motore della ricerca parallela
La ricerca web è lo strumento dominante nel lavoro multi-agente, quello che abiliterai in quasi tutte le tue richieste.
from xai_sdk.tools import web_search
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=4,
tools=[web_search()],
)
Ciò che cambia qui rispetto a un singolo modello è che ogni agente esegue le proprie query. Su una domanda come “quale soluzione di backup dovremmo scegliere per la nostra flotta di server”, un agente approfondirà le specifiche tecniche, un altro i prezzi e un terzo i feedback degli utenti su forum specializzati. Con 16 agenti, la copertura del web non ha nulla a che vedere con ciò che una ricerca sequenziale eseguita da un singolo modello può raggiungere.
x_search, lo strumento che gli altri non hanno
La ricerca su X, ex Twitter, è specifica di Grok e dà accesso in tempo reale a post, discussioni e trend sulla piattaforma.
from xai_sdk.tools import web_search, x_search
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=4,
tools=[web_search(), x_search()],
)
Il suo valore deriva da un divario temporale: quando un’azienda annuncia un prodotto, le reazioni appaiono su X entro un’ora, mentre gli articoli approfonditi richiedono diversi giorni. Trovi la reazione immediata a un annuncio, le posizioni di esperti che non scriveranno mai un articolo completo, gli argomenti di tendenza e le discussioni tecniche nelle comunità di sviluppatori. Su un tema in rapida evoluzione, la combinazione di web_search + x_search produce un quadro che nessuno dei due potrebbe offrire da solo.
code_execution, quando devi calcolare invece di leggere
L’esecuzione del codice permette a un agente di scrivere ed eseguire Python per analizzare dati, effettuare calcoli o produrre visualizzazioni.
from xai_sdk.tools import code_execution
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=4,
tools=[code_execution()],
)
Lo scenario tipico: un agente recupera un file CSV trovato durante la sua ricerca, lo carica, ne deriva statistiche e passa numeri verificati all’agente principale invece di un’impressione basata sulla lettura. Parte del lavoro si sposta così dall’interpretazione al calcolo, cosa fondamentale non appena la domanda coinvolge ordini di grandezza.
collections_search, i tuoi documenti nel ciclo
Questo strumento permette agli agenti di interrogare le collezioni di documenti che hai indicizzato su xAI.
from xai_sdk.tools import collections_search
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=4,
tools=[collections_search()],
)
È l’equivalente di un RAG integrato: gli agenti cercano nei tuoi documenti alongside al web, il che ti permette di incrociare la documentazione interna con le condizioni di mercato senza dover costruire tu stesso la pipeline di recupero.
Remote MCP, una porta verso i tuoi sistemi
Gli strumenti Remote MCP estendono le capacità degli agenti con servizi esterni che controlli. Se esponi server MCP, gli agenti li usano durante le loro ricerche esattamente come strumenti nativi: interrogando un database interno, chiamando un’API aziendale, raggiungendo un sistema di gestione documentale. Questo è il meccanismo di estensione ufficiale e vedrai nella prossima lezione che rappresenta anche la risposta a un’importante limitazione del lavoro multi-agente.
Far lavorare insieme gli strumenti
Il vero guadagno appare quando diversi strumenti sono disponibili contemporaneamente, perché la divisione tra agenti diventa anche una divisione tra fonti.
from xai_sdk.tools import web_search, x_search, code_execution
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=16,
tools=[web_search(), x_search(), code_execution()],
include=["verbose_streaming"],
)
chat.append(user(
"Analyze sentiment around NVIDIA's GPU announcements this week: "
"press articles, reactions on X, and summarize the key figures"
))
Alcuni agenti esaminano allora la stampa, un altro gruppo analizza i post su X e un terzo aggrega i numeri tramite codice. Tieni presente l’effetto moltiplicatore: ogni strumento che apri a sedici agenti amplia la copertura e aumenta di conseguenza il costo. Abilita ciò di cui la domanda ha bisogno, non tutto per impostazione predefinita.
Punti chiave
- Cinque strumenti integrati:
web_search,x_search,code_execution,collections_search, Remote MCP - Ogni agente può usare qualsiasi strumento indipendentemente dagli altri
x_searchè esclusivo di Grok — accesso in tempo reale ai post su X- Combina gli strumenti per ricerche più complete
- Più agenti + più strumenti = copertura più ampia ma consumo di token più elevato