As Duas Categorias de Ferramentas do Grok
Nesta página
Compreenda o Ecossistema de Ferramentas da API Grok
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.
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:
- Descreve as suas funções (nome, parâmetros, descrição) no pedido
- O modelo analisa o pedido do utilizador
- Se determinar que é necessária uma função, devolve uma chamada de função com argumentos
- O seu código executa a função (chamada de API, consulta à base de dados, cálculo…)
- Envia o resultado de volta ao modelo
- 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