Decide qué pueden pedirle los usuarios al agente, dónde debe guardarse la configuración de confianza y cómo gestionará tu aplicación el trabajo incompleto o fallido. Deja claras esas reglas tanto en la aplicación como en el flujo del agente.
Esta ruta orienta a desarrolladores y revisores técnicos. Consulta la documentación enlazada para conocer los tipos exactos del SDK, la configuración y los pasos de implementación.
Explicita las decisiones de integración
Antes de implementar, identifica el entorno de ejecución, el recorrido del usuario, la información que cruza cada límite y quién responde por cada credencial. Define qué considera la aplicación una tarea completada. Que aparezca un mensaje en la interfaz y que se complete una acción externa solicitada son hechos distintos.
Usa la guía de arquitectura para alinear al equipo en los conceptos y la guía de permisos para revisar las facultades del agente.
Consulta la documentación de referencia
Desplázate horizontalmente para ver todas las columnas.
| Pregunta de implementación | Documentación |
|---|---|
| ¿Cómo inicio una integración de agente externo? | Primeros pasos |
| ¿Cómo funcionan las sesiones y el almacenamiento? | Sesiones y almacenamiento |
| ¿Cómo se gestionan las conversaciones y la transmisión de datos? | Conversaciones y transmisión de datos |
| ¿Dónde encajan los archivos y los resultados generados? | Archivos y resultados |
| ¿Qué conceptos de políticas y capacidades se aplican? | Políticas y capacidades |
| ¿Qué relación tienen los espacios de trabajo con la integración? | Espacios de trabajo |
Incluye los fallos en el diseño de la aplicación
Planifica qué verá el usuario si se deniega el acceso, se agota el tiempo de espera, se interrumpe una conversación o no está disponible el resultado esperado. No indiques que una tarea se completó con éxito hasta contar con la evidencia que exige el flujo de trabajo. Revisa cómo se gestionan los reintentos cuando una acción podría generar un cambio externo duplicado.
Usa la guía de evaluación para crear casos de integración junto con las pruebas de la aplicación. Vuelve a la documentación para consultar las instrucciones de implementación vigentes a medida que evoluciona la integración.
Todas las guías de este tema
- Decide cuándo un agente externo necesita un espacio de trabajo: Usa un espacio de trabajo solo para capacidades que necesiten estado duradero; después, verifica qué capacidades se habilitaron y si el entorno de ejecución está listo.
- Diagnostica una integración con un agente externo desde el primer límite que falla: Sigue la autenticación, la política, la sesión, el espacio de trabajo, la entrada y el stream antes de cambiar código o volver a intentarlo.
- Integra un agente con el SDK de agentes externos: Mantén la autenticación de usuarios y la firma de aserciones en el servidor; después, usa el cliente del SDK para establecer una sesión y consultar la política pública del agente.
- Lee la política de un agente externo antes de diseñar su interfaz: Consulta las capacidades públicas y los límites del agente; diseña la interfaz con la configuración negociada, no con lo que solicitaste.
- Mantén separadas las referencias públicas y las credenciales de inicialización: El navegador puede usar la referencia pública de un agente, pero un servidor autenticado debe firmar la aserción de inicialización y proteger la credencial de firma.
- Sesiones, conversaciones, streaming, archivos y artefactos: Mantén diferenciados la identidad de sesión, el historial de conversaciones, los eventos de transmisión, los archivos cargados y los artefactos del agente en toda la integración.