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.
# 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, consulte[Introducción a Amazon WorkSpaces Applications: configuración con aplicaciones de muestra](getting-started.md).
+ 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:PutObject` permiso en el bucket.
+ Si planea habilitar las carpetas de inicio, se aplica el mismo requisito de acceso a Amazon S3.
+ Una flota con el último agente de WorkSpaces aplicaciones. Para obtener más información sobre la actualización de su agente de WorkSpaces aplicaciones, consulte[Conserve la imagen de sus WorkSpaces aplicaciones de Amazon Up-to-Date](keep-image-updated.md).
**Limitaciones**
WorkSpaces las configuraciones de acceso a los agentes tienen las siguientes limitaciones:
+ Solo se admiten imágenes de Windows Server.
+ Domain-joined no se admiten flotas.
+ 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 se habilita el acceso de los agentes, la pila se configura con ajustes específicos del agente en lugar de la configuración estándar 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 Amazon WorkSpaces Applications asociada a la pila debe permitir el acceso a Amazon S3 a través de Internet.
## 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 Amazon WorkSpaces Applications asociada a la pila debe permitir el acceso a Amazon S3 a través de Internet.
## 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](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateStreamingURL.html) 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](https://github.com/aws/mcp-proxy-for-aws) en. GitHub
## 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](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html) en la *Guía del usuario de CloudTrail *.
+ **CloudWatch**— Las siguientes métricas operativas están disponibles en las sesiones CloudWatch de los agentes:
+ `Invocations`
+ `Latency`
+ `ClientErrors`
+ `ServerErrors`
+ `SessionStart`
+ `SessionEnd`
+ **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.