View a markdown version of this page

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

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 Folgendes zu gewähren WorkSpaces Anwendungen

Um KI-Agenten den Betrieb von Desktop-Anwendungen über Amazon zu ermöglichen WorkSpaces Bei Anwendungen erstellen Sie einen Stack mit aktiviertem Zugriff für Agenten, generieren eine Streaming-URL und verbinden Ihren Agenten mit dem verwalteten MCP-Server.

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 verfügbar in der GitHub Endlager — Beispielcode für Workspaces-Agent-Zugriff.

Die Fertigstellung dieses Tutorials dauert ungefähr 15 Minuten.

Wichtig

Die Ressourcen, die Sie in diesem Tutorial erstellen, können zu Gebühren für Sie führen AWS Konto. Löschen Sie den Stack und stoppen Sie die Flotte, wenn Sie fertig sind, um laufende Gebühren zu vermeiden.

In diesem Tutorial erledigst du die folgenden Aufgaben:

  • Schritt 1: Erstellen Sie einen Stack mit aktiviertem Agentenzugriff

  • Schritt 2: Generieren Sie eine Streaming-URL

  • Schritt 3: Verbinden Sie Ihren Agenten mit dem MCP-Server

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

  • Schritt 5: Bereinigen von -Ressourcen

Schreiben Sie den Agentencode mit dem Agent Toolkit for AWS

Wenn Sie Ihren Agenten mit einem KI-Codierungsassistenten erstellen, können Sie den verwenden Agenten-Toolkit für AWS. Es hilft Ihnen, den Agentenzugriff einzurichten und Ihren ersten Agenten zu erstellen.

Das Toolkit verwendet das AWS MCP-Server. Dieser verwaltete Server bietet Agenten sicheren Zugriff auf AWS über das Model Context Protocol (MCP). Agenten können ausgeführt werden AWS CLI Befehle, Suche AWS Dokumente und folgen Sie vorgefertigten Fähigkeiten. Sie verbinden sich über einen sicheren Endpunkt. Sie erhalten auch CloudWatch Metriken und IAM-Zugriffskontrollen.

Fragen Sie zunächst Ihren Agenten: „Helfen Sie mir, die ersten Schritte abzuschließen WorkSpaces Tutorial zum Agentenzugriff“.

Voraussetzungen

Bevor Sie beginnen, überprüfen Sie die Anforderungen für den Agentenzugriff. Informationen zum Konto, zur Flotte, zu den Berechtigungen und zu den Voraussetzungen für Agenten finden Sie unter Voraussetzungen.

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

Um einen Stack mit Agentenzugriff zu erstellen
  1. Öffnen Sie das WorkSpaces Konsole für Anwendungen.

  2. Wählen Sie im linken Navigationsbereich Stapel, dann wähle Stapel erstellen.

  3. Auf der Details zum Stapel Seite (Schritt 1 von 4), unter Zugriff auf AI-Agenten, wählen Aktivieren Sie den Zugriff auf AI-Agenten. Wählen Sie Weiter aus.

  4. Auf der Speicher aktivieren Seite (Schritt 2 von 4), optional aktivieren Home-Ordner um Ihrem Agenten zu ermöglichen, Dateien in einem Amazon S3-Bucket in Ihrem zu speichern AWS Konto. Die mit diesem Stack verknüpfte Flotte muss den Zugriff auf Amazon S3 über das Internet oder einen Amazon VPC-Endpunkt für Amazon S3 ermöglichen. Wählen Sie Weiter aus.

  5. Auf der Agenteneinstellungen bearbeiten Seite (Schritt 3 von 4), konfigurieren Sie Folgendes:

    • Computereingabe aktivieren — Erlauben Sie Agenten, Schaltflächen auszuwählen, Text einzugeben und auf dem Desktop zu scrollen. Wenn Sie die Computereingabe aktivieren, müssen Sie auch Computer Vision aktivieren.

    • Aktivieren Sie Computer Vision — Erlauben Sie den Agenten, den Desktop zu sehen.

    • Speicherung von Screenshots — Konfigurieren Sie, wo Agenten-Screenshots während Streaming-Sitzungen gespeichert werden. Falls aktiviert, geben Sie einen Amazon S3-Bucket an, für den Sie Schreibberechtigungen haben.

    • Bildschirmauflösung — Wählen Sie die Bildschirmauflösung für die Agenten-Streaming-Umgebung (1280 x 720).

    • Typ des Bildschirmbilds — Wählen Sie das Bildformat für Agenten-Bildschirmaufnahmen (PNG oder JPEG).

    • Persistenz der Anwendungseinstellungen — Aktivieren Sie diese Option optional, um die Anwendungsanpassungen und Windows-Einstellungen Ihres Agenten zwischen den Sitzungen zu speichern. Die Einstellungen werden in einem Amazon S3-Bucket in Ihrem gespeichert AWS Konto. Diese Einstellung ist unter Windows verfügbar und wird unter Linux nicht unterstützt.

    • Aktivieren Sie die MCP-Tool-Weiterleitung — Ermöglichen Sie es Agenten, über direkte MCP-Aufrufe mit Anwendungen und dem Desktop-Betriebssystem zu interagieren, anstatt Computertools zu verwenden. Wenn diese Option aktiviert ist, werden die MCP-Tools auf dem konfiguriert WorkSpaces Anwendungssitzungen werden an den Agenten weitergeleitet. Für die Tool-Weiterleitung ist auch eine Konfigurationsdatei auf dem Image erforderlich. Den plattformspezifischen Pfad und die Einrichtungsschritte finden Sie unter Tool-Forwarding einrichten.

    • Aktivieren Sie den Benutzersteuerungsmodus — Erlauben Sie Benutzern, Agentensitzungen in Echtzeit über ihren Browser zu beobachten. Beobachter sehen eine Live-Ansicht des Desktops, während der Agent arbeitet. Im VIEW_STOP-Modus können Beobachter den Agenten mithilfe einer Schaltfläche am oberen Bildschirmrand stoppen. Nachdem der Agent beendet wurde, muss er eine neue Sitzung starten, um wieder aufgenommen zu werden.

    Anmerkung

    Sie müssen mindestens Computereingabe oder Computer Vision aktivieren.

    Wählen Sie Weiter aus.

  6. Auf der Überprüfen und erstellen Seite (Schritt 4 von 4), überprüfe deine Einstellungen und wähle Stapel erstellen.

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 den S3BucketArn und ScreenshotsUploadEnabled Parameter:

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 des Standards WorkSpaces Anwendungen CreateStreamingURL API. Sie benötigen keine agentenspezifischen Parameter. Die Agentenzugriffskonfiguration des Stacks bestimmt das agentenspezifische Verhalten.

Verwendung der AWS Management Console

Um eine Streaming-URL mithilfe der Konsole zu generieren
  1. Öffnen Sie das WorkSpaces Konsole für Anwendungen.

  2. Wählen Sie im linken Navigationsbereich Stapelund wählen Sie dann den Stack aus, den Sie mit aktiviertem Agentenzugriff erstellt haben.

  3. Wählen Sie den Aktionen klicken Sie auf die Schaltfläche und wählen Sie in der Dropdownliste Streaming-URL erstellen. Ihr Stack muss ausgewählt sein, damit diese Option verfügbar ist.

  4. In der Benutzer-ID Abschnitt, geben Sie einen Benutzer ein. Sie können eingeben TestUser wenn Sie testen.

  5. In der Ablauf der URL Abschnitt, wählen Sie den Zeitpunkt aus, zu dem die URL gültig sein soll. Eine kürzere Zeit wird empfohlen. Die Standardeinstellung ist 30 Minuten, was zum Testen empfohlen wird.

  6. Wählen Sie URL abrufen und kopiere die generierte URL.

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 beinhaltet eine StreamingURL das Sie im nächsten Schritt an Ihren Agenten weitergeben. Die URL ist für die von der angegebene Dauer gültig --validity Parameter.

Anmerkung

Zu einem bestimmten Zeitpunkt kann nur ein Agent eine Verbindung zu einer bestimmten Sitzung herstellen. Benannte Benutzer, angegeben durch das UserId Parameter, kann jeweils nur eine aktive Sitzung pro Flotte haben. Um mehrere Agenten gleichzeitig ausführen zu können, muss jeder Agent eine Verbindung zu seiner eigenen Sitzung herstellen.

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

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

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

Ersetzen region mit Ihrem Regionalcode. Die unterstützten Regionen und ihre Endpunkte finden Sie unter WorkSpaces Anwendungen (MCP-Endpunkte).

Die Verbindung verwendet die SigV4-Signatur mit dem Dienstnamen agentaccess-mcp. Ihr Agent signiert jede Anfrage mit dem AWS Anmeldeinformationen, die in den Voraussetzungen mit dem konfiguriert wurden agentaccess-mcp:* Berechtigungen. 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 wie folgt überprüfen AWS Dienstleistungen:

  • AWS CloudTrail — AWS CloudTrail protokolliert Agenten-Sitzungsereignisse. Öffnen Sie das AWS CloudTrail Konsole zum Anzeigen der Agentenaktivitäten. Tool-Aufrufe werden als Datenereignisse protokolliert. Dafür ist ein Pfad erforderlich, der wie folgt konfiguriert ist Datenereignisse protokollieren.

  • CloudWatch — CloudWatch bietet Betriebsmetriken für Agentensitzungen. Öffnen Sie das CloudWatch Konsole zum Anzeigen von Metriken.

  • Amazon S3 — Wenn Sie den Screenshot-Speicher aktiviert haben, speichert Amazon S3 die Screenshots in dem Bucket, den Sie bei der Stack-Konfiguration angegeben haben.

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

So bereinigen Sie Ressourcen
  1. Öffnen Sie das WorkSpaces Konsole für Anwendungen.

  2. Wählen Sie im linken Navigationsbereich Fleets (Flotten) aus.

  3. Wählen Sie die Flotte aus, die dem Stack zugeordnet ist. Wählen Sie Actions und Stop aus. Warten Sie, bis die Flotte stoppt.

  4. Wählen Sie im linken Navigationsbereich Stack aus.

  5. Wählen Sie den Stack aus, den Sie erstellt haben, und wählen Sie Aktionen, Flotte trennen.

  6. Wählen Sie bei noch ausgewähltem Stapel Aktionen, Löschen.

  7. (Optional) Um die Flotte zu löschen, wählen Sie im linken Navigationsbereich Flotten. Wählen Sie die Flotte aus und wählen Sie Aktionen, Löschen.

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