Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Pelajari selengkapnya tentang akses agen WorkSpaces
WorkSpaces Aplikasi Amazon memungkinkan agen untuk terhubung ke sesi streaming dan berinteraksi dengan aplikasi desktop melalui layanan Model Context Protocol (MCP) yang dikelola. Topik ini menjelaskan cara agen mengakses WorkSpaces Aplikasi dan kemampuan yang dapat Anda konfigurasikan.
Prasyarat
Untuk menggunakan akses agen, Anda memerlukan yang berikut:
-
Armada WorkSpaces Aplikasi Amazon yang aktif (Always-On atau On-Demand). Jika Anda belum membuat armada, lihatMemulai WorkSpaces Aplikasi Amazon: Mengatur Dengan Contoh Aplikasi.
-
Tumpukan yang terkait dengan armada. Agen tidak dapat terhubung ke tumpukan tanpa armada terkait.
-
AWS Akun dengan izin untuk membuat dan mengelola tumpukan WorkSpaces Aplikasi Amazon.
-
Jika Anda berencana untuk mengaktifkan penyimpanan tangkapan layar, ember Amazon S3. Kebijakan bucket harus memberikan akses prinsipal AppStream layanan ke bucket daftar. Agen yang terhubung ke layanan MCP harus memiliki
s3:PutObjectizin di bucket. -
Armada yang menjalankan Agen WorkSpaces Aplikasi terbaru. Untuk membaca lebih lanjut tentang memperbarui Agen WorkSpaces Aplikasi Anda, lihatSimpan Gambar WorkSpaces Aplikasi Amazon Anda Up-to-Date. Untuk informasi tentang mengelola versi agen, lihat Mengelola versi agen.
Batasan
WorkSpaces konfigurasi akses agen memiliki batasan berikut:
-
Hanya gambar Windows Server yang didukung.
-
Titik akhir VPC tidak didukung.
-
Multi-session armada tidak didukung.
-
Armada elastis tidak didukung.
Cara kerja akses agen
Anda mengaktifkan akses agen saat membuat tumpukan. Saat akses agen diaktifkan, tumpukan dikonfigurasi dengan pengaturan khusus agen, bukan konfigurasi WorkSpaces Aplikasi Amazon untuk pengguna manusia. Anda dapat mengaktifkan akses agen melalui konsol WorkSpaces Aplikasi Amazon AWS CLI, atau API.
Input dan visi komputer
Akses agen menyediakan dua kemampuan interaksi yang Anda konfigurasikan di tingkat tumpukan:
-
Input komputer - Memungkinkan agen untuk mengklik tombol, memasukkan teks, dan menggulir di desktop selama sesi streaming.
-
Visi komputer - Memungkinkan agen melihat desktop dengan mengambil tangkapan layar selama sesi streaming.
Anda harus mengaktifkan setidaknya satu dari kemampuan ini.
Penyimpanan tangkapan layar
Anda dapat mengonfigurasi penyimpanan tangkapan layar secara opsional untuk sesi agen. Saat penyimpanan tangkapan layar diaktifkan, tangkapan layar yang diambil selama sesi agen disimpan dalam bucket Amazon S3. Layanan MCP menggunakan kredensyal agen penghubung untuk mengunggah tangkapan layar ke bucket. Agen harus memiliki s3:PutObject izin di ember.
Tata letak layar desktop
Anda mengonfigurasi resolusi layar dan format gambar untuk lingkungan streaming agen:
-
Resolusi layar - Resolusi tampilan untuk lingkungan streaming agen. Resolusi yang didukung adalah 1280x720.
-
Jenis gambar layar - Format gambar untuk tangkapan layar agen. Anda dapat memilih PNG atau JPEG.
Penyimpanan folder rumah
Anda dapat mengaktifkan folder rumah sehingga file agen disimpan ke bucket Amazon S3 di akun Anda AWS . Armada WorkSpaces Aplikasi Amazon yang terkait dengan tumpukan harus mengizinkan akses ke Amazon S3 melalui internet atau titik akhir VPC Amazon S3. Untuk informasi selengkapnya, lihat Mengaktifkan dan mengelola folder beranda untuk pengguna Anda.
Ketekunan pengaturan aplikasi
Anda dapat mengaktifkan persistensi pengaturan aplikasi secara opsional. Saat diaktifkan, penyesuaian aplikasi agen Anda dan pengaturan Windows disimpan setelah setiap sesi streaming dan diterapkan selama sesi berikutnya. Pengaturan ini disimpan ke bucket Amazon S3 di akun Anda AWS . Armada WorkSpaces Aplikasi Amazon yang terkait dengan tumpukan harus mengizinkan akses ke Amazon S3 melalui internet atau titik akhir VPC Amazon S3. Untuk informasi selengkapnya, lihat Mengaktifkan persistensi setelan aplikasi untuk pengguna Anda.
Penerusan alat MCP
Anda dapat mengaktifkan penerusan alat MCP untuk memungkinkan agen berinteraksi dengan aplikasi dan sistem operasi desktop melalui panggilan MCP langsung daripada menggunakan alat penggunaan komputer. Saat diaktifkan, alat MCP yang tersedia di sesi WorkSpaces aplikasi Anda diteruskan ke agen. Alat yang diteruskan muncul ketika agen mencantumkan alat yang tersedia.
Mode kontrol pengguna
Anda dapat mengaktifkan mode kontrol pengguna untuk memungkinkan pengguna mengamati dan berinteraksi dengan sesi agen secara real time. Saat mode kontrol pengguna diaktifkan, pengamat terhubung ke sesi melalui browser mereka menggunakan URL streaming. Mereka melihat tampilan real-time desktop saat agen berinteraksi dengannya.
Dalam VIEW_STOP mode, tombol berhenti muncul di bagian atas layar pengamat. Pengamat dapat menggunakan tombol ini untuk menghentikan agen jika diperlukan. Setelah agen dihentikan, ia harus memulai sesi baru untuk melanjutkan pekerjaan.
Atur UserControlMode atribut AgentAccessConfig ke salah satu nilai berikut:
-
VIEW_ONLY— Pengguna dapat melihat dan mengamati tindakan agen saat terjadi. -
VIEW_STOP— Pengguna dapat melihat tindakan agen dan menghentikan agen jika diperlukan. -
DISABLED— Pengguna tidak dapat melihat atau menghentikan sesi agen.
URL Streaming
Agen terhubung ke WorkSpaces Aplikasi melalui URL streaming. Anda menghasilkan URL streaming dengan menggunakan CreateStreamingURL API. Tidak diperlukan parameter khusus agen. Perilaku khusus agen ditentukan oleh konfigurasi akses agen stack. URL streaming diteruskan ke layanan MCP sebagai header pada setiap permintaan.
Untuk informasi selengkapnya tentang CreateStreamingURL API, lihat CreateStreamingURL di Referensi API Amazon AppStream 2.0.
Proksi MCP untuk AWS
Untuk menghubungkan agen Anda ke layanan MCP terkelola, Anda dapat menggunakan mcp-proxy-for-aws transport untuk membuat klien MCP yang mendukung penandatanganan SiGv4 permintaan MCP dengan Python. Jika Anda membangun agen dalam bahasa lain, Anda perlu menulis logika penandatanganan sendiri atau menemukan perpustakaan yang tersedia.
Untuk informasi lebih lanjut, lihat mcp-proxy-for-aws
Memantau
Anda dapat memantau aktivitas agen melalui layanan berikut:
-
AWS CloudTrail— Acara sesi agen masuk CloudTrail. Anda dapat melihat kapan agen terhubung, alat mana yang mereka gunakan, dan kapan sesi berakhir. Panggilan alat adalah peristiwa data dan mengharuskan Anda menyiapkan jejak untuk mencatat peristiwa data. Untuk informasi selengkapnya, lihat Mencatat peristiwa data dalam CloudTrail Panduan Pengguna.
-
CloudWatch— Metrik operasional berikut tersedia CloudWatch untuk sesi agen:
InvocationsLatencyClientErrorsServerErrorsMcpSessionStartMcpSessionDuration
-
Amazon S3 — Jika Anda mengonfigurasi penyimpanan tangkapan layar, tangkapan layar yang diambil selama sesi agen tersedia di bucket Amazon S3 yang Anda tentukan.
