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 las aplicaciones WorkSpaces

Para que los agentes de IA puedan operar 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 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 el GitHub repositorio: sample-code-for-workspaces-agent-access.

Este tutorial tarda aproximadamente 15 minutos en completarse.

En este tutorial, completará las siguientes tareas:

Requisitos previos

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

Paso 1: Cree una pila con el acceso de 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

Uso de AWS CLI

Ejecute el siguiente comando para crear una pila con el acceso de agente 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 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"},
            {"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 con la CreateStreamingURL API de WorkSpaces aplicaciones estándar. No necesitas parámetros específicos para cada 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

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 le pasas a tu agente en el siguiente paso. La URL es válida durante el tiempo especificado en el --validity parámetro.

Paso 3: Conecte su agente al servicio MCP

Su agente se conecta al servicio MCP administrado 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 Su agente firma cada solicitud con las AWS credenciales configuradas en los requisitos previos junto con los 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 de los agentes mediante los siguientes AWS servicios:

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

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