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

As Duas Categorias de Ferramentas do Grok

Aula 1 de 16 Atualizada a 30 de julho de 2026 Programador
Nesta página
  1. Compreenda o Ecossistema de Ferramentas da API Grok
  2. Ferramentas Integradas — Lado do Servidor
  3. Chamada de Funções — Lado do Cliente
  4. Quando Utilizar Cada Categoria
  5. Pontos-chave

Compreenda o Ecossistema de Ferramentas da API Grok

Visão geral das ferramentas na documentação A API Grok faz mais do que gerar texto. Ela fornece um conjunto de ferramentas que permitem ao modelo interagir com o mundo exterior: pesquisar informações em tempo real, analisar dados nas redes sociais ou executar código Python. Para aproveitar estas capacidades, precisa de compreender como estão organizadas.

A API Grok distingue duas categorias fundamentais de ferramentas. Esta distinção determina quem executa a ferramenta, onde ocorre o processamento e o que precisa de gerir enquanto programador.

Ferramentas Integradas — Lado do Servidor

As ferramentas integradas são executadas diretamente nos servidores da xAI. Quando o modelo decide utilizar uma destas ferramentas, a execução é automática e transparente. Não precisa de gerir qualquer infraestrutura nem processar resultados intermédios.

🔍
Web Search
Real-time web search
𝕏
X Search
Search on X/Twitter
🐍
Code Execution
Isolated Python sandbox
📁
Collections Search
Search within your documents
🔌
Remote MCP
External MCP servers

Estas são as cinco ferramentas integradas disponíveis:

  • Web Search (web_search): Pesquisa na web em tempo real, com filtragem por domínio e citações automáticas
  • X Search (x_search): Pesquisa no X/Twitter, com filtragem por conta e data
  • Code Execution (code_interpreter / code_execution): Execução de código Python num ambiente isolado e seguro (sandbox)
  • Collections Search (collections_search / file_search): Pesquisa nos documentos que carregou anteriormente
  • Remote MCP (mcp): Ligação a servidores MCP (Model Context Protocol) externos

Para ativar uma ferramenta integrada, basta adicioná-la ao vetor tools no seu pedido:

{
  "tools": [{"type": "web_search"}]
}

Chamada de Funções — Lado do Cliente

A Chamada de Funções (Function Calling) funciona de forma diferente. Define funções personalizadas que o modelo pode chamar. Mas, ao contrário das ferramentas integradas, é o seu código do lado do cliente que executa a função e devolve o resultado ao modelo.

O fluxo é o seguinte:

  1. Descreve as suas funções (nome, parâmetros, descrição) no pedido
  2. O modelo analisa o pedido do utilizador
  3. Se determinar que é necessária uma função, devolve uma chamada de função com argumentos
  4. O seu código executa a função (chamada de API, consulta à base de dados, cálculo…)
  5. Envia o resultado de volta ao modelo
  6. O modelo formula a sua resposta final

Esta abordagem dá-lhe controlo total: decide o que as suas funções fazem, que dados tratam e como se ligam à sua infraestrutura.

Quando Utilizar Cada Categoria

As ferramentas integradas são ideais quando precisa de aceder a informações em tempo real (web, redes sociais) ou de efetuar cálculos sem gerir infraestrutura. A Chamada de Funções é preferível quando precisa de interagir com os seus próprios sistemas: bases de dados internas, APIs empresariais ou qualquer serviço específico da sua aplicação.

Pode combinar ambas as categorias num único pedido. Por exemplo, pode ativar a Pesquisa na Web enquanto define uma função personalizada que guarda os resultados na sua base de dados.

Pontos-chave

  • A API Grok oferece duas categorias de ferramentas: ferramentas integradas (executadas pela xAI) e Chamada de Funções (executadas pelo seu código)
  • As ferramentas integradas não requerem infraestrutura do lado do cliente
  • A Chamada de Funções oferece controlo total, mas exige mais desenvolvimento
  • Ambas as categorias podem ser combinadas num único pedido
  • Este curso foca-se nas três principais ferramentas integradas: Web Search, X Search e Code Execution