Ferramentas integradas: web_search, x_search e outras
Nesta página
- Ferramentas que servem os agentes
- web_search, o motor da investigação paralela
- x_search, a ferramenta que os outros não têm
- code_execution, quando precisa de calcular em vez de ler
- collections_search, os seus documentos no ciclo
- Remote MCP, uma porta para os seus próprios sistemas
- Fazer as ferramentas trabalharem em conjunto
- Pontos-chave
Ferramentas que servem os agentes
Uma equipa de agentes sem ferramentas fica confinada ao que o modelo memorizou durante o treino. Todo o valor do trabalho multiagente revela-se quando esses agentes vão buscar informação no momento em que coloca a questão: a paralelização só ajuda se existirem vários caminhos a explorar simultaneamente. O Grok fornece-lhes cinco ferramentas integradas, e cada agente decide autonomamente quais utilizar.
web_search, o motor da investigação paralela
A pesquisa na Web é a ferramenta dominante no trabalho multiagente, aquela que irá ativar em quase todos os seus pedidos.
from xai_sdk.tools import web_search
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=4,
tools=[web_search()],
)
O que muda aqui em comparação com um modelo único é que cada agente executa as suas próprias consultas. Numa questão como “qual a solução de cópia de segurança que devemos escolher para a nossa frota de servidores”, um agente investiga especificações técnicas, outro analisa preços e um terceiro recolhe opiniões de utilizadores em fóruns especializados. Com 16 agentes, a cobertura da Web não tem comparação com o que uma pesquisa sequencial executada por um único modelo consegue alcançar.
x_search, a ferramenta que os outros não têm
A pesquisa no X, antigamente Twitter, é específica do Grok e dá acesso a publicações, discussões e tendências na plataforma em tempo real.
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()],
)
O seu valor reside num desfasamento temporal: quando uma empresa anuncia um produto, as reações surgem no X numa hora, enquanto os artigos de fundo levam vários dias. Encontra a reação imediata a um anúncio, as posições de especialistas que nunca escreverão um artigo completo, tópicos em alta e discussões técnicas em comunidades de programadores. Num tema em rápida evolução, a combinação de web_search + x_search produz uma imagem que nenhum dos dois conseguiria fornecer isoladamente.
code_execution, quando precisa de calcular em vez de ler
A execução de código permite a um agente escrever e executar Python para analisar dados, realizar cálculos ou produzir visualizações.
from xai_sdk.tools import code_execution
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=4,
tools=[code_execution()],
)
O cenário típico: um agente recupera um ficheiro CSV encontrado durante a sua pesquisa, carrega-o, extrai estatísticas e transmite números verificados ao agente principal, em vez de uma impressão baseada na leitura. Parte do trabalho passa assim da interpretação para o cálculo, o que é crucial assim que a questão envolve ordens de grandeza.
collections_search, os seus documentos no ciclo
Esta ferramenta permite aos agentes consultar as coleções de documentos que indexou na 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()],
)
É o equivalente a um RAG integrado: os agentes pesquisam nos seus próprios documentos em paralelo com a Web, o que lhe permite cruzar documentação interna com condições de mercado sem precisar de construir o pipeline de recuperação.
Remote MCP, uma porta para os seus próprios sistemas
As ferramentas Remote MCP estendem as capacidades dos agentes com serviços externos que controla. Se expuser servidores MCP, os agentes utilizam-nos durante a sua investigação exatamente como ferramentas nativas: consultar uma base de dados interna, chamar uma API de negócio ou aceder a um sistema de gestão documental. Este é o mecanismo de extensão oficial e verá na próxima lição que é também a resposta a uma limitação importante do trabalho multiagente.
Fazer as ferramentas trabalharem em conjunto
O ganho real surge quando várias ferramentas estão disponíveis simultaneamente, porque a divisão entre agentes se torna também uma divisão entre fontes.
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"
))
Alguns agentes analisam então a imprensa, outro grupo examina publicações no X e um terceiro agrega os números através de código. Tenha em mente o efeito multiplicador: cada ferramenta que disponibiliza a dezasseis agentes alarga a cobertura e aumenta a fatura correspondentemente. Ative apenas o que a questão exige, não tudo por defeito.
Pontos-chave
- Cinco ferramentas integradas:
web_search,x_search,code_execution,collections_search, Remote MCP - Cada agente pode utilizar qualquer ferramenta independentemente dos outros
x_searché exclusivo do Grok — acesso em tempo real a publicações no X- Combine ferramentas para uma investigação mais completa
- Mais agentes + mais ferramentas = maior cobertura, mas maior consumo de tokens