Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Commencez à fournir aux agents l'accès à WorkSpaces Demandes
Pour permettre aux agents IA de gérer 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 diffusion et vous connectez votre agent au serveur MCP géré.
Si vous configurez l'accès des agents pour la première fois, vous pouvez utiliser l'expérience de démarrage rapide Build Your First Agent. Vous pouvez également suivre les étapes décrites dans cette rubrique pour configurer l'accès des agents manuellement. L'expérience de démarrage rapide est disponible dans GitHub référentiel — exemple de code pour l'accès des agents aux espaces de travail
Ce didacticiel dure environ 15 minutes.
Les ressources que vous créez dans ce didacticiel peuvent entraîner des frais pour votre AWS compte. Supprimez la pile et arrêtez la flotte lorsque vous avez terminé pour éviter des charges continues.
Dans ce didacticiel, vous allez effectuer les tâches suivantes :
Étape 1 : Création d'une pile avec l'accès aux agents activé
Étape 2 : générer une URL de diffusion
Étape 3 : connectez votre agent au serveur MCP
Étape 4 : vérifier l'activité de l'agent
Étape 5 : Nettoyer les ressources
Rédigez le code de l'agent à l'aide de l'Agent Toolkit pour AWS
Si vous créez votre agent à l'aide d'un assistant de codage IA, vous pouvez utiliser le Kit d'outils pour les agents pour AWS
La boîte à outils utilise AWS Serveur MCP. Ce serveur géré permet aux agents d'accéder en toute sécurité à AWS via le Model Context Protocol (MCP). Les agents peuvent exécuter AWS CLI commandes, recherche AWS docs, et suivez des compétences prêtes à l'emploi. Ils se connectent via un point de terminaison sécurisé. Vous obtenez également CloudWatch métriques et contrôles d'accès IAM.
Pour commencer, demandez à votre agent « Aidez-moi à terminer la procédure de démarrage ». WorkSpaces tutoriel d'accès aux agents ».
Conditions préalables
Avant de commencer, passez en revue les conditions d'accès des agents. Pour connaître les prérequis relatifs au compte, à la flotte, aux autorisations et aux agents, voir Conditions préalables.
Étape 1 : Création d'une pile avec l'accès aux agents activé
Créez un WorkSpaces Les applications s'empilent et l'accès aux agents est 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
-
Ouvrez le WorkSpaces Console d'applications
. -
Dans le volet de navigation de gauche, choisissez Piles, puis choisissez Créer une pile.
-
Sur le Détails de la pile page (étape 1 de 4), sous Accès aux agents IA, sélectionnez Activer l'accès des agents IA. Choisissez Suivant.
-
Sur le Activer le stockage page (étape 2 de 4), activer éventuellement Dossiers d'accueil 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 un point de terminaison Amazon VPC pour Amazon S3. Choisissez Suivant.
-
Sur le Modifier les paramètres de l'agent page (étape 3 de 4), configurez les éléments suivants :
-
Activer la saisie informatique — Autorisez les agents à choisir des boutons, à saisir du texte et à faire défiler la page sur le bureau. Si vous activez la saisie par ordinateur, vous devez également activer la vision par ordinateur.
-
Activez la vision par ordinateur — Autorisez les agents à voir le bureau.
-
Stockage des captures d'écran — Configurez l'endroit où les captures d'écran des agents sont stockées pendant les sessions de streaming. Si cette option est activée, indiquez un compartiment Amazon S3 dans lequel vous êtes autorisé à écrire.
-
Résolution de l'écran — Sélectionnez la résolution d'affichage pour l'environnement de streaming de l'agent (1280x720).
-
Type d'image d'écran — Sélectionnez le format d'image pour les captures d'écran des agents (PNG ou JPEG).
-
Persistance des paramètres de l'application — Activez cette option pour enregistrer les personnalisations des applications et les paramètres Windows de votre agent entre les sessions. Les paramètres sont enregistrés dans un compartiment Amazon S3 de votre AWS compte. Ce paramètre est disponible sous Windows et n'est pas pris en charge sous Linux.
-
Activer le transfert d'outils MCP — Autorisez les agents à interagir avec les applications et le système d'exploitation de bureau par le biais d'appels MCP directs plutôt que d'utiliser des outils informatiques. Lorsque cette option est activée, les outils MCP sont configurés sur le WorkSpaces les sessions d'application sont transmises à l'agent. Le transfert d'outils nécessite également un fichier de configuration sur l'image. Pour le chemin et les étapes de configuration spécifiques à la plate-forme, voir Configuration de la redirection d'outils.
-
Activer le mode de contrôle utilisateur — Permettez aux utilisateurs d'observer les sessions des agents en temps réel via leur navigateur. Les observateurs voient une vue en direct du bureau pendant que l'agent travaille. En mode VIEW_STOP, les observateurs peuvent arrêter l'agent à l'aide d'un bouton en haut de l'écran. Une fois que l'agent s'arrête, il doit démarrer une nouvelle session pour reprendre.
NoteVous devez activer au moins l'une des options de saisie par ordinateur ou de vision par ordinateur.
Choisissez Suivant.
-
-
Sur le Réviser et créer page (étape 4 de 4), vérifiez vos paramètres et choisissez Créer une pile.
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 \ --nameyour-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" }'
Pour activer également le stockage des captures d'écran, ajoutez le S3BucketArn et ScreenshotsUploadEnabled paramètres :
aws appstream create-stack \ --nameyour-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 }'
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-nameyour-stack-name\ --fleet-nameyour-fleet-name
Étape 2 : générer une URL de diffusion
Créez une URL de streaming à l'aide de la norme WorkSpaces Demandes CreateStreamingURL API. Vous n'avez pas besoin de paramètres spécifiques à l'agent. La configuration d'accès aux agents de la pile détermine le comportement spécifique de l'agent.
Utilisation de AWS Console de gestion
Pour générer une URL de diffusion à l'aide de la console
-
Ouvrez le WorkSpaces Console d'applications
. -
Dans le volet de navigation de gauche, choisissez Piles, puis choisissez la pile que vous avez créée avec l'accès des agents activé.
-
Choisissez le Actions bouton, et dans la liste déroulante, sélectionnez Créer une URL de diffusion. Votre pile doit être sélectionnée pour que cette option soit disponible.
-
Dans le ID utilisateur section, entrez un utilisateur. Vous pouvez entrer
TestUsersi vous testez. -
Dans le Expiration d'URL section, 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, ce qui est recommandé pour les tests.
-
Choisissez Obtenir l'URL et copiez l'URL générée.
Utilisation de AWS CLI
Exécutez la commande suivante pour générer une URL de diffusion :
aws appstream create-streaming-url \ --stack-nameyour-stack-name\ --fleet-nameyour-fleet-name\ --user-idyour-agent-id\ --validity 3600
La réponse comprend un StreamingURL que vous transmettez à votre agent à l'étape suivante. L'URL est valide pendant la durée spécifiée par --validity paramètre.
À tout moment, un seul agent peut se connecter à une session unique. Utilisateurs nommés, spécifiés via le UserId paramètre, ne peut avoir qu'une seule session active par flotte à la fois. Pour exécuter plusieurs agents simultanément, chaque agent doit se connecter à sa propre session.
Étape 3 : connectez votre agent au serveur MCP
Votre agent se connecte au serveur MCP géré sur le point de terminaison fixe suivant :
https://agentaccess-mcp.region.api.aws/mcp
Remplacer region avec votre code de région. Pour les régions prises en charge et leurs points de terminaison, voir WorkSpaces Points de terminaison MCP pour applications.
La connexion utilise la signature SIGv4 avec le nom du service agentaccess-mcp. Votre agent signe chaque demande à l'aide du AWS
informations d'identification configurées dans les prérequis avec agentaccess-mcp:* autorisations. Vous transmettez l'URL de streaming de l'étape 2 en tant qu'en-tête sur chaque requête 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, sélectionner 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 des méthodes suivantes AWS services :
-
AWS CloudTrail — AWS CloudTrail enregistre les événements de session de l'agent. Ouvrez le AWS CloudTrail console pour visualiser l'activité des agents. Les appels d'outils sont enregistrés en tant qu'événements de données, ce qui nécessite un suivi configuré pour enregistrer les événements liés aux données.
-
CloudWatch — CloudWatch fournit des mesures opérationnelles pour les sessions des agents. Ouvrez le CloudWatch console pour afficher les statistiques.
-
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 permanents, 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. Vous pouvez également supprimer la flotte si vous le souhaitez.
Utilisation de AWS Console de gestion
Pour nettoyer des ressources
-
Ouvrez le WorkSpaces Console d'applications
. -
Dans le volet de navigation de gauche, choisissez Flottes.
-
Sélectionnez la flotte associée à la pile. Choisissez Actions, puis Arrêter. Attendez que la flotte s'arrête.
-
Dans le volet de navigation de gauche, choisissez Stacks (Piles).
-
Sélectionnez la pile que vous avez créée, puis choisissez Actions, Dissocier la flotte.
-
La pile étant toujours sélectionnée, choisissez Actions, Supprimer.
-
(Facultatif) Pour supprimer la flotte, dans le volet de navigation de gauche, choisissez Flottes. 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 \ --nameyour-fleet-nameaws appstream disassociate-fleet \ --stack-nameyour-stack-name\ --fleet-nameyour-fleet-nameaws appstream delete-stack \ --nameyour-stack-name
(Facultatif) Pour supprimer également la flotte après son arrêt :
aws appstream delete-fleet \ --nameyour-fleet-name