Connect tools & data

Conexiones de API

Convierte cualquier API HTTP en una función que tu agente puede llamar durante la conversación: pega un comando cURL y el asistente crea la definición de la herramienta, los parámetros y la autenticación.

Las conexiones de API son funciones HTTP personalizadas que tus agentes pueden invocar durante una conversación: consultar un pedido, crear un ticket u obtener el estado de una cuenta desde tu propio backend. Defines el endpoint una vez en Conexiones → APIs (/dashboard/api-connections); los agentes que tengan la conexión adjunta podrán invocarla cuando la conversación lo requiera.

Hay dos formas de crear una: pegar algo que el asistente pueda analizar o configurar la conexión manualmente.

La vía rápida: pegar y analizar#

1. Haz clic en Nueva conexión de API

   El cuadro de diálogo se abre en el asistente. Pega un comando cURL de ejemplo, una especificación OpenAPI/Swagger, una exportación de Postman, una interfaz de TypeScript o un esquema Zod en el cuadro.

2. Haz clic en Analizar

   ThunderPhone infiere toda la conexión a partir de lo que pegaste: URL, método, encabezados y un esquema de parámetros derivado de los parámetros de consulta y el cuerpo de la solicitud que encontró. Los encabezados que pegaste, incluidos los de autenticación, se incorporan a la configuración del endpoint.

3. Confirma los campos resaltados

   La configuración inferida se abre con los campos estimados resaltados para que los revises. Ajusta los nombres, las descripciones y los tipos de parámetros para que el agente entienda cuándo y cómo invocar la función: la descripción es lo que lee el modelo.

4. Validar y guardar

   Al guardar, primero se ejecuta una solicitud de prueba en tiempo real contra tu endpoint. Si la solicitud falla, la conexión no se guarda: corrige la URL, los encabezados de autenticación o el cuerpo e inténtalo de nuevo. Si tiene éxito, la conexión se almacena con una insignia de Validado.

Si el asistente no puede encontrar una URL de solicitud en lo que pegaste, te lo indicará: incluye un endpoint http(s) completo e inténtalo de nuevo.

Configuración manual#

Haz clic en Configurar manualmente → en el asistente (o en ¿Quieres que la IA infiera esto? Prueba el asistente → para volver). El creador manual tiene dos editores:

• Visual: campos de formulario para el nombre visible, el nombre de la función, la URL de la solicitud, el método (POST, GET, PUT, PATCH, DELETE), los encabezados personalizados y el esquema de parámetros (Agregar propiedad para cada argumento que el agente pueda proporcionar).
• JSON: la misma definición como JSON sin procesar, para pegar o ajustar directamente una especificación de herramienta.

Un panel de Solicitud de prueba opcional te permite enviar la solicitud configurada antes de guardar y muestra el estado, la latencia y una vista previa de la respuesta. Validar y guardar siempre ejecuta esta prueba y solo guarda si tiene éxito.

Administra tus conexiones#

Cada fila de conexión muestra su estado de validación: Validado, Sin probar o Error; el nombre de su función y qué agentes la usan. Desde el menú de acciones de la fila puedes:

• Editar: volver a abrir la configuración.
• Clonar: duplicarla como punto de partida (la copia comienza Sin probar).
• Historial de revisiones: ver versiones anteriores y restaurar una en el editor.
• Transferir: copiar o mover la conexión a otra organización a la que pertenezcas. Al moverla, se elimina de aquí; es posible que los agentes que la usaban necesiten una reconfiguración.
• Eliminar: es permanente; los agentes que usan la conexión deberán reconfigurarse.

Adjuntarla a un agente#

Agrega la conexión a un agente en la sección de conexiones de API del creador (Crear un agente). La lista muestra qué agentes usan cada conexión, para que puedas ver de un vistazo a qué afecta un cambio.

Próximos pasos#