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

Compreender a chamada de funções

Aula 1 de 14 Atualizada a 29 de julho de 2026 Programador
Nesta página
  1. O que é a chamada de funções?
  2. O fluxo de 6 passos
  3. Porque é a chamada de funções tão importante?
  4. A diferença face a um prompt standard
  5. Limites a conhecer
  6. Pontos-chave

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.

1

Definir ferramentas

Descreve as suas funções com esquemas JSON: nome, descrição e parâmetros esperados.

2

Enviar o pedido

Envia a mensagem do utilizador juntamente com as definições das ferramentas para a API.

3

Receber o tool_call

O modelo devolve um objeto tool_call com o nome da função e os argumentos em JSON.

4

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...).

5

Devolver o resultado

Envia o resultado da execução de volta ao modelo numa mensagem com a função «tool».

6

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