Commencez à fournir aux agents un accès aux WorkSpaces applications

Pour permettre aux agents d'intelligence artificielle d'exploiter des applications de bureau via Amazon WorkSpaces Applications, vous créez une pile dont l'accès est activé pour les agents, vous générez une URL de streaming et vous connectez votre agent au service MCP géré.

Si vous configurez l'accès aux agents pour la première fois, vous pouvez utiliser l'expérience de démarrage rapide de Build Your First Agent. Vous pouvez également suivre les étapes décrites dans cette rubrique pour configurer manuellement l'accès aux agents. L'expérience de démarrage rapide est disponible dans le GitHub référentiel : sample-code-for-workspaces-agent-access.

La réalisation de ce didacticiel prend environ 15 minutes.

Important

Les ressources que vous créez dans ce didacticiel peuvent entraîner des frais sur votre AWS compte. Supprimez la pile et arrêtez la flotte lorsque vous avez terminé pour éviter des frais permanents.

Dans ce didacticiel, vous allez effectuer les tâches suivantes :

• Étape 1 : créer une pile avec l'accès aux agents activé

• Étape 2 : générer une URL de streaming

• Étape 3 : Connectez votre agent au service MCP

• Étape 4 : vérifier l'activité de l'agent

• Étape 5 : Nettoyer les ressources

Conditions préalables

Avant de commencer, assurez-vous de disposer des éléments suivants :

• Un parc Amazon WorkSpaces Applications actif. Si vous n'en avez pas encore configuré, consultezDémarrez avec les WorkSpaces applications Amazon : configuration à l'aide d'exemples d'applications.

• AWS informations d'identification (variables d'environnement, AWS profil, rôle d'instance EC2 ou rôle d'exécution Lambda) avec les autorisations IAM suivantes :

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

• Un framework MCP-compatible d'agents. L'agent doit être en mesure d'envoyer des requêtes HTTP SigV4-signed streamables au point de terminaison MCP. Le SDK Strands Agents fournit un support client MCP natif, ou vous pouvez utiliser n'importe quel framework avec le transport mcp-proxy-for-aws.

• Python 3.10 ou version ultérieure. Aucun système d'exploitation spécifique n'est requis.

Étape 1 : créer une pile avec l'accès aux agents activé

Créez une pile d' WorkSpaces applications avec l'accès aux agents activé pour permettre aux agents IA d'interagir avec les applications de bureau.

Utilisation de AWS Console de gestion

Pour créer une pile avec accès aux agents

1. Ouvrez la console WorkSpaces Applications.

2. Dans le volet de navigation de gauche, choisissez Stacks, puis Create Stack.

3. Sur la page de détails du Stack (étape 1 de 4), sous Accès à l'agent AI, sélectionnez Activer l'accès à l'agent AI. Choisissez Suivant.

4. Sur la page Activer le stockage (étape 2 de 4), activez éventuellement les dossiers personnels pour permettre à votre agent d'enregistrer des fichiers dans un compartiment Amazon S3 de votre AWS compte. La flotte associée à cette pile doit autoriser l'accès à Amazon S3 via Internet ou via un point de terminaison Amazon VPC pour Amazon S3. Choisissez Suivant.

5. Sur la page Modifier les paramètres de l'agent (étape 3 de 4), configurez les éléments suivants :

   • Activer la saisie par ordinateur : autorise les agents à choisir des boutons, à saisir du texte et à faire défiler le texte sur le bureau. Si vous activez la saisie par ordinateur, vous devez également activer la vision par ordinateur.

   • Activer la vision par ordinateur : autorisez les agents à voir le bureau.

   • Stockage des captures d'écran : configurez l'emplacement où les captures d'écran des agents sont stockées pendant les sessions de streaming. Si cette option est activée, fournissez un compartiment Amazon S3 dans lequel vous êtes autorisé à écrire.

   • Résolution d'écran : sélectionnez la résolution d'affichage pour l'environnement de streaming de l'agent (1280 x 720).

   • Type d'image d'écran — Sélectionnez le format d'image pour les captures d'écran de l'agent (PNG ou JPEG).

   • Persistance des paramètres de l'application : activez-la éventuellement pour enregistrer les personnalisations des applications de votre agent et les paramètres Windows entre les sessions. Les paramètres sont enregistrés dans un compartiment Amazon S3 de votre AWS compte.

   Note

   Vous devez activer au moins l'une des options suivantes : saisie par ordinateur ou vision par ordinateur.

   Choisissez Suivant.

6. Sur la page Révision et création (étape 4 de 4), passez en revue vos paramètres et choisissez Create Stack.

Utilisation de AWS CLI

Exécutez la commande suivante pour créer une pile avec l'accès aux agents activé :

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"
    }'

Pour activer également le stockage des captures d'écran, ajoutez les ScreenshotsUploadEnabled paramètres S3BucketArn et :

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

Après avoir créé la pile, associez-la à une flotte. Les agents ne peuvent pas se connecter à une pile à laquelle aucune flotte n'est associée.

aws appstream associate-fleet \
    --stack-name your-stack-name \
    --fleet-name your-fleet-name

Étape 2 : générer une URL de streaming

Créez une URL de streaming à l'aide de l'CreateStreamingURLAPI WorkSpaces d'applications standard. Vous n'avez pas besoin de paramètres spécifiques à l'agent. La configuration d'accès à l'agent de la pile détermine le comportement spécifique à l'agent.

Utilisation de AWS Console de gestion

Pour générer une URL de streaming à l'aide de la console

1. Ouvrez la console WorkSpaces Applications.

2. Dans le volet de navigation de gauche, choisissez Stacks, puis choisissez la pile que vous avez créée avec l'accès aux agents activé.

3. Cliquez sur le bouton Actions, puis dans le menu déroulant, sélectionnez Créer une URL de diffusion. Votre pile doit être sélectionnée pour que cette option soit disponible.

4. Dans la section UserID, entrez un utilisateur. Vous pouvez participer TestUser si vous testez.

5. Dans la section Expiration de l'URL, sélectionnez l'heure à laquelle vous souhaitez que l'URL soit valide. Une durée plus courte est recommandée. La valeur par défaut est de 30 minutes et elle est recommandée pour les tests.

6. Choisissez GetURL et copiez l'URL générée.

Utilisation de AWS CLI

Exécutez la commande suivante pour générer une 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 réponse inclut un message StreamingURL que vous transmettez à votre agent à l'étape suivante. L'URL est valide pendant la durée spécifiée par le --validity paramètre.

Étape 3 : Connectez votre agent au service MCP

Votre agent se connecte au service MCP géré au point de terminaison fixe suivant :

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

La connexion utilise la signature SigV4 avec le nom agentaccess-mcp du service. Vous transmettez l'URL de diffusion de l'étape 2 sous forme d'en-tête pour chaque demande MCP.

L'exemple suivant montre comment établir la connexion à l'aide de 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,
    },
)

Une fois connecté, l'agent peut utiliser les outils MCP pour saisir du texte, choisir des boutons et prendre des captures d'écran du bureau.

Étape 4 : vérifier l'activité de l'agent

Vous pouvez vérifier l'activité de l'agent à l'aide AWS des services suivants :

• AWS CloudTrail— AWS CloudTrail enregistre les événements de session de l'agent. Ouvrez la AWS CloudTrail console pour voir l'activité de l'agent.

• CloudWatch— CloudWatch fournit des mesures opérationnelles pour les sessions des agents. Ouvrez la CloudWatch console pour consulter les métriques.

• Amazon S3 — Si vous avez activé le stockage des captures d'écran, Amazon S3 stocke les captures d'écran dans le compartiment que vous avez spécifié lors de la configuration de la pile.

Étape 5 : Nettoyer les ressources

Pour éviter des frais récurrents, supprimez la pile que vous avez créée dans ce didacticiel. Vous devez arrêter la flotte et la dissocier de la pile avant de pouvoir supprimer la pile. En option, vous pouvez également supprimer la flotte.

Utilisation de AWS Console de gestion

Pour nettoyer des ressources

1. Ouvrez la console WorkSpaces Applications.

2. Dans le volet de navigation de gauche, choisissez Flottes.

3. Sélectionnez le parc associé à la pile. Choisissez Actions, puis Arrêter. Attendez que la flotte s'arrête.

4. Dans le volet de navigation de gauche, choisissez Stacks (Piles).

5. Sélectionnez la pile que vous avez créée, puis choisissez Actions, Dissocier la flotte.

6. La pile étant toujours sélectionnée, choisissez Actions, Supprimer.

7. (Facultatif) Pour supprimer la flotte, dans le volet de navigation de gauche, sélectionnez Fleets. Sélectionnez la flotte et choisissez Actions, Supprimer.

Utilisation de AWS CLI

Exécutez les commandes suivantes pour nettoyer les ressources :

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

(Facultatif) Pour supprimer également la flotte après son arrêt :

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