Primeros pasos
Conectando Aplicaciones Externas a Tus Agentes
Connections let a Kapsule Agents expert work inside apps you already use, with your permission, and they are entirely separate from what an expert can do on your Kapsule account.
Qué es una Conexión
Una conexión es un enlace iniciado de sesión entre uno de tus expertos y una aplicación externa. Una vez conectada, ese experto puede usar 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 vale la pena precisar:
- Una conexión otorga acceso a esa aplicación, no a tu cuenta de Kapsule. 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 tu cuenta de Kapsule. La lectura es inmediata; la escritura pide permiso primero.
Las conexiones se encuentran en Agents, luego Manage Connections, o ve 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 catálogo es deliberadamente conservador, y cada experto solo ve las aplicaciones que su trabajo necesita. Algunos están limitados a herramientas de solo lectura, incluso cuando la aplicación en sí puede hacer más:
| Experto | Aplicaciones externas que puede alcanzar |
|---|---|
| Mara, Business Advisor | Stripe (solo lectura) |
| Thea, Creative Writer | Notion |
| Sef, SEO Consultant | GitHub (solo lectura) |
| Mila, Marketing Planner | Gmail, Slack, Notion, Google Calendar |
| Cora, 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
- Abre Agents, luego Manage Connections.
- Explora la pestaña Popular, cambia a All Apps, o escribe en el cuadro de búsqueda. Cada tarjeta muestra el nombre de la aplicación y cuántas herramientas expone.
- Haz clic en Connect en la aplicación que deseas. El botón cambia a Opening... mientras se prepara la ventana de inicio de sesión.
- Inicia sesión en la aplicación en sí y aprueba el acceso que solicita.
- Vuelves a la página de Conexiones con una confirmación [aplicación] Connected.
Una vez conectada, la tarjeta muestra una píldora Connected, la etiqueta de cuenta con la que iniciaste sesión y cuándo se utilizó la conexión por última vez, o Not used yet.
Estados de Conexión
| Estado | Qué significa | Qué hacer |
|---|---|---|
| Connected | Funcionando. Tus expertos pueden usarla. | Nada |
| Pending | El inicio de sesión se inició pero nunca se completó. | Haz clic en Finish Connecting |
| Reconnect Needed | El acceso ha expirado o fue retirado por parte de la aplicación. | Haz clic en Reconnect |
El estado Reconnect Needed es normal con el tiempo: la mayoría de aplicaciones expiran el acceso que otorgan según un calendario. Reconectar lo restaura sin perder nada.
Cómo Esto 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 solo hojearlo:
- 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 autorización. Tu contraseña de aplicación nunca toca Kapsule.
- Confirmación antes de actuar. Los Agents piden permiso antes de actuar. Cualquier cosa que cambie algo necesita tu consentimiento primero.
- Revocación instantánea. Desconectar corta el acceso inmediatamente, tanto aquí como con la aplicación.
Trata una conexión como una llave que has mandado hacer para alguien. Conecta las cuentas en las que deseas que tus expertos trabajen, no todas las cuentas que posees. Si no estás seguro de si un experto necesita una aplicación para hacer el trabajo que tienes en mente, no la conectes: pregunta primero, luego conecta.
Desconectar una Aplicación
- Abre Agents, luego Manage Connections.
- Haz clic en Disconnect en la aplicación conectada.
- Aparece una confirmación: Tu equipo pierde acceso a [aplicación] de inmediato. Cualquier cosa que ya haya usado permanece en tus chats anteriores.
- Haz clic en Disconnect para confirmar.
El acceso termina inmediatamente. Lo que esto no hace es borrar el contenido de la aplicación de las conversaciones que ya tuviste: 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 del acceso futuro, no del borrado retroactivo.
Cuando las Conexiones No Están Disponibles en Tu Cuenta
Si la página de Conexiones muestra una única tarjeta tranquila que dice Connections Are Not Available Yet, conectar aplicaciones externas no se ha activado para tu cuenta. La tarjeta es explícita en que nada está conectado y nada tiene acceso, que es exactamente la verdad en ese estado. Tus expertos siguen trabajando; simplemente no pueden alcanzar fuera de Kapsule.
El resto de Agents no se ve afectado. Los chats, Skills y las lecturas de cuenta funcionan normalmente.
Qué Si Falla
"Permission was not granted, so nothing was connected." Cancelaste o rechazaste en la pantalla de aprobación de la aplicación. Nada fue creado. Haz clic en Connect nuevamente y aprueba el acceso.
"Connections are unavailable right now. Try again in a moment." El servicio de integración no pudo ser alcanzado. Esto está deliberadamente cerrado por fallo: en lugar de mostrar una lista a medio construir, la página no muestra nada. Espera un minuto y recarga.
"Connections could not be loaded." Tus configuraciones están seguras. Actualiza la página. Si persiste, abre un ticket de soporte.
Un experto dice que no puede alcanzar una aplicación conectada. Consulta la tabla anterior. No todos los expertos tienen permitido todas las aplicaciones, y una aplicación conectada para Cora no está automáticamente disponible para Mara.
Una conexión está en Pending. La ventana de inicio de sesión se cerró antes de que terminara. Haz clic en Finish Connecting y complétalo.
Qué Cuesta las Conexiones
Usar una aplicación conectada en una conversación se mide como cualquier otro trabajo. Cada llamada que un experto hace a una aplicación externa se cobra con el peso de llamada de conexión, que es una fracción de lo que cuesta un texto largo. Las lecturas en tu cuenta de Kapsule siguen siendo gratuitas. La ponderación completa está en How Agent Credits Work.