Comience a proporcionar a los agentes acceso a las aplicaciones WorkSpaces

Para permitir que los agentes de IA operen aplicaciones de escritorio a través de Amazon WorkSpaces Applications, debe crear una pila con acceso habilitado para los agentes, generar una URL de transmisión y conectar a su agente al servicio MCP gestionado.

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 el acceso de los agentes manualmente. La experiencia de inicio rápido está disponible en el GitHub repositorio: sample-code-for-workspaces-agent-access.

Este tutorial tarda aproximadamente 15 minutos en completarse.

importante

Los recursos que cree en este tutorial pueden generar cargos en su AWS cuenta. Elimine la pila y detenga la flota cuando haya terminado para evitar que se sigan cobrando cargos.

En este tutorial, completará las siguientes tareas:

• Paso 1: Cree una pila con el acceso de los agentes habilitado

• Paso 2: Genera una URL de streaming

• Paso 3: Conecte a su agente al servicio MCP

• Paso 4: Verificar la actividad del agente

• Paso 5: Limpiar los recursos de

Requisitos previos

Antes de empezar, asegúrese de que tiene lo siguiente:

• Una flota activa de Amazon WorkSpaces Applications. Si aún no ha configurado una, consulteIntroducción a Amazon WorkSpaces Applications: configuración con aplicaciones de muestra.

• AWS credenciales (variables de entorno, AWS perfil, función de instancia EC2 o función de ejecución de Lambda) con los siguientes permisos de IAM:

  {
      "Sid": "MCP",
      "Effect": "Allow",
      "Action": ["agentaccess-mcp:*"],
      "Resource": "*"
  },
  {
      "Sid": "AppStream",
      "Effect": "Allow",
      "Action": ["appstream:CreateStreamingURL", "appstream:DescribeFleets"],
      "Resource": "*"
  }

• Un MCP-compatible marco de agentes. El agente debe poder realizar solicitudes HTTP SigV4-signed transmisibles al punto final del MCP. El SDK de Strands Agents ofrece soporte nativo para clientes MCP. También puede utilizar cualquier framework con el transporte mcp-proxy-for-aws.

• Python 3.10 o posterior. No se requiere ningún sistema operativo específico.

Paso 1: Cree una pila con el acceso a los agentes habilitado

Cree una pila de WorkSpaces aplicaciones 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 la consola de WorkSpaces aplicaciones.

2. En el panel de navegación izquierdo, selecciona Stacks y, a continuación, selecciona Create Stack.

3. En la página de detalles del Stack (paso 1 de 4), en Acceso a agentes de IA, selecciona Habilitar el acceso de agentes de IA. Elija Siguiente.

4. En la página Habilitar el almacenamiento (paso 2 de 4), habilite de forma opcional las carpetas de inicio para que su agente pueda guardar los 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 a un punto de conexión de Amazon VPC para Amazon S3. Elija Siguiente.

5. En la página Editar la configuración del agente (paso 3 de 4), configure lo siguiente:

   • Habilitar la entrada desde el ordenador: permite a los agentes elegir botones, introducir texto y desplazarse por el escritorio. Si habilita la entrada por ordenador, también debe activar la visión artificial.

   • Habilitar la visión artificial: permita que los agentes vean el escritorio.

   • Almacenamiento de capturas de pantalla: configure dónde se almacenan las capturas de pantalla de los agentes durante las sesiones de streaming. Si está habilitada, proporciona un bucket de Amazon S3 en el que tengas permisos para escribir.

   • 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 aplicación: active esta opción si lo desea para guardar las personalizaciones de la aplicación del agente y la configuración de Windows entre sesiones. La configuración se guarda en un bucket de Amazon S3 de su AWS cuenta.

   nota

   Debe habilitar al menos una entrada de ordenador o visión artificial.

   Elija Siguiente.

6. En la página Revisar y crear (paso 4 de 4), revisa tu configuración y selecciona Crear pila.

Uso de AWS CLI

Ejecute el siguiente comando para crear una pila con el acceso a los agentes activado:

aws appstream create-stack \
    --name your-stack-name \
    --agent-access-config '{
        "Settings": [
            {"AgentAction": "COMPUTER_VISION", "Permission": "ENABLED"},
            {"AgentAction": "COMPUTER_INPUT", "Permission": "ENABLED"}
        ],
        "ScreenResolution": "W_1280xH_720",
        "ScreenImageFormat": "PNG"
    }'

Para habilitar también el almacenamiento de capturas de pantalla, añada los ScreenshotsUploadEnabled parámetros S3BucketArn y:

aws appstream create-stack \
    --name your-stack-name \
    --agent-access-config '{
        "Settings": [
            {"AgentAction": "COMPUTER_VISION", "Permission": "ENABLED"},
            {"AgentAction": "COMPUTER_INPUT", "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

Cree una URL de streaming mediante la CreateStreamingURL API de WorkSpaces aplicaciones estándar. No necesita parámetros específicos del agente. La configuración de acceso a los agentes de la pila determina el comportamiento específico del agente.

Uso de AWS Consola de administración

Para generar una URL de streaming mediante la consola

1. Abra la consola de WorkSpaces aplicaciones.

2. En el panel de navegación izquierdo, selecciona Pilas y, a continuación, elige la pila que creaste con el acceso a los agentes activado.

3. Selecciona el botón Acciones y, en el menú desplegable, selecciona Crear URL de streaming. Tu pila debe estar seleccionada para que esta opción esté disponible.

4. En la sección UserID, introduce un usuario. Puede entrar TestUser si está realizando una prueba.

5. En la sección de caducidad de la URL, selecciona la hora en la que quieres que la URL sea válida. Se recomienda un tiempo más corto. 30 minutos es el valor predeterminado y se recomienda para las pruebas.

6. Elija getURL y copie la URL generada.

Uso de AWS CLI

Ejecute el siguiente comando para generar una URL de transmisión:

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 una StreamingURL que debes pasar a tu agente en el siguiente paso. La URL es válida durante el tiempo especificado por el --validity parámetro.

Paso 3: Conecte a su agente al servicio MCP

Su agente se conecta al servicio MCP gestionado en el siguiente punto final fijo:

https://agentaccess-mcp.region.api.aws/mcp

La conexión utiliza la firma SiGv4 con el nombre del servicio. agentaccess-mcp En cada solicitud de MCP, se pasa la URL de transmisión del paso 2 como encabezado.

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 conecte, podrá utilizar 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 de los agentes mediante los siguientes AWS servicios:

• AWS CloudTrail— AWS CloudTrail registra los eventos de la sesión del agente. Abra la AWS CloudTrail consola para ver la actividad del agente.

• CloudWatch— CloudWatch proporciona métricas operativas para las sesiones de los agentes. Abra la CloudWatch consola para ver las métricas.

• Amazon S3: si ha activado 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, elimina la pila que creaste 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. Abra la consola de WorkSpaces 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 has creado y elige Acciones, desasociar flota.

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

7. (Opcional) Para eliminar la flota, en el panel de navegación izquierdo, selecciona Flotas. Seleccione la flota y elija Acciones y Eliminar.

Uso de AWS CLI

Ejecuta 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 después de que se haya detenido:

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