Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Ferramentas Integradas para a API de Respostas

Aula 9 de 16 Atualizada a 30 de julho de 2026 Programador
Nesta página
  1. Adicionar Capacidades ao Modelo
  2. Os 4 Tipos de Ferramentas
  3. Combinar Várias Ferramentas
  4. Ferramentas no Lado do Servidor vs. Lado do Cliente
  5. Pontos-chave

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.

web_search
Pesquisa web em tempo real
x_search
Pesquisa no X
code
Interpretador Python
function
Funções personalizadas

Os 4 Tipos de Ferramentas

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.

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 function executam 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