Mode koneksi

Anda dapat mengontrol bagaimana agen Anda menunggu sesi desktop tersedia dengan menyetel x-amzn-agentaccess-connect-mode header pada permintaan Model Context Protocol (MCP) Anda.

catatan

Mode koneksi berlaku untuk armada yang tidak bergabung dengan domain dan armada yang bergabung dengan domain. Atur x-amzn-agentaccess-connect-mode header di samping mekanisme otentikasi mana pun yang digunakan jenis armada Anda. Untuk armada yang tidak bergabung dengan domain, itu adalah header stack dan user ID atau header Streaming URL. Untuk armada yang bergabung dengan domain, ini adalah metadata pernyataan SAML.

Mode berikut tersedia:

• MEMBLOKIR (default): server MCP menunggu sampai koneksi desktop sepenuhnya terbentuk sebelum merespons. Kapan tools/list kembali, semua alat segera tersedia.

• PEMUNGUTAN SUARA: server MCP merespons segera tanpa menunggu koneksi desktop. Awalnya, hanya connection_status alat tersedia. Agen Anda mensurvei alat ini sampai koneksi dibuat, di mana set alat lengkap tersedia.

Gunakan mode POLLING saat Anda ingin agen melakukan pekerjaan lain sambil menunggu koneksi desktop, atau ketika Anda memerlukan kontrol lebih besar atas perilaku batas waktu koneksi.

Contoh berikut menunjukkan cara menggunakan mode POLLING:

# 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()

Bersihkan: Untuk menghindari biaya streaming yang sedang berlangsung, akhiri WorkSpaces Sesi streaming aplikasi saat agen Anda menyelesaikan pekerjaannya. Putuskan sambungan agen sehingga sesi ditutup, dan jangan biarkan sesi idle berjalan.