Integraciones personalizadas

Cuándo usar esto

El catálogo integrado cubre 90 servicios (ver la Guía de integraciones). Para cualquier otra cosa, una API interna, un proveedor de nicho, un proveedor que nadie ha construido todavía, define una integración personalizada en lugar de esperar a que se lance una. Activa la función para tu organización desde Configuración → Integraciones personalizadas; está desactivada por defecto.

Importar desde un comando curl

El camino más rápido: pega un comando curl funcional directamente desde la propia documentación del proveedor. El asistente detecta la forma de autenticación, las cabeceras y la URL base por ti, así que lo revisas en lugar de volver a escribirlo.

Construirla a mano

• Básicos: un ID, un nombre visible, una categoría, una descripción, y las capacidades que declara, para que un agente pueda razonar sobre cuándo recurrir a ella.
• Autenticación: una clave de API (como token Bearer, cabecera personalizada, parámetro de consulta, o HTTP Basic) u OAuth 2.0, incluido PKCE para proveedores que lo exigen (estilo Twitter/X) y parámetros de autorización adicionales para proveedores que condicionan los tokens de actualización (el access_type=offline de Google, el duration=permanent de Reddit).
• Campos: las credenciales que aporta el miembro que se conecta. Cada campo se cifra en reposo por defecto; marcar uno como no secreto (un ID de cuenta o una región en texto plano, por ejemplo) solo se permite para campos que claramente no son una credencial. Un campo con un nombre como token, secret, key, password o credential queda bloqueado para esa clasificación salvo anulación explícita.
• Hosts de API: los nombres de host a los que esta integración puede llegar, con comodines admitidos, el mismo modelo de salida que cada integración integrada.
• Verificación: un endpoint que se consulta en el momento de conectar, para confirmar que las credenciales de un miembro realmente funcionan antes de que la integración se considere conectada.

Borradores y publicación

Una nueva integración se guarda como borrador, invisible para cualquier agente, hasta que la publicas. Publicar es lo que hace que aparezca bajo Configuración → Integraciones para que los miembros conecten sus propias credenciales, y lo que da acceso a los agentes vinculados. Despublicarla la oculta de nuevo sin eliminar nada: las credenciales cifradas ya conectadas se conservan, así que volver a publicarla restaura el acceso en lugar de empezar de cero.

Las mismas garantías de seguridad

Una integración personalizada hereda todo lo que obtiene una integrada: credenciales cifradas por fila, el intermediario de credenciales, la lista de permitidos de salida, la vinculación por agente, y el mismo registro de auditoría. Definir tu propia integración no significa salir del modelo de seguridad de la plataforma, significa extenderlo a un servicio más.

Relacionado

• Guía de integraciones: las 90 integraciones integradas que esto extiende
• Seguridad: los límites dentro de los cuales opera cada integración, integrada o personalizada