Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Mulai menyediakan agen dengan akses ke WorkSpaces Aplikasi

Untuk mengaktifkan agen AI mengoperasikan aplikasi desktop melalui WorkSpaces Aplikasi Amazon, Anda membuat tumpukan dengan akses diaktifkan untuk agen, membuat URL streaming, dan menghubungkan agen Anda ke layanan MCP terkelola.

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 — sam ple-code-for-workspace-agent-access.

Tutorial ini membutuhkan waktu sekitar 15 menit untuk menyelesaikannya.

Dalam tutorial ini, Anda menyelesaikan tugas-tugas berikut:

Prasyarat

Sebelum Anda mulai, pastikan Anda memiliki yang berikut:

Langkah 1: Buat tumpukan dengan akses agen diaktifkan

Buat tumpukan WorkSpaces Aplikasi dengan akses agen diaktifkan untuk memungkinkan agen AI berinteraksi dengan aplikasi desktop.

Menggunakan AWS Konsol Manajemen

Menggunakan AWS CLI

Jalankan perintah berikut untuk membuat tumpukan dengan akses agen diaktifkan:

aws appstream create-stack \
    --name your-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 ScreenshotsUploadEnabled parameter S3BucketArn dan:

aws appstream create-stack \
    --name your-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-name your-stack-name \
    --fleet-name your-fleet-name

Langkah 2: Buat URL streaming

Buat URL streaming menggunakan CreateStreamingURL API WorkSpaces Aplikasi standar. Anda tidak memerlukan parameter khusus agen. Konfigurasi akses agen stack menentukan perilaku spesifik agen.

Menggunakan AWS Konsol Manajemen

Menggunakan AWS CLI

Jalankan perintah berikut untuk menghasilkan URL streaming:

aws appstream create-streaming-url \
    --stack-name your-stack-name \
    --fleet-name your-fleet-name \
    --user-id your-agent-id \
    --validity 3600

Tanggapan termasuk StreamingURL yang Anda berikan ke agen Anda di langkah berikutnya. URL valid untuk durasi yang ditentukan oleh --validity parameter.

Langkah 3: Hubungkan agen Anda ke layanan MCP

Agen Anda terhubung ke layanan MCP terkelola di titik akhir tetap berikut:

https://agentaccess-mcp.region.api.aws/mcp

Koneksi menggunakan penandatanganan SIGv4 dengan nama agentaccess-mcp layanan. Agen Anda menandatangani setiap permintaan menggunakan AWS kredensional yang 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 AWS layanan berikut:

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

Menggunakan AWS CLI

Jalankan perintah berikut untuk membersihkan sumber daya:

aws appstream stop-fleet \
    --name your-fleet-name

aws appstream disassociate-fleet \
    --stack-name your-stack-name \
    --fleet-name your-fleet-name

aws appstream delete-stack \
    --name your-stack-name

(Opsional) Untuk juga menghapus armada setelah berhenti:

aws appstream delete-fleet \
    --name your-fleet-name