Las conexiones permiten que un experto de Kapsule Agents trabaje dentro de aplicaciones que ya utiliza, con su permiso, y son completamente independientes de lo que un experto puede hacer en su cuenta de KapsuleHost.
Qué es una Conexión
Una conexión es un vínculo autenticado entre uno de sus expertos y una aplicación externa. Una vez conectada, ese experto puede utilizar las herramientas de la aplicación en una conversación: leer un documento, redactar un mensaje, verificar un registro. Sin una conexión, el experto no tiene acceso en absoluto.
Hay dos cosas que es importante precisar:
- Una conexión otorga acceso a esa aplicación, no a su cuenta de KapsuleHost. Los dos conjuntos de permisos nunca se mezclan.
- Cualquier cosa que cambie algo en la aplicación conectada sigue pasando por la misma tarjeta de confirmación que un cambio en su cuenta de KapsuleHost. La lectura es inmediata; la escritura pide permiso primero.
Las conexiones se encuentran en Agents, luego Gestionar Conexiones, o vaya directamente a /agents/connections. La página de inicio de Agents también muestra una tarjeta de Conexiones con algunos ejemplos de aplicaciones.
Qué Expertos Pueden Usar Qué Aplicaciones
El registro es deliberadamente conservador, y cada experto solo ve las aplicaciones que su trabajo necesita. Algunos se limitan a herramientas de solo lectura incluso cuando la aplicación en sí puede hacer más:
| Experto | Aplicaciones externas a las que puede acceder |
|---|---|
| Mara, Business Advisor | Stripe (solo lectura) |
| Thea, Creative Writer | Notion |
| Sef, SEO Consultant | GitHub (solo lectura) |
| Mila, Marketing Planner | Gmail, Slack, Notion, Google Calendar |
| Iris, Customer Comms | Gmail, Slack |
| Ash, Sales and Outreach | Gmail, Slack, Stripe (solo lectura) |
| Pip, Policy and Docs | Ninguna |
Conectar una aplicación no la entrega a todo el equipo. Solo está disponible para los expertos en la fila anterior.
Conectar una Aplicación
- Abra Agents, luego Gestionar Conexiones.
- Explore la pestaña Popular, cambie a Todas las Apps, o escriba en el cuadro de búsqueda. Cada tarjeta muestra el nombre de la aplicación y cuántas herramientas expone.
- Haga clic en Connect en la aplicación que desea. El botón cambia a Abriendo... mientras se prepara la ventana de inicio de sesión.
- Inicie sesión en la aplicación y apruebe el acceso que solicita.
- Vuelve a la página de Conexiones con una confirmación [aplicación] Conectada.
Una vez conectada, la tarjeta muestra una etiqueta Connected, la etiqueta de cuenta con la que inició sesión y cuándo se utilizó la conexión por última vez, o No usado aún.
Estados de Conexión
| Estado | Qué significa | Qué hacer |
|---|---|---|
| Connected | Funcionando. Sus expertos pueden usarla. | Nada |
| Pending | El inicio de sesión se inició pero nunca se terminó. | Haga clic en Finalizar Conexión |
| Reconexión Necesaria | El acceso ha expirado o se ha retirado por parte de la aplicación. | Haga clic en Reconectar |
El estado Reconexión Necesaria es normal con el tiempo: la mayoría de las aplicaciones expiran el acceso que otorgan según un calendario. Reconectar lo restaura sin perder nada.
Cómo Se Mantiene Seguro
La página de Conexiones expone el modelo de seguridad en tres líneas, y vale la pena comprenderlo en lugar de simplemente ojearlo:
- Manejado por un socio certificado. El inicio de sesión en una aplicación es manejado por nuestro socio de integración certificado, que mantiene la concesión. Su contraseña de aplicación nunca toca KapsuleHost.
- Confirmación antes de actuar. Los agentes piden permiso antes de actuar. Cualquier cosa que cambie algo necesita su aprobación primero.
- Revocación instantánea. Desconectar corta el acceso inmediatamente, tanto aquí como en la aplicación.
Trate una conexión como una llave que ha hecho cortar para alguien. Conecte las cuentas en las que desea que sus expertos trabajen, no todas las cuentas que posee. Si no está seguro de si un experto necesita una aplicación para hacer el trabajo que tiene en mente, no la conecte: pregunte primero, luego conecte.
Desconectar una Aplicación
- Abra Agents, luego Gestionar Conexiones.
- Haga clic en Disconnect en la aplicación conectada.
- Aparece una confirmación: Su equipo pierde acceso a [aplicación] inmediatamente. Todo lo que ya haya utilizado permanece en sus chats anteriores.
- Haga clic en Disconnect para confirmar.
El acceso termina inmediatamente. Lo que esto no hace es eliminar el contenido de la aplicación de las conversaciones que ya tuvo: si un experto citó un documento en un chat la semana pasada, ese texto sigue estando en la transcripción del chat. Desconectar se trata de acceso futuro, no de borrado retroactivo.
Cuando las Conexiones No Están Disponibles en Su Cuenta
Si la página de Conexiones muestra una sola tarjeta serena que dice Las Conexiones Aún No Están Disponibles, conectar aplicaciones externas no se ha activado para su cuenta. La tarjeta es explícita en que nada está conectado y nada tiene acceso, que es exactamente la verdad en ese estado. Sus expertos aún trabajan; simplemente no pueden llegar fuera de KapsuleHost.
El resto de Agents no se ve afectado. Los chats, Skills y las lecturas de cuenta funcionan normalmente.
¿Qué Sucede Si Falla?
"Permiso no fue otorgado, por lo que nada fue conectado." Canceló o rechazó en la pantalla de aprobación de la aplicación. Nada fue creado. Haga clic en Connect nuevamente y apruebe el acceso.
"Las conexiones no están disponibles en este momento. Intente de nuevo en un momento." El servicio de integración no se pudo alcanzar. Esto es deliberadamente de cierre seguro: en lugar de mostrar una lista medio construida, la página no muestra nada. Espere un minuto y recargue.
"Las conexiones no se pudieron cargar." Sus configuraciones son seguras. Actualice la página. Si persiste, abra un ticket de soporte.
Un experto dice que no puede llegar a una aplicación conectada. Verifique la tabla anterior. No todos los expertos pueden acceder a todas las aplicaciones, y una aplicación conectada para Iris no está automáticamente disponible para Mara.
Una conexión está en Pending. La ventana de inicio de sesión se cerró antes de terminar. Haga clic en Finalizar Conexión y complete el proceso.
Qué Cuestan las Conexiones
Usar una aplicación conectada en una conversación se factura como cualquier otro trabajo. Cada llamada que hace un experto a una aplicación externa se cobra según el peso de llamada de conexión, que es una fracción de lo que cuesta un texto largo. Las lecturas en su cuenta de KapsuleHost siguen siendo gratuitas. La ponderación completa está en Cómo Funcionan los Créditos de Agente.