Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Mulailah menyediakan agen dengan akses ke WorkSpaces Aplikasi
Untuk mengaktifkan agen AI mengoperasikan aplikasi desktop melalui Amazon WorkSpaces Aplikasi, Anda membuat tumpukan dengan akses diaktifkan untuk agen, membuat URL streaming, dan menghubungkan agen Anda ke server MCP yang dikelola.
Jika Anda menyiapkan akses agen untuk pertama kalinya, Anda dapat menggunakan pengalaman memulai cepat Build Your First Agent. Anda juga dapat mengikuti langkah-langkah dalam topik ini untuk mengonfigurasi akses agen secara manual. Pengalaman mulai cepat tersedia di GitHub repositori — sampel-kode-untuk-ruang kerja-akses-agen
Tutorial ini membutuhkan waktu sekitar 15 menit untuk menyelesaikannya.
Sumber daya yang Anda buat dalam tutorial ini dapat mengakibatkan biaya kepada Anda AWS akun. Hapus tumpukan dan hentikan armada saat Anda selesai untuk menghindari biaya yang sedang berlangsung.
Dalam tutorial ini, Anda menyelesaikan tugas-tugas berikut:
Langkah 1: Buat tumpukan dengan akses agen diaktifkan
Langkah 2: Buat URL streaming
Langkah 3: Hubungkan agen Anda ke server MCP
Langkah 4: Verifikasi aktivitas agen
Langkah 5: Bersihkan Sumber Daya
Tulis kode agen dengan Toolkit Agen untuk AWS
Jika Anda membangun agen Anda dengan asisten pengkodean AI, Anda dapat menggunakan Toolkit Agen untuk AWS
Toolkit menggunakan AWS Server MCP. Server terkelola ini memberi agen akses aman ke AWS melalui Model Context Protocol (MCP). Agen dapat menjalankan AWS CLI perintah, pencarian AWS dokumen, dan ikuti keterampilan yang sudah jadi. Mereka terhubung melalui satu titik akhir yang aman. Anda juga mendapatkan CloudWatch metrik dan kontrol akses IAM.
Untuk memulai, tanyakan kepada agen Anda “Bantu saya menyelesaikan permulaan WorkSpaces tutorial akses agen”.
Prasyarat
Sebelum memulai, tinjau persyaratan akses agen. Untuk prasyarat akun, armada, izin, dan agen, lihat Prasyarat.
Langkah 1: Buat tumpukan dengan akses agen diaktifkan
Buat WorkSpaces Aplikasi menumpuk dengan akses agen yang diaktifkan untuk memungkinkan agen AI berinteraksi dengan aplikasi desktop.
Menggunakan AWS Konsol Manajemen
Untuk membuat tumpukan dengan akses agen
-
Di panel navigasi kiri, pilih Tumpukan, lalu pilih Buat Tumpukan.
-
Pada Rincian tumpukan halaman (langkah 1 dari 4), di bawah Akses agen AI, pilih Aktifkan akses agen AI. Pilih Berikutnya.
-
Pada Aktifkan penyimpanan halaman (langkah 2 dari 4), secara opsional aktifkan Folder beranda untuk mengizinkan agen Anda menyimpan file ke bucket Amazon S3 di AWS akun. Armada yang terkait dengan tumpukan ini harus memungkinkan akses ke Amazon S3 melalui internet atau titik akhir Amazon VPC untuk Amazon S3. Pilih Berikutnya.
-
Pada Mengedit setelan agen halaman (langkah 3 dari 4), konfigurasikan yang berikut:
-
Aktifkan input komputer — Izinkan agen untuk memilih tombol, memasukkan teks, dan menggulir di desktop. Jika Anda mengaktifkan input komputer, Anda juga harus mengaktifkan visi komputer.
-
Aktifkan visi komputer — Izinkan agen untuk melihat desktop.
-
Penyimpanan tangkapan layar — Konfigurasikan tempat tangkapan layar agen disimpan selama sesi streaming. Jika diaktifkan, berikan bucket Amazon S3 yang memiliki izin untuk menulis.
-
Resolusi layar — Pilih resolusi tampilan untuk lingkungan streaming agen (1280x720).
-
Jenis gambar layar — Pilih format gambar untuk tangkapan layar agen (PNG atau JPEG).
-
Ketekunan pengaturan aplikasi — Secara opsional aktifkan ini untuk menyimpan penyesuaian aplikasi agen Anda dan pengaturan Windows di antara sesi. Pengaturan disimpan ke bucket Amazon S3 di AWS akun. Pengaturan ini tersedia di Windows dan tidak didukung di Linux.
-
Aktifkan penerusan alat MCP - Izinkan agen untuk berinteraksi dengan aplikasi dan sistem operasi desktop melalui panggilan MCP langsung daripada menggunakan alat penggunaan komputer. Saat diaktifkan, alat MCP dikonfigurasi pada WorkSpaces Sesi aplikasi diteruskan ke agen. Penerusan alat juga memerlukan file konfigurasi pada gambar. Untuk jalur khusus platform dan langkah penyiapan, lihat Menyiapkan penerusan alat.
-
Aktifkan mode kontrol pengguna — Izinkan pengguna untuk mengamati sesi agen secara real time melalui browser mereka. Pengamat melihat tampilan langsung desktop saat agen bekerja. Dalam mode VIEW_STOP, pengamat dapat menghentikan agen menggunakan tombol di bagian atas layar. Setelah agen berhenti, ia harus memulai sesi baru untuk melanjutkan.
catatanAnda harus mengaktifkan setidaknya satu input komputer atau visi komputer.
Pilih Berikutnya.
-
-
Pada Tinjau dan Buat halaman (langkah 4 dari 4), tinjau pengaturan Anda dan pilih Buat Stack.
Menggunakan AWS CLI
Jalankan perintah berikut untuk membuat tumpukan dengan akses agen diaktifkan:
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" }'
Untuk juga mengaktifkan penyimpanan tangkapan layar, tambahkan S3BucketArn dan 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 }'
Setelah Anda membuat tumpukan, kaitkan dengan armada. Agen tidak dapat terhubung ke tumpukan yang tidak memiliki armada terkait.
aws appstream associate-fleet \ --stack-nameyour-stack-name\ --fleet-nameyour-fleet-name
Langkah 2: Buat URL streaming
Buat URL streaming menggunakan standar WorkSpaces Aplikasi CreateStreamingURL API. Anda tidak memerlukan parameter khusus agen. Konfigurasi akses agen stack menentukan perilaku spesifik agen.
Menggunakan AWS Konsol Manajemen
Untuk membuat URL streaming menggunakan konsol
-
Di panel navigasi kiri, pilih Tumpukan, lalu pilih tumpukan yang Anda buat dengan akses agen diaktifkan.
-
Pilih Tindakan tombol, dan di dropdown, pilih Buat URL Streaming. Tumpukan Anda harus dipilih agar opsi ini tersedia.
-
Di Id pengguna bagian, masukkan pengguna. Anda bisa masuk
TestUserJika Anda sedang menguji -
Di dalam Kedaluwarsa URL bagian, pilih waktu Anda ingin URL valid. Disarankan waktu yang lebih singkat. Defaultnya adalah 30 menit, yang direkomendasikan untuk pengujian.
-
Pilih Dapatkan URL dan salin URL yang dihasilkan.
Menggunakan AWS CLI
Jalankan perintah berikut untuk menghasilkan URL streaming:
aws appstream create-streaming-url \ --stack-nameyour-stack-name\ --fleet-nameyour-fleet-name\ --user-idyour-agent-id\ --validity 3600
Jawabannya termasuk StreamingURL yang Anda berikan ke agen Anda di langkah berikutnya. URL valid untuk durasi yang ditentukan oleh --validity parameter.
Pada waktu tertentu, hanya satu agen yang dapat terhubung ke sesi unik. Pengguna bernama, ditentukan melalui UserId parameter, hanya dapat memiliki satu sesi aktif per armada pada satu waktu. Untuk menjalankan beberapa agen secara bersamaan, setiap agen harus terhubung ke sesi uniknya sendiri.
Langkah 3: Hubungkan agen Anda ke server MCP
Agen Anda terhubung ke server MCP terkelola di titik akhir tetap berikut:
https://agentaccess-mcp.region.api.aws/mcp
Ganti region dengan kode Wilayah Anda. Untuk Wilayah yang didukung dan titik akhir mereka, lihat WorkSpaces Aplikasi titik akhir MCP.
Koneksi menggunakan penandatanganan SIGv4 dengan nama layanan agentaccess-mcp. Agen Anda menandatangani setiap permintaan menggunakan AWS
kredenSIAL dikonfigurasi dalam prasyarat dengan agentaccess-mcp:* izin. Anda meneruskan URL streaming dari Langkah 2 sebagai header pada setiap permintaan MCP.
Contoh berikut menunjukkan cara membuat koneksi menggunakan mcp-proxy-for-aws:
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, }, )
Setelah agen terhubung, ia dapat menggunakan alat MCP untuk memasukkan teks, memilih tombol, dan mengambil tangkapan layar desktop.
Langkah 4: Verifikasi aktivitas agen
Anda dapat memverifikasi aktivitas agen menggunakan yang berikut ini AWS layanan:
-
AWS CloudTrail — AWS CloudTrail mencatat peristiwa sesi agen. Buka AWS CloudTrail konsol untuk melihat aktivitas agen. Panggilan alat dicatat sebagai peristiwa data, yang memerlukan jejak yang dikonfigurasi untuk peristiwa data log.
-
CloudWatch — CloudWatch menyediakan metrik operasional untuk sesi agen. Buka CloudWatch konsol untuk melihat metrik.
-
Amazon S3 — Jika Anda mengaktifkan penyimpanan tangkapan layar, Amazon S3 menyimpan tangkapan layar di bucket yang Anda tentukan selama konfigurasi tumpukan.
Langkah 5: Bersihkan Sumber Daya
Untuk menghindari biaya yang sedang berlangsung, hapus tumpukan yang Anda buat dalam tutorial ini. Anda harus menghentikan armada dan memisahkannya dari tumpukan sebelum Anda dapat menghapus tumpukan. Secara opsional, Anda juga dapat menghapus armada.
Menggunakan AWS Konsol Manajemen
Untuk membersihkan sumber daya
-
Di panel navigasi kiri, pilih Armada.
-
Pilih armada yang terkait dengan tumpukan. Pilih Tindakan, Berhenti. Tunggu armada berhenti.
-
Di panel navigasi sebelah kiri, pilih Tumpukan.
-
Pilih tumpukan yang Anda buat, dan pilih Tindakan, Pisahkan Armada.
-
Dengan tumpukan masih dipilih, pilih Tindakan, Hapus.
-
(Opsional) Untuk menghapus armada, di panel navigasi kiri, pilih Armada. Pilih armada dan pilih Tindakan, Hapus.
Menggunakan AWS CLI
Jalankan perintah berikut untuk membersihkan sumber daya:
aws appstream stop-fleet \ --nameyour-fleet-nameaws appstream disassociate-fleet \ --stack-nameyour-stack-name\ --fleet-nameyour-fleet-nameaws appstream delete-stack \ --nameyour-stack-name
(Opsional) Untuk juga menghapus armada setelah berhenti:
aws appstream delete-fleet \ --nameyour-fleet-name