View a markdown version of this page

Comience a proporcionar a los agentes acceso a WorkSpaces Aplicaciones - Amazon WorkSpaces Aplicaciones

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.

importante

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. Le ayuda a configurar el acceso de los agentes y a crear su primer agente.

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
  1. Abra el WorkSpaces Consola de aplicaciones.

  2. En el panel de navegación izquierdo, elige Pilas, luego elige Crea Stack.

  3. 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.

  4. 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.

  5. 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.

    nota

    Debe habilitar al menos una de las funciones de entrada por computadora o visión artificial.

    Elija Siguiente.

  6. 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 \ --name your-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 \ --name your-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-name your-stack-name \ --fleet-name your-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
  1. Abre el WorkSpaces Consola de aplicaciones.

  2. En el panel de navegación izquierdo, elige Pilasy, a continuación, elija la pila que creó con el acceso de agentes habilitado.

  3. 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.

  4. En el ID de usuario sección, introduzca un usuario. Puedes entrar TestUser si estás haciendo pruebas.

  5. 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.

  6. 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-name your-stack-name \ --fleet-name your-fleet-name \ --user-id your-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.

nota

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
  1. Abre el WorkSpaces Consola de aplicaciones.

  2. En el panel de navegación izquierdo, elija Flotas.

  3. Seleccione la flota asociada a la pila. Elija Acciones, Detener. Espere a que la flota se detenga.

  4. En el panel de navegación izquierdo, elija Pilas.

  5. Selecciona la pila que creaste y elige Acciones, Desasociar la flota.

  6. Con la pila aún seleccionada, elige Acciones, Eliminar.

  7. (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 \ --name your-fleet-name aws appstream disassociate-fleet \ --stack-name your-stack-name \ --fleet-name your-fleet-name aws appstream delete-stack \ --name your-stack-name

(Opcional) Para eliminar también la flota una vez detenida:

aws appstream delete-fleet \ --name your-fleet-name