Cuando una herramienta no está en el catálogo, crea la tuya propia. Una integración personalizada es un conector HTTP definido por el usuario: estableces una URL base y un método de autenticación, luego describes una o más acciones que la IA y tus flujos de trabajo pueden llamar, cada una con su propio método, ruta, plantilla de cuerpo y mapeo de respuesta.
Abre Integraciones desde el panel de navegación y cambia a la pestaña Acciones personalizadas. Los administradores gestionan allí las integraciones personalizadas con un editor completo de contrato de acción; una vez guardadas, funcionan como cualquier otra herramienta conectada.
Cada integración personalizada comienza con una URL base (p. ej., https://api.acme.com/v1) y un método de conexión. Los secretos se almacenan cifrados, con alcance en tu organización, y nunca se devuelven en texto claro después de guardarlos.
| Método de autenticación | Cómo se envía |
|---|---|
Token de portadorbearer | Envía una cabecera Authorization: Bearer <token>. |
Clave de APIapi_key | Envía la clave en una cabecera que tú nombras (p. ej., X-Api-Key). |
Autenticación básicabasic | Codifica en Base64 un nombre de usuario y contraseña / secreto. |
Cuenta de servicioservice_account | Credencial de cuenta de servicio para acceso servidor a servidor. |
Ningunanone | Sin autenticación; para endpoints públicos o preautorizados. |
Cada acción es una llamada HTTP descrita de forma declarativa. El editor de contrato de acción captura todo lo que el ejecutor necesita para llamar a la API y dar forma a su respuesta:
| Parte de una acción | Para qué sirve |
|---|---|
| Método | GET, POST, PUT, PATCH o DELETE. |
| Ruta | Se añade a la URL base. Admite {{placeholders}} de las entradas de la acción. |
| Plantilla de cuerpo | Cuerpo de la solicitud con {{placeholders}} sustituidos desde las entradas de la acción (para métodos de escritura). |
| Mapeo de respuesta | Extrae campos de la respuesta JSON y los presenta en una forma de salida limpia y predecible. |
| Lectura / escritura | Marca la acción como solo lectura o como escritura (crear/actualizar/eliminar). |
| Requiere confirmación | Cuando está activado, la IA se detiene para pedir tu aprobación antes de ejecutar la acción en el chat. |
Dale un nombre y una descripción claros para que la IA sepa cuándo usarla.
Elige GET / POST / PUT / PATCH / DELETE y la ruta, usando {{placeholders}} para las entradas.
Para métodos de escritura, escribe una plantilla de cuerpo con {{placeholders}} que el ejecutor completa desde las entradas.
Extrae los campos que te interesan de la respuesta JSON a una forma de salida limpia.
Marca las acciones de crear/actualizar/eliminar como escrituras y decide si necesitan confirmación en el chat.
Para proteger tanto tus APIs como la plataforma, las acciones personalizadas tienen un límite de 10 llamadas por minuto y acción (ventana deslizante de un minuto). Las llamadas que superen ese límite se rechazan con un error hasta que la ventana se restablezca.
Marca una acción que crea, actualiza o elimina datos como escritura y activa requiere confirmación para que la IA pida tu aprobación antes de ejecutarla en el chat, con la misma compuerta de seguridad que usan las acciones de escritura estándar.
Una vez definida, una integración personalizada es accesible en cualquier lugar donde se pueda usar una herramienta:
# o invocándola como herramienta.Las integraciones personalizadas son la forma de conectar un servicio interno, un SaaS especializado o una API de socio. Define la acción y su contrato una vez, luego reutilízala en el chat y en los flujos de trabajo. Para los proveedores con un clic, consulta integraciones estándar.