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

# Ferramenta de Chamada de API

> Como configurar e usar a ferramenta de chamada de API

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.

<img src="https://mintcdn.com/trebleai/89966LUoma77gDWQ/images/tom-api-tool-config.png?fit=max&auto=format&n=89966LUoma77gDWQ&q=85&s=1cd8e480d722d222111b83919b99a6c5" alt="Configuração da ferramenta de chamada de API" width="940" height="1446" data-path="images/tom-api-tool-config.png" />

<img src="https://mintcdn.com/trebleai/89966LUoma77gDWQ/images/tom-api-tool-preview.png?fit=max&auto=format&n=89966LUoma77gDWQ&q=85&s=c02d44e72fdd92e0686c2fcaf5182bb8" alt="Visualização da ferramenta de chamada de API" width="3456" height="1748" data-path="images/tom-api-tool-preview.png" />

* **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}}`.

<img src="https://mintcdn.com/trebleai/89966LUoma77gDWQ/images/tom-api-tool-variable-config.png?fit=max&auto=format&n=89966LUoma77gDWQ&q=85&s=f2ef6876e18302ce186514ca97fa703c" alt="Configuração de variáveis na ferramenta de chamada de API" width="914" height="1438" data-path="images/tom-api-tool-variable-config.png" />

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

<img src="https://mintcdn.com/trebleai/89966LUoma77gDWQ/images/tom-api-tool-variables-example.png?fit=max&auto=format&n=89966LUoma77gDWQ&q=85&s=ec0c461a047820d69b9e686e03739a97" alt="Exemplo da ferramenta de chamada de API com a ferramenta salvar variável" width="3456" height="1748" data-path="images/tom-api-tool-variables-example.png" />

Antes de habilitar a ferramenta em produção, teste o fluxo com dados reais para confirmar tempos, formatos e tratamento de erros.
