Ferramentas Integradas para a API de Respostas
Nesta página
Adicionar Capacidades ao Modelo
Os modelos Grok não se limitam à geração de texto. Ao utilizar o parâmetro tools, pode conceder-lhes acesso a ferramentas que expandem significativamente as suas capacidades: pesquisa web em tempo real, pesquisa no X (antigo Twitter), execução de código Python e as suas próprias funções personalizadas.
Os 4 Tipos de Ferramentas
web_search
Permite ao modelo procurar informações na web em tempo real:
{
"model": "grok-4.20-0309-reasoning",
"input": "What's the latest news on AI in Europe?",
"tools": [{"type": "web_search"}]
}
O modelo decide automaticamente quando realizar uma pesquisa. Os resultados são integrados na sua resposta com as respetivas citações.
x_search
Procura publicações no X (antigo Twitter):
{
"model": "grok-4.20-0309-reasoning",
"input": "What is the tech community saying about the latest iPhone?",
"tools": [{"type": "x_search"}]
}
Particularmente útil para captar a opinião pública, tendências e reações em tempo real.
code_interpreter
Executa código Python no lado do servidor para cálculos, análise de dados ou criação de gráficos:
{
"model": "grok-4.20-0309-reasoning",
"input": "Calculate the mean and standard deviation of these values: 12, 15, 18, 22, 9, 31",
"tools": [{"type": "code_interpreter"}]
}
O modelo escreve código Python, executa-o nos servidores da xAI e integra os resultados na sua resposta.
function
As suas próprias funções que o modelo pode invocar. O modelo gera os argumentos, mas o seu código executa a função:
{
"model": "grok-4.20-0309-reasoning",
"input": "What's the weather in Paris?",
"tools": [{
"type": "function",
"name": "get_weather",
"description": "Retrieves the weather for a given city",
"parameters": {
"type": "object",
"properties": {
"city": {"type": "string", "description": "City name"},
"unit": {"type": "string", "enum": ["celsius", "fahrenheit"]}
},
"required": ["city"]
}
}]
}
Combinar Várias Ferramentas
Pode incluir até 128 ferramentas num único pedido. O modelo escolhe aquela (ou aquelas) que melhor se adequam:
{
"model": "grok-4.20-0309-reasoning",
"input": "Search for the latest Ligue 1 results and create a scoreboard.",
"tools": [
{"type": "web_search"},
{"type": "code_interpreter"}
]
}
Neste exemplo, o modelo pode primeiro utilizar web_search para encontrar os resultados e, em seguida, code_interpreter para os formatar numa tabela.
Ferramentas no Lado do Servidor vs. Lado do Cliente
A distinção é fundamental:
-
Ferramentas no lado do servidor (
web_search,x_search,code_interpreter): Executadas automaticamente pelos servidores da xAI. Não precisa de fazer nada; o modelo inicia a pesquisa ou o código, recupera o resultado e integra-o na sua resposta. -
Ferramentas no lado do cliente (
function): O modelo gera uma chamada de função com argumentos e, em seguida, pausa a geração. O seu código executa a função e você envia o resultado de volta num novo pedido.
Esta diferença impacta diretamente a arquitetura da sua aplicação, como verá nas próximas lições.
Pontos-chave
- Quatro tipos de ferramentas:
web_search,x_search,code_interpreter,function - As três primeiras executam no lado do servidor — não requerem infraestrutura da sua parte
- As ferramentas
functionexecutam no lado do cliente — o seu código gere a execução - Pode combinar até 128 ferramentas por pedido
- O modelo decide automaticamente quando e quais ferramentas utilizar