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.
Comience a proporcionar a los agentes acceso a WorkSpaces Aplicaciones
Permitir a los agentes de IA operar aplicaciones de escritorio a través de Amazon WorkSpaces Para las aplicaciones, debe crear una pila con acceso habilitado para los agentes, generar una URL de transmisión y conectar a su agente al servidor MCP administrado.
Si es la primera vez que configura el acceso de los agentes, puede utilizar la experiencia de inicio rápido Build Your First Agent. También puede seguir los pasos de este tema para configurar manualmente el acceso de los agentes. La experiencia de inicio rápido está disponible en GitHub repositorio — código de ejemplo para el acceso de agentes a espacios de trabajo
Este tutorial tarda aproximadamente 15 minutos en completarse.
Los recursos que cree en este tutorial pueden generar cargos para su AWS cuenta. Elimine la pila y detenga la flota cuando haya terminado para evitar cargos continuos.
En este tutorial, completará las siguientes tareas:
Paso 1: Cree una pila con el acceso de los agentes habilitado
Paso 2: Generar una URL de streaming
Paso 3: Conecte su agente al servidor MCP
Paso 4: Verificar la actividad del agente
Paso 5: Limpiar los recursos de
Escriba el código del agente con el kit de herramientas para agentes de AWS
Si crea su agente con un asistente de codificación de IA, puede usar el Kit de herramientas para agentes para AWS
El kit de herramientas utiliza el AWS Servidor MCP. Este servidor administrado brinda a los agentes un acceso seguro a AWS mediante el Protocolo de contexto modelo (MCP). Los agentes pueden ejecutarse AWS CLI comandos, búsqueda AWS documentos y siga las habilidades ya preparadas. Se conectan a través de un punto final seguro. También obtienes CloudWatch métricas y controles de acceso a IAM.
Para empezar, pídele a tu agente: «Ayúdame a completar el proceso de inicio». WorkSpaces tutorial de acceso para agentes».
Requisitos previos
Antes de empezar, revise los requisitos de acceso de los agentes. Para conocer los requisitos previos de la cuenta, la flota, los permisos y los agentes, consulte Requisitos previos.
Paso 1: crear una pila con el acceso de los agentes habilitado
Crea un WorkSpaces Las aplicaciones se apilan con el acceso de los agentes habilitado para permitir que los agentes de IA interactúen con las aplicaciones de escritorio.
Uso de AWS Consola de administración
Para crear una pila con acceso de agente
-
Abra el WorkSpaces Consola de aplicaciones
. -
En el panel de navegación izquierdo, elige Pilas, luego elige Crea Stack.
-
En el Detalles de la pila página (paso 1 de 4), en Acceso a agentes de IA, seleccione Habilite el acceso de los agentes de IA. Elija Siguiente.
-
En el Habilitar el almacenamiento página (paso 2 de 4), habilite opcionalmente Carpetas de inicio para permitir que su agente guarde archivos en un bucket de Amazon S3 de su AWS cuenta. La flota asociada a esta pila debe permitir el acceso a Amazon S3 a través de Internet o de un punto de enlace de Amazon VPC para Amazon S3. Elija Siguiente.
-
En el Editar la configuración del agente página (paso 3 de 4), configure lo siguiente:
-
Habilite la entrada de la computadora — Permita a los agentes elegir botones, introducir texto y desplazarse por el escritorio. Si habilita la entrada por computadora, también debe habilitar la visión artificial.
-
Habilite la visión artificial — Permitir que los agentes vean el escritorio.
-
Almacenamiento de capturas de pantalla — Configure dónde se almacenan las capturas de pantalla del agente durante las sesiones de streaming. Si está habilitada, proporcione un bucket de Amazon S3 en el que tenga permiso de escritura.
-
Resolución de pantalla — Seleccione la resolución de pantalla para el entorno de streaming del agente (1280 x 720).
-
Tipo de imagen de pantalla — Seleccione el formato de imagen para las capturas de pantalla del agente (PNG o JPEG).
-
Persistencia de la configuración de la — Si lo desea, actívela para guardar las personalizaciones de las aplicaciones y la configuración de Windows de su agente entre sesiones. La configuración se guarda en un bucket de Amazon S3 de su AWS cuenta. Esta configuración está disponible en Windows y no es compatible con Linux.
-
Habilite el reenvío de herramientas MCP — Permita que los agentes interactúen con las aplicaciones y el sistema operativo de escritorio mediante llamadas directas al MCP, en lugar de utilizar herramientas informáticas. Cuando están habilitadas, las herramientas MCP configuradas en el WorkSpaces las sesiones de aplicación se reenvían al agente. El reenvío de herramientas también requiere un archivo de configuración en la imagen. Para ver la ruta específica de la plataforma y los pasos de configuración, consulte Configuración del reenvío de herramientas.
-
Habilitar el modo de control de usuario — Permitir a los usuarios observar las sesiones de los agentes en tiempo real a través de su navegador. Los observadores ven una vista en vivo del escritorio mientras el agente trabaja. En el modo VIEW_STOP, los observadores pueden detener al agente mediante un botón situado en la parte superior de la pantalla. Una vez que el agente se detiene, debe iniciar una nueva sesión para reanudarse.
notaDebe habilitar al menos una de las funciones de entrada por computadora o visión artificial.
Elija Siguiente.
-
-
En el Revisa y crea página (paso 4 de 4), revisa tu configuración y elige Crea Stack.
Uso de AWS CLI
Ejecute el siguiente comando para crear una pila con el acceso de agentes habilitado:
aws appstream create-stack \ --nameyour-stack-name\ --agent-access-config '{ "Settings": [ {"AgentAction": "COMPUTER_VISION", "Permission": "ENABLED"}, {"AgentAction": "COMPUTER_INPUT", "Permission": "ENABLED"}, {"AgentAction": "FORWARD_MCP_TOOLS", "Permission": "ENABLED"} ], "ScreenResolution": "W_1280xH_720", "ScreenImageFormat": "PNG" }'
Para habilitar también el almacenamiento de capturas de pantalla, añada S3BucketArn y ScreenshotsUploadEnabled parámetros:
aws appstream create-stack \ --nameyour-stack-name\ --agent-access-config '{ "Settings": [ {"AgentAction": "COMPUTER_VISION", "Permission": "ENABLED"}, {"AgentAction": "COMPUTER_INPUT", "Permission": "ENABLED"}, {"AgentAction": "FORWARD_MCP_TOOLS", "Permission": "ENABLED"} ], "ScreenResolution": "W_1280xH_720", "ScreenImageFormat": "PNG", "S3BucketArn": "arn:aws:s3:::your-bucket-name", "ScreenshotsUploadEnabled": true }'
Tras crear la pila, asóciala a una flota. Los agentes no pueden conectarse a una pila que no tenga una flota asociada.
aws appstream associate-fleet \ --stack-nameyour-stack-name\ --fleet-nameyour-fleet-name
Paso 2: generar una URL de streaming
Crea una URL de streaming usando el estándar WorkSpaces Aplicaciones CreateStreamingURL API. No necesita parámetros específicos del agente. La configuración de acceso de los agentes de la pila determina el comportamiento específico de los agentes.
Uso de AWS Consola de administración
Para generar una URL de transmisión mediante la consola
-
Abre el WorkSpaces Consola de aplicaciones
. -
En el panel de navegación izquierdo, elige Pilasy, a continuación, elija la pila que creó con el acceso de agentes habilitado.
-
Elige el Acciones botón y, en el menú desplegable, selecciona Crea una URL de streaming. Tu pila debe estar seleccionada para que esta opción esté disponible.
-
En el ID de usuario sección, introduzca un usuario. Puedes entrar
TestUsersi estás haciendo pruebas. -
En el Caducidad de URL sección, selecciona el tiempo durante el que quieres que la URL sea válida. Se recomienda un tiempo más corto. El valor predeterminado es de 30 minutos, lo que se recomienda para las pruebas.
-
Elija Obtener URL y copia la URL generada.
Uso de AWS CLI
Ejecuta el siguiente comando para generar una URL de streaming:
aws appstream create-streaming-url \ --stack-nameyour-stack-name\ --fleet-nameyour-fleet-name\ --user-idyour-agent-id\ --validity 3600
La respuesta incluye un StreamingURL que pasará a su agente en el siguiente paso. La URL es válida durante el tiempo especificado por el --validity parámetro.
En un momento dado, solo un agente puede conectarse a una sesión única. Usuarios nominales, especificados mediante el UserId parámetro, solo puede tener una sesión activa por flota a la vez. Para ejecutar varios agentes al mismo tiempo, cada agente debe conectarse a su propia sesión única.
Paso 3: Conecte su agente al servidor MCP
Su agente se conecta al servidor MCP administrado en el siguiente punto final fijo:
https://agentaccess-mcp.region.api.aws/mcp
Sustituya region con tu código de región. Para ver las regiones compatibles y sus puntos finales, consulta WorkSpaces Aplicaciones: puntos de conexión MCP.
La conexión utiliza la firma SigV4 con el nombre del servicio agentaccess-mcp. Su agente firma cada solicitud mediante el AWS
credenciales configuradas en los requisitos previos con el agentaccess-mcp:* permisos. Pasas la URL de streaming del paso 2 como encabezado en cada solicitud de MCP.
El siguiente ejemplo muestra cómo establecer la conexión mediante mcp-proxy-for-aws:
aws_iam_streamablehttp_client( endpoint="https://agentaccess-mcp.region.api.aws/mcp", aws_service="agentaccess-mcp", aws_region="region", headers={ "x-amzn-agentaccess-streaming-session-url": streaming_url, }, )
Una vez que el agente se conecta, puede usar las herramientas del MCP para introducir texto, seleccionar botones y realizar capturas de pantalla del escritorio.
Paso 4: Verificar la actividad del agente
Puede verificar la actividad del agente de la siguiente manera AWS servicios:
-
AWS CloudTrail — AWS CloudTrail registra los eventos de sesión del agente. Abra el AWS CloudTrail consola para ver la actividad de los agentes. Las llamadas a las herramientas se registran como eventos de datos, lo que requiere un registro configurado para registrar eventos de datos.
-
CloudWatch — CloudWatch proporciona métricas operativas para las sesiones de los agentes. Abra el CloudWatch consola para ver las métricas.
-
Amazon S3 — Si ha habilitado el almacenamiento de capturas de pantalla, Amazon S3 almacena las capturas de pantalla en el depósito que especificó durante la configuración de la pila.
Paso 5: Limpiar los recursos de
Para evitar cargos continuos, elimine la pila que creó en este tutorial. Debes detener la flota y desasociarla de la pila antes de poder eliminarla. Si lo desea, también puede eliminar la flota.
Uso de AWS Consola de administración
Cómo limpiar los recursos
-
Abre el WorkSpaces Consola de aplicaciones
. -
En el panel de navegación izquierdo, elija Flotas.
-
Seleccione la flota asociada a la pila. Elija Acciones, Detener. Espere a que la flota se detenga.
-
En el panel de navegación izquierdo, elija Pilas.
-
Selecciona la pila que creaste y elige Acciones, Desasociar la flota.
-
Con la pila aún seleccionada, elige Acciones, Eliminar.
-
(Opcional) Para eliminar la flota, en el panel de navegación izquierdo, elige Flotas. Selecciona la flota y elige Acciones, Eliminar.
Uso de AWS CLI
Ejecute los siguientes comandos para limpiar los recursos:
aws appstream stop-fleet \ --nameyour-fleet-nameaws appstream disassociate-fleet \ --stack-nameyour-stack-name\ --fleet-nameyour-fleet-nameaws appstream delete-stack \ --nameyour-stack-name
(Opcional) Para eliminar también la flota una vez detenida:
aws appstream delete-fleet \ --nameyour-fleet-name