View a markdown version of this page

Verbindungsmodi - 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.

Verbindungsmodi

Sie können steuern, wie Ihr Agent darauf wartet, dass die Desktop-Sitzung verfügbar wird, indem Sie Folgendes einstellen x-amzn-agentaccess-connect-mode Header in Ihren Model Context Protocol (MCP) -Anfragen.

Anmerkung

Die Verbindungsmodi gelten sowohl für nicht domänengebundene als auch für domänengebundene Flotten. Stellen Sie das ein x-amzn-agentaccess-connect-mode Header neben dem Authentifizierungsmechanismus, den Ihr Flotten-Typ verwendet. Bei Flotten, die keiner Domain angehören, ist dies entweder der Stack- und Benutzer-ID-Header oder ein Streaming-URL-Header. Bei Flotten, die einer Domäne angehören, sind es die SAML-Assertions-Metadaten.

Die folgenden Modi sind verfügbar:

  • BLOCKIEREN (Standard): Der MCP-Server wartet, bis die Desktop-Verbindung vollständig hergestellt ist, bevor er reagiert. Wann tools/list kehrt zurück, alle Tools sind sofort verfügbar.

  • UMFRAGE: Der MCP-Server reagiert sofort, ohne auf die Desktop-Verbindung zu warten. Anfänglich nur der connection_status Tool ist verfügbar. Ihr Agent fragt dieses Tool ab, bis die Verbindung hergestellt ist. Ab diesem Zeitpunkt ist das gesamte Toolset verfügbar.

Verwenden Sie den POLLING-Modus, wenn Ihr Agent andere Arbeiten ausführen soll, während er auf die Desktop-Verbindung wartet, oder wenn Sie mehr Kontrolle über das Timeout-Verhalten der Verbindung benötigen.

Das folgende Beispiel zeigt, wie der POLLING-Modus verwendet wird:

# Pass the header when creating the MCP connection
headers = {
    "x-amzn-agentaccess-streaming-session-url": streaming_url,  # non-domain-joined fleets
    "x-amzn-agentaccess-connect-mode": "POLLING",
}

# After initialize, tools/list returns immediately with connection_status
tools = await session.list_tools()
# tools = [connection_status]

# Poll connection_status until the desktop is ready
while True:
    result = await session.call_tool("connection_status", {})
    status = json.loads(result.content[0].text)
    if status["state"] == "CONNECTED":
        break
    time.sleep(2)

# Now tools/list returns the full set (screenshot, left_click, type_text, and so on)
tools = await session.list_tools()

Aufräumen: Um laufende Streaming-Gebühren zu vermeiden, beenden Sie das WorkSpaces Streaming-Sitzung für Anwendungen, wenn Ihr Agent seine Arbeit beendet hat. Trennen Sie den Agenten, sodass die Sitzung geschlossen wird, und lassen Sie keine inaktiven Sitzungen laufen.