Saltar al contenido principal
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. Configuración de la herramienta de llamada API Visualización de la herramienta de llamada API
  • 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}}. Configuración de variables en la herramienta de llamada API

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.
Ejemplo de la herramienta de llamada API con la herramienta de guardar variable Antes de habilitar la herramienta en producción, prueba el flujo con datos reales para confirmar tiempos, formatos y manejo de errores.