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.Documentation Index
Fetch the complete documentation index at: https://help.treble.ai/llms.txt
Use this file to discover all available pages before exploring further.
- 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}}.
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.
