Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Beginnen Sie damit, Agenten Zugriff auf Anwendungen zu WorkSpaces gewähren

Damit KI-Agenten Desktop-Anwendungen über Amazon WorkSpaces Applications ausführen können, erstellen Sie einen Stack mit aktiviertem Zugriff für Agenten, generieren eine Streaming-URL und verbinden Ihren Agenten mit dem verwalteten MCP-Service.

Wenn Sie den Agentenzugriff zum ersten Mal einrichten, können Sie die Schnellstartfunktion Build Your First Agent verwenden. Sie können auch die Schritte in diesem Thema befolgen, um den Agentenzugriff manuell zu konfigurieren. Die Schnellstarterfahrung ist im GitHub Repository verfügbar — Beispielcode-for-workspaces-agent-access.

Die Fertigstellung dieses Tutorials dauert ungefähr 15 Minuten.

In diesem Tutorial erledigst du die folgenden Aufgaben:

Voraussetzungen

Stellen Sie vor dem Beginn sicher, dass Sie über das Folgende verfügen:

Schritt 1: Erstellen Sie einen Stack mit aktiviertem Agentenzugriff

Erstellen Sie einen WorkSpaces Anwendungsstapel mit aktiviertem Agentenzugriff, damit AI-Agenten mit Desktop-Anwendungen interagieren können.

Verwendung der AWS Management Console

Verwendung der AWS CLI

Führen Sie den folgenden Befehl aus, um einen Stack mit aktiviertem Agentenzugriff zu erstellen:

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

Um auch das Speichern von Screenshots zu aktivieren, fügen Sie die ScreenshotsUploadEnabled Parameter S3BucketArn und hinzu:

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

Nachdem Sie den Stack erstellt haben, verknüpfen Sie ihn mit einer Flotte. Agenten können keine Verbindung zu einem Stack herstellen, dem keine Flotte zugeordnet ist.

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

Schritt 2: Generieren Sie eine Streaming-URL

Erstellen Sie eine Streaming-URL mithilfe der WorkSpaces CreateStreamingURL Standardanwendungs-API. Sie benötigen keine agentenspezifischen Parameter. Die Agentenzugriffskonfiguration des Stacks bestimmt das agentenspezifische Verhalten.

Verwendung der AWS Management Console

Verwendung der AWS CLI

Führen Sie den folgenden Befehl aus, um eine Streaming-URL zu generieren:

aws appstream create-streaming-url \
    --stack-name your-stack-name \
    --fleet-name your-fleet-name \
    --user-id your-agent-id \
    --validity 3600

Die Antwort enthält eineStreamingURL, die Sie im nächsten Schritt an Ihren Agenten weitergeben. Die URL ist für die im --validity Parameter angegebene Dauer gültig.

Schritt 3: Verbinden Sie Ihren Agenten mit dem MCP-Dienst

Ihr Agent stellt am folgenden festen Endpunkt eine Verbindung zum verwalteten MCP-Dienst her:

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

Die Verbindung verwendet die SigV4-Signatur mit dem Dienstnamen. agentaccess-mcp Ihr Agent signiert jede Anfrage mit den AWS Anmeldeinformationen, die in den Voraussetzungen mit den agentaccess-mcp:* Berechtigungen konfiguriert wurden. Sie übergeben die Streaming-URL aus Schritt 2 als Header bei jeder MCP-Anfrage.

Das folgende Beispiel zeigt, wie Sie die Verbindung mithilfe von mcp-proxy-for-aws herstellen:

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,
    },
)

Nachdem der Agent eine Verbindung hergestellt hat, kann er die MCP-Tools verwenden, um Text einzugeben, Schaltflächen auszuwählen und Screenshots des Desktops zu erstellen.

Schritt 4: Überprüfen Sie die Agentenaktivität

Sie können die Agentenaktivität mithilfe der folgenden AWS Dienste überprüfen:

Schritt 5: Bereinigen von -Ressourcen

Um laufende Gebühren zu vermeiden, löschen Sie den Stack, den Sie in diesem Tutorial erstellt haben. Sie müssen die Flotte anhalten und ihre Zuordnung zum Stack trennen, bevor Sie den Stack löschen können. Optional können Sie die Flotte auch löschen.

Verwendung der AWS Management Console

Verwendung der AWS CLI

Führen Sie die folgenden Befehle aus, um Ressourcen zu bereinigen:

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

(Optional) Um die Flotte auch zu löschen, nachdem sie gestoppt wurde:

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