Saltar para o conteúdo principal
A ferramenta de chamada de API permite que o agente faça chamadas de API para serviços externos durante a execução. Use-a quando precisar enviar informações ou realizar ações no seu sistema. Configuração da ferramenta de chamada de API Visualização da ferramenta de chamada de API
  • Configure a URL completa com o protocolo https.
  • Defina o corpo que o agente deve enviar, se necessário. O corpo deve incluir todas as informações relevantes para que o serviço responda sem etapas adicionais.
  • Limite o tempo de resposta: o serviço deve responder em menos de 10 segundos ou a chamada será considerada falha.
  • Saídas sem processamento: o agente não transforma a resposta do serviço externo. O endpoint deve retornar uma resposta em JSON.

Uso de variáveis na chamada de API

A ferramenta de chamada de API permite utilizar variáveis dentro do contexto do agente nos headers, parâmetros de URL ou no corpo da requisição. Isso é útil para personalizar cada chamada com dados relevantes do usuário ou da conversa.

Como referenciar variáveis

As variáveis são inseridas usando chaves duplas, por exemplo: {{nome_variavel}}. Configuração de variáveis na ferramenta de chamada de API

Boas práticas

  • Verifique se as variáveis existem antes de usá-las: Garanta que o agente tenha coletado as informações necessárias antes de enviar a chamada.
  • Use nomes descritivos: Mantenha um padrão nos nomes das variáveis para evitar confusões ou erros de substituição.
Exemplo da ferramenta de chamada de API com a ferramenta salvar variável Antes de habilitar a ferramenta em produção, teste o fluxo com dados reais para confirmar tempos, formatos e tratamento de erros.