Conectores personalizados

¿Qué experiencia estás usando?

Estos documentos cubren ambas experiencias. Si está disponible Settings → Personal → My Okou, sigue los pasos de My Okou. Si usas una página de Agents con New agent, sigue los pasos de Legacy Agents. La disponibilidad puede variar entre miembros; estos documentos no cambian tu experiencia.

En cualquiera de las dos experiencias, puedes ejecutar varios chats o tareas a la vez, reutilizar flujos de trabajo y compartir con tu equipo el trabajo revisado. Un subagente en tiempo de ejecución es una herramienta de ejecución, no un perfil de producto aparte que debas crear.

Diferencias de configuración: My Okou usa Instructions personales en Settings → Personal → My Okou y flujos de trabajo del espacio de trabajo. Cualquier paso más abajo que te pida elegir, crear o autorizar un agente con nombre aplica solo a Legacy Agents. En My Okou, usa tu propio Chat y sigue la solicitud de cuenta y de permisos con nombre que se muestra. Los flujos de trabajo compartidos no comparten credenciales; las automatizaciones usan el contexto y el acceso de su propietario.

Un conector personalizado permite que un administrador de la organización registre una API HTTPS o, donde esté habilitado, un servidor MCP Streamable HTTP que no está en el catálogo integrado. Define el límite de red y el método de autenticación. No genera automáticamente una referencia completa de la API para el agente.

Quién configura qué

• Los administradores de la organización crean, editan y eliminan la definición del conector.
• Los miembros conectan su propio secreto o completan el flujo OAuth del conector.
• La autorización y los permisos controlan qué acciones con nombre puede solicitar Okou con la conexión. Legacy Agents también usan autorización específica del agente.

La definición se comparte en la organización. Las credenciales del miembro siguen estando limitadas al miembro y a la organización.

Conector de API HTTP

1. Abre Connectors → Custom y elige New connector.
2. Selecciona HTTP API e introduce un nombre para mostrar.
3. Añade uno o más Prefixes HTTPS, uno por línea. Una solicitud debe coincidir con un prefijo configurado antes de que el conector pueda autorizarla.
4. Añade autenticación si la API la requiere:
   • API authentication: introduce el nombre del encabezado y una plantilla de encabezado que contenga {{secret}}, por ejemplo Authorization y Bearer {{secret}}.
   • OAuth 2.0: introduce la URL de autorización, la URL del token, el ID de cliente, el secreto del cliente, los ámbitos y el método de autenticación del endpoint del token. Registra con el proveedor la URL de redirección exacta que se muestra en el formulario.
5. Crea el conector. Después, cada miembro que lo necesite selecciona Connect y proporciona su secreto o completa OAuth.
6. Revisa y autoriza los permisos con nombre requeridos. En Legacy Agents, selecciona también el agente previsto.

Cambiar una definición OAuth existente o sus credenciales de cliente desconecta las conexiones OAuth actuales. Los miembros deben conectarse de nuevo después del cambio.

Conector MCP

Si MCP aparece como tipo de conector en tu espacio de trabajo, introduce un endpoint MCP Streamable HTTP HTTPS y configura la autenticación API u OAuth en el mismo formulario. Si MCP no aparece en el selector, no está habilitado para ese espacio de trabajo.

Enseña al agente el procedimiento de la API

Un conector personalizado proporciona acceso seguro a la red e inyección de credenciales. El formulario de creación no carga ni descubre automáticamente un documento OpenAPI. Dale al agente el endpoint, el método, los parámetros y la respuesta esperada en la solicitud, o captura ese procedimiento en un flujo de trabajo con una referencia de API adjunta como archivo.

Valida un conector nuevo con una solicitud reducida y de solo lectura a un endpoint conocido. No existe una solicitud genérica Test connection porque muchas APIs no exponen un endpoint raíz significativo.

Límites de seguridad

• Solo se aceptan prefijos HTTPS y endpoints MCP.
• El firewall inyecta la credencial guardada solo en las solicitudes coincidentes.
• El secreto guardado está cifrado en reposo y no se expone al agente como una variable de entorno.
• No pongas claves, tokens ni secretos de cliente en mensajes de chat, instrucciones de flujo de trabajo o archivos adjuntos.
• Usa una credencial de servicio con los ámbitos mínimos necesarios ascendentes para el flujo de trabajo.

Solución de problemas

Qué sigue

• Consulta Flujos de trabajo para capturar trabajo repetido de conectores personalizados.
• Consulta Permisos para ver cómo se gestionan las credenciales de conectores personalizados.
• Consulta el Catalog antes de crear uno personalizado: tu servicio podría ya estar admitido.