Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Pelajari lebih lanjut tentang agen yang mengakses WorkSpaces
WorkSpaces Aplikasi Amazon memungkinkan agen untuk terhubung ke sesi streaming dan berinteraksi dengan aplikasi desktop melalui layanan Protokol Konteks Model (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 dengan WorkSpaces Aplikasi Amazon: Mengatur Dengan Aplikasi Contoh.
-
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, bucket Amazon S3. Kebijakan bucket harus memberikan akses utama AppStream layanan ke bucket daftar. Agen yang terhubung ke layanan MCP harus memiliki
s3:PutObjectizin pada 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 M engelola 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.
-
Satu sesi hanya mendukung koneksi agen tunggal.
Cara kerja akses agen
Anda mengaktifkan akses agen saat membuat tumpukan. Saat akses agen diaktifkan, tumpukan dikonfigurasi dengan pengaturan khusus agen alih-alih 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 pada tingkat tumpukan:
-
Masukan komputer - Memungkinkan agen untuk mengklik tombol, memasukkan teks, dan menggulir di desktop selama sesi streaming.
-
Visi komputer - Memungkinkan agen untuk melihat desktop dengan mengambil tangkapan layar selama sesi streaming.
Anda harus mengaktifkan setidaknya satu dari kemampuan ini.
Penyimpanan tangkapan layar
Anda dapat secara opsional mengonfigurasi penyimpanan tangkapan layar untuk sesi agen. Saat penyimpanan tangkapan layar diaktifkan, tangkapan layar yang diambil selama sesi agen disimpan dalam bucket Amazon S3. Layanan MCP menggunakan kredensional 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 AWS akun Anda. Armada WorkSpaces Aplikasi Amazon yang terkait dengan tumpukan harus mengizinkan akses ke Amazon S3 melalui internet atau titik akhir Amazon S3 VPC. Untuk informasi selengkapnya, lihat Mengaktifkan dan mengelola folder beranda untuk pengguna Anda.
Ketekunan pengaturan aplikasi
Anda dapat secara opsional mengaktifkan persistensi pengaturan aplikasi. 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 AWS akun Anda. Armada WorkSpaces Aplikasi Amazon yang terkait dengan tumpukan harus mengizinkan akses ke Amazon S3 melalui internet atau titik akhir Amazon S3 VPC. Untuk informasi selengkapnya, lihat Mengaktifkan persistensi pengaturan 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. Ketika mode kontrol pengguna diaktifkan, pengamat terhubung ke sesi melalui browser mereka menggunakan URL streaming. Mereka melihat tampilan real-time dari 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.
A UserControlMode tur atribut di AgentAccessConfig salah satu nilai berikut:
-
VIEW_ONLY— Pengguna dapat melihat dan mengamati tindakan agen saat itu 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 spesifik 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 CreateStreaming URL 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 transportasi untuk membuat klien MCP yang mendukung penandatanganan permintaan MCP SIGv4 di 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-prox
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.
