Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Obtenga más información sobre el acceso de los agentes WorkSpaces
Amazon WorkSpaces Applications permite a los agentes conectarse a sesiones de streaming e interactuar con las aplicaciones de escritorio a través de un servicio gestionado de Model Context Protocol (MCP). En este tema se explica cómo los agentes acceden a WorkSpaces las aplicaciones y las capacidades que se pueden configurar.
Requisitos previos
Para utilizar el acceso de los agentes, necesita lo siguiente:
-
Una flota activa de Amazon WorkSpaces Applications (Always-On o On-Demand). Si no ha creado una flota, consulteIntroducción a Amazon WorkSpaces Applications: configuración con aplicaciones de muestra.
-
Una pila asociada a una flota. Los agentes no pueden conectarse a una pila sin una flota asociada.
-
Una AWS cuenta con permisos para crear y gestionar pilas de Amazon WorkSpaces Applications.
-
Si planea habilitar el almacenamiento de capturas de pantalla, un bucket de Amazon S3. La política de buckets debe conceder al AppStream servicio principal el acceso a los buckets de la lista. El agente que se conecta al servicio MCP debe tener el
s3:PutObjectpermiso en el bucket. -
Una flota que ejecute el agente de WorkSpaces aplicaciones más reciente. Para obtener más información sobre la actualización de su agente de WorkSpaces aplicaciones, consulteConserve la imagen de sus WorkSpaces aplicaciones de Amazon Up-to-Date. Para obtener información sobre la administración de las versiones de los agentes, consulte Administrar las versiones de los agentes.
Limitaciones
WorkSpaces las configuraciones de acceso de los agentes tienen las siguientes limitaciones:
-
Solo se admiten imágenes de Windows Server.
-
No se admiten los puntos de enlace de la VPC.
-
Multi-session no se admiten flotas.
-
No se admiten flotas elásticas.
Cómo funciona el acceso de los agentes
Al crear una pila, se habilita el acceso de los agentes. Cuando el acceso de los agentes está habilitado, la pila se configura con ajustes específicos del agente en lugar de la configuración de Amazon WorkSpaces Applications para usuarios humanos. Puede habilitar el acceso de los agentes a través de la consola o API de Amazon WorkSpaces Applications. AWS CLI
Entrada y visión por ordenador
El acceso a los agentes proporciona dos capacidades de interacción que se configuran a nivel de pila:
-
Entrada desde el ordenador: permite a los agentes hacer clic en los botones, introducir texto y desplazarse por el escritorio durante una sesión de streaming.
-
Visión artificial: permite a los agentes ver el escritorio tomando capturas de pantalla durante una sesión de streaming.
Debe habilitar al menos una de estas capacidades.
Almacenamiento de capturas de pantalla
Si lo desea, puede configurar el almacenamiento de capturas de pantalla para las sesiones de los agentes. Cuando el almacenamiento de capturas de pantalla está activado, las capturas de pantalla capturadas durante las sesiones de los agentes se almacenan en un bucket de Amazon S3. El servicio MCP utiliza las credenciales del agente que se conecta para cargar las capturas de pantalla en el depósito. El agente debe tener el s3:PutObject permiso correspondiente al depósito.
Diseño de pantalla de escritorio
Puede configurar la resolución de pantalla y el formato de imagen para el entorno de streaming del agente:
-
Resolución de pantalla: la resolución de pantalla del entorno de streaming del agente. La resolución admitida es de 1280 x 720.
-
Tipo de imagen de pantalla: formato de imagen para las capturas de pantalla de los agentes. Puede elegir PNG o JPEG.
Almacenamiento de carpetas de inicio
Puede habilitar las carpetas de inicio para que los archivos de los agentes se guarden en un bucket de Amazon S3 de su AWS cuenta. La flota de WorkSpaces aplicaciones de Amazon asociada a la pila debe permitir el acceso a Amazon S3 a través de Internet o de un punto de conexión de VPC de Amazon S3. Para obtener más información, consulte Habilitar y administrar las carpetas de inicio para sus usuarios.
Persistencia de la configuración de aplicaciones
Si lo desea, puede habilitar la persistencia de la configuración de la aplicación. Cuando está habilitada, las personalizaciones de las aplicaciones del agente y la configuración de Windows se guardan después de cada sesión de streaming y se aplican durante la siguiente sesión. Estos ajustes se guardan en un bucket de Amazon S3 de su AWS cuenta. La flota de WorkSpaces aplicaciones de Amazon asociada a la pila debe permitir el acceso a Amazon S3 a través de Internet o de un punto de conexión de VPC de Amazon S3. Para obtener más información, consulte Habilitar la persistencia de la configuración de las aplicaciones para sus usuarios.
Reenvío de herramientas MCP
Puede habilitar el reenvío de herramientas MCP para permitir que los agentes interactúen con las aplicaciones y el sistema operativo de escritorio mediante llamadas MCP directas en lugar de utilizar herramientas informáticas. Cuando está habilitada, las herramientas de MCP disponibles en la sesión de WorkSpaces la aplicación se reenvían al agente. Las herramientas reenviadas aparecen cuando el agente muestra las herramientas disponibles.
Modo de control de usuario
Puede activar el modo de control de usuario para que los usuarios puedan observar e interactuar con las sesiones de los agentes en tiempo real. Cuando el modo de control de usuario está activado, los observadores se conectan a la sesión a través de su navegador mediante una URL de transmisión. Obtienen una vista del escritorio en tiempo real a medida que el agente interactúa con él.
En VIEW_STOP el modo, aparece un botón de parada en la parte superior de la pantalla del observador. El observador puede usar este botón para detener al agente si es necesario. Una vez detenido un agente, debe iniciar una nueva sesión para reanudar su trabajo.
Defina el UserControlMode atributo en uno de los siguientes valores: AgentAccessConfig
-
VIEW_ONLY— Los usuarios pueden ver y observar las acciones de los agentes a medida que se producen. -
VIEW_STOP— Los usuarios pueden ver las acciones del agente y detenerlo si es necesario. -
DISABLED— Los usuarios no pueden ver ni detener la sesión del agente.
URL de streaming
Los agentes se conectan a WorkSpaces las aplicaciones a través de una URL de streaming. Se genera una URL de transmisión mediante la CreateStreamingURL API. No se requieren parámetros específicos del agente. El comportamiento específico del agente viene determinado por la configuración de acceso a los agentes de la pila. La URL de transmisión se pasa al servicio MCP como encabezado en cada solicitud.
Para obtener más información sobre la CreateStreamingURL API, consulta la CreateStreamingURL en la referencia de la API de Amazon AppStream 2.0.
Proxy MCP para AWS
Para conectar su agente al servicio MCP gestionado, puede utilizar el mcp-proxy-for-aws transporte para crear un cliente MCP que admita la firma SigV4 de las solicitudes de MCP en Python. Si está creando un agente en otro idioma, tendrá que escribir usted mismo la lógica de firma o buscar una biblioteca disponible.
Para obtener más información, consulte mcp-proxy-for-aws
Supervisión
Puede supervisar la actividad de los agentes a través de los siguientes servicios:
-
AWS CloudTrail— Los eventos de la sesión del agente están registrados CloudTrail. Puede ver cuándo se conectan los agentes, qué herramientas utilizan y cuándo finalizan las sesiones. Las llamadas a herramientas son eventos de datos y requieren que configure un registro para registrar los eventos de datos. Para obtener más información, consulte Registro de eventos de datos en la Guía del usuario de CloudTrail .
-
CloudWatch— Las siguientes métricas operativas están disponibles en las sesiones CloudWatch de los agentes:
InvocationsLatencyClientErrorsServerErrorsMcpSessionStartMcpSessionDuration
-
Amazon S3: si configura el almacenamiento de capturas de pantalla, las capturas de pantalla capturadas durante las sesiones de los agentes estarán disponibles en el bucket de Amazon S3 que especifique.
