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 un accès aux WorkSpaces applications

Pour permettre aux agents IA d'exploiter des applications de bureau via Amazon WorkSpaces Applications, vous devez créer une pile dont l'accès est activé pour les agents, générer une URL de diffusion et connecter votre agent au service 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 le GitHub référentiel : sample-code-for-workspaces-agent-access.

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

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

Conditions préalables

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

Étape 1 : Création d'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

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"},
            {"AgentAction": "FORWARD_MCP_TOOLS", "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"},
            {"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-name your-stack-name \
    --fleet-name your-fleet-name

Étape 2 : Générez une URL de diffusion

Créez une URL de streaming à l'aide de l'CreateStreamingURLAPI WorkSpaces Applications standard. 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

Utilisation de AWS CLI

Exécutez la commande suivante pour générer une URL de diffusion :

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 transmettrez à 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é sur le 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. Votre agent signe chaque demande à l'aide des AWS informations d'identification configurées dans les prérequis avec les 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é des agents à l'aide AWS des services suivants :

É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

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