Compreender a chamada de funções
Nesta página
O que é a chamada de funções?
A chamada de funções é uma das funcionalidades mais poderosas da API do Grok. Permite que o modelo solicite a execução de funções que você definiu, para obter dados ou realizar ações no mundo real.
Ponto fundamental a compreender: o Grok nunca executa as funções por si próprio. O modelo analisa o seu pedido, determina que necessita de informações externas e devolve-lhe uma chamada estruturada (nome da função + argumentos). É o seu código do lado do cliente que executa efetivamente a função e, em seguida, envia o resultado de volta ao modelo.
O fluxo de 6 passos
Cada interação de chamada de função segue um ciclo preciso de seis etapas. Este fluxo é fundamental — estrutura toda a sua arquitetura.
Definir ferramentas
Descreve as suas funções com esquemas JSON: nome, descrição e parâmetros esperados.
Enviar o pedido
Envia a mensagem do utilizador juntamente com as definições das ferramentas para a API.
Receber o tool_call
O modelo devolve um objeto tool_call com o nome da função e os argumentos em JSON.
Executar a função
O seu código do lado do cliente executa a função real (chamada de API, consulta à base de dados, cálculo...).
Devolver o resultado
Envia o resultado da execução de volta ao modelo numa mensagem com a função «tool».
Resposta final
O modelo integra o resultado e gera uma resposta em linguagem natural para o utilizador.
Porque é a chamada de funções tão importante?
Sem a chamada de funções, um modelo de linguagem fica limitado ao conhecimento adquirido durante o seu treino. Não consegue consultar uma base de dados, questionar uma API de terceiros nem realizar um cálculo em tempo real. A chamada de funções resolve este problema fundamental, conferindo ao modelo a capacidade de interagir com o mundo exterior de forma estruturada e controlada.
Eis alguns casos de uso concretos:
- Dados em tempo real: meteorologia, cotações bolsistas, estados de encomendas
- Ações empresariais: criar um ticket, enviar um e-mail, reservar um horário
- Cálculos precisos: operações matemáticas, conversões, agregações
- Bases de dados: pesquisa de produtos, histórico de clientes, inventário
A diferença face a um prompt standard
Numa troca standard, faz uma pergunta e o modelo responde diretamente. Com a chamada de funções, o modelo pode pausar a sua resposta para solicitar informações adicionais através de uma chamada de função. Esta capacidade de interromper o fluxo de geração é o que torna o mecanismo tão poderoso.
O modelo raciocina da seguinte forma: «Para responder a esta pergunta, preciso da meteorologia atual em Paris. Vou chamar a função get_weather com o parâmetro city: Paris.»
Limites a conhecer
A API do Grok aceita até 200 ferramentas por pedido. Isto é mais do que suficiente para a maioria dos casos de uso, mas tenha em mente que cada definição de ferramenta consome tokens de entrada. Quanto mais ferramentas declarar, mais caro se torna o pedido — e mais tempo demora o modelo a escolher a ferramenta correta.
Pontos-chave
- A chamada de funções permite que o modelo solicite a execução de funções, não as execute ele próprio
- O fluxo segue sempre 6 passos: definir, enviar, receber, executar, devolver, responder
- As funções são executadas do lado do cliente, no seu código
- Máximo de 200 ferramentas por pedido
- Cada definição de ferramenta consome tokens — seja seletivo