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
<a name="getting-started-agent-access"></a>

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.](https://github.com/aws-samples/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
<a name="getting-started-agent-access-prereqs"></a>

Antes de empezar, asegúrese de que tiene lo siguiente:
+ Una flota activa de Amazon WorkSpaces Applications. Si aún no ha configurado una, consulte[Introducción a Amazon WorkSpaces Applications: configuración con aplicaciones de muestra](getting-started.md).
+ 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](https://strandsagents.com/docs/user-guide/concepts/tools/mcp-tools/) 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
<a name="getting-started-agent-access-create-stack"></a>

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
<a name="getting-started-agent-access-create-stack-console"></a>

**Para crear una pila con acceso de agente**

1. Abra la [consola de WorkSpaces aplicaciones](https://console.aws.amazon.com/appstream2/home).

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

1. 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**.

1. 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**.

1. 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**.

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

### Uso de AWS CLI
<a name="getting-started-agent-access-create-stack-cli"></a>

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
<a name="getting-started-agent-access-streaming-url"></a>

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
<a name="getting-started-agent-access-streaming-url-console"></a>

**Para generar una URL de streaming mediante la consola**

1. Abra la [consola de WorkSpaces aplicaciones](https://console.aws.amazon.com/appstream2/home).

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

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

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

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

1. Elija **getURL** y copie la URL generada.

### Uso de AWS CLI
<a name="getting-started-agent-access-streaming-url-cli"></a>

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
<a name="getting-started-agent-access-connect"></a>

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
<a name="getting-started-agent-access-verify"></a>

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
<a name="getting-started-agent-access-cleanup"></a>

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
<a name="getting-started-agent-access-cleanup-console"></a>

**Cómo limpiar los recursos**

1. Abra la [consola de WorkSpaces aplicaciones](https://console.aws.amazon.com/appstream2/home).

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

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

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

1. Selecciona la pila que has creado y elige **Acciones**, **desasociar flota**.

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

1. (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
<a name="getting-started-agent-access-cleanup-cli"></a>

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}}
```