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

# Herramienta de llamada a API

> Cómo configurar y usar la herramienta de llamado a API

La herramienta de llamada a API permite que el agente haga llamados API a servicios externos durante la ejecución. Úsala cuando necesites enviar información o realizar acciones en tu 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="Configuración de la herramienta de llamada 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="Visualización de la herramienta de llamada API" width="3456" height="1748" data-path="images/tom-api-tool-preview.png" />

* **Configura la URL** completa con protocolo https.
* **Define el cuerpo** que el agente debe enviar en caso de ser necesario. El cuerpo debe incluir toda la información relevante para que el servicio responda sin pasos adicionales.
* **Limita el tiempo de respuesta**: el servicio debe contestar en menos de 10 segundos o la llamada se considerará fallida.
* **Salidas sin procesamiento**: el agente no transforma la respuesta del servicio externo. El endpoint debe devolver una respuesta de tipo JSON.

## Uso de variables en la llamada a API

La herramienta de llamada a API te permite utilizar variables dentro del contexto del agente en los **encabezados**, los **parámetros de URL** o el **cuerpo** del request. Esto es útil para personalizar cada llamada con datos relevantes del usuario o de la conversación.

### Cómo referenciar variables

Las variables se insertan usando doble llave, por ejemplo: `{{nombre_variable}}`.

<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="Configuración de variables en la herramienta de llamada API" width="914" height="1438" data-path="images/tom-api-tool-variable-config.png" />

### Buenas prácticas

* **Verifica que las variables existan antes de usarlas:** Asegúrate de que el agente haya recolectado la información necesaria antes de enviar la llamada.
* **Usa nombres descriptivos:** Mantén un estándar en los nombres de variables para evitar confusiones o errores de reemplazo.

<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="Ejemplo de la herramienta de llamada API con la herramienta de guardar variable" width="3456" height="1748" data-path="images/tom-api-tool-variables-example.png" />

Antes de habilitar la herramienta en producción, prueba el flujo con datos reales para confirmar tiempos, formatos y manejo de errores.
