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.
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
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
-
Öffnen Sie das WorkSpaces Konsole für Anwendungen
. -
Wählen Sie im linken Navigationsbereich Stapel, dann wähle Stapel erstellen.
-
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.
-
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.
-
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.
AnmerkungSie müssen mindestens Computereingabe oder Computer Vision aktivieren.
Wählen Sie Weiter aus.
-
-
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 \ --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" }'
Um auch das Speichern von Screenshots zu aktivieren, fügen Sie den S3BucketArn und ScreenshotsUploadEnabled Parameter:
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 }'
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-nameyour-stack-name\ --fleet-nameyour-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
-
Öffnen Sie das WorkSpaces Konsole für Anwendungen
. -
Wählen Sie im linken Navigationsbereich Stapelund wählen Sie dann den Stack aus, den Sie mit aktiviertem Agentenzugriff erstellt haben.
-
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.
-
In der Benutzer-ID Abschnitt, geben Sie einen Benutzer ein. Sie können eingeben
TestUserwenn Sie testen. -
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.
-
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-nameyour-stack-name\ --fleet-nameyour-fleet-name\ --user-idyour-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.
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
-
Öffnen Sie das WorkSpaces Konsole für Anwendungen
. -
Wählen Sie im linken Navigationsbereich Fleets (Flotten) aus.
-
Wählen Sie die Flotte aus, die dem Stack zugeordnet ist. Wählen Sie Actions und Stop aus. Warten Sie, bis die Flotte stoppt.
-
Wählen Sie im linken Navigationsbereich Stack aus.
-
Wählen Sie den Stack aus, den Sie erstellt haben, und wählen Sie Aktionen, Flotte trennen.
-
Wählen Sie bei noch ausgewähltem Stapel Aktionen, Löschen.
-
(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 \ --nameyour-fleet-nameaws appstream disassociate-fleet \ --stack-nameyour-stack-name\ --fleet-nameyour-fleet-nameaws appstream delete-stack \ --nameyour-stack-name
(Optional) Um die Flotte auch zu löschen, nachdem sie gestoppt wurde:
aws appstream delete-fleet \ --nameyour-fleet-name