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
<a name="getting-started-agent-access"></a>

Untuk mengaktifkan agen AI mengoperasikan aplikasi desktop melalui WorkSpaces Aplikasi Amazon, Anda membuat tumpukan dengan akses yang 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 mulai 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 — sample-code-for-workspaces-agent-access.](https://github.com/aws-samples/sample-code-for-workspaces-agent-access)

Tutorial ini membutuhkan waktu sekitar 15 menit untuk menyelesaikannya.

**penting**  
Sumber daya yang Anda buat dalam tutorial ini dapat mengakibatkan biaya ke AWS akun Anda. Hapus tumpukan dan hentikan armada ketika 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 layanan MCP
+ Langkah 4: Verifikasi aktivitas agen
+ Langkah 5: Bersihkan Sumber Daya

## Prasyarat
<a name="getting-started-agent-access-prereqs"></a>

Sebelum Anda mulai, pastikan Anda memiliki yang berikut:
+ Armada WorkSpaces Aplikasi Amazon yang aktif. Jika Anda belum mengaturnya, lihat[Memulai WorkSpaces Aplikasi Amazon: Mengatur Dengan Contoh Aplikasi](getting-started.md).
+ AWS kredensial (variabel lingkungan, AWS profil, peran instans EC2, atau peran eksekusi Lambda) dengan izin IAM berikut:

  ```
  {
      "Sid": "MCP",
      "Effect": "Allow",
      "Action": ["agentaccess-mcp:*"],
      "Resource": "*"
  },
  {
      "Sid": "AppStream",
      "Effect": "Allow",
      "Action": ["appstream:CreateStreamingURL", "appstream:DescribeFleets"],
      "Resource": "*"
  }
  ```
+ Kerangka kerja MCP-compatible agen. Agen harus dapat membuat permintaan HTTP SigV4-signed Streamable ke titik akhir MCP. [Strands Agents SDK](https://strandsagents.com/docs/user-guide/concepts/tools/mcp-tools/) menyediakan dukungan klien MCP asli, atau Anda dapat menggunakan framework apa pun dengan transport mcp-proxy-for-aws.
+ Python 3.10 atau yang lebih baru. Tidak diperlukan sistem operasi khusus.

## Langkah 1: Buat tumpukan dengan akses agen diaktifkan
<a name="getting-started-agent-access-create-stack"></a>

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

### Menggunakan AWS Konsol Manajemen
<a name="getting-started-agent-access-create-stack-console"></a>

**Untuk membuat tumpukan dengan akses agen**

1. Buka [konsol WorkSpaces Aplikasi](https://console.aws.amazon.com/appstream2/home).

1. Di panel navigasi kiri, pilih **Stacks**, lalu pilih **Create** Stack.

1. Pada halaman **Stack details** (langkah 1 dari 4), di bawah **akses agen AI**, pilih **Aktifkan akses agen AI**. Pilih **Berikutnya**.

1. Pada halaman **Aktifkan penyimpanan** (langkah 2 dari 4), aktifkan **folder Home** secara opsional untuk memungkinkan agen Anda menyimpan file ke bucket Amazon S3 di AWS akun Anda. Armada yang terkait dengan tumpukan ini harus mengizinkan akses ke Amazon S3 melalui internet atau titik akhir Amazon VPC untuk Amazon S3. Pilih **Berikutnya**.

1. Pada halaman **pengaturan Edit agen** (langkah 3 dari 4), konfigurasikan yang berikut ini:
   + **Aktifkan input komputer** - Izinkan agen memilih tombol, memasukkan teks, dan menggulir di desktop. Jika Anda mengaktifkan input komputer, Anda juga harus mengaktifkan visi komputer.
   + **Aktifkan visi komputer** - Izinkan agen 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).
   + **Persistensi 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 akun Anda AWS .
**catatan**  
Anda harus mengaktifkan setidaknya satu input komputer atau visi komputer.

   Pilih **Berikutnya**.

1. Pada halaman **Review and Create** (langkah 4 dari 4), tinjau pengaturan Anda dan pilih **Create Stack**.

### Menggunakan AWS CLI
<a name="getting-started-agent-access-create-stack-cli"></a>

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"}
        ],
        "ScreenResolution": "W_1280xH_720",
        "ScreenImageFormat": "PNG"
    }'
```

Untuk juga mengaktifkan penyimpanan tangkapan layar, tambahkan `S3BucketArn` dan `ScreenshotsUploadEnabled` parameter:

```
aws appstream create-stack \
    --name {{your-stack-name}} \
    --agent-access-config '{
        "Settings": [
            {"AgentAction": "COMPUTER_VISION", "Permission": "ENABLED"},
            {"AgentAction": "COMPUTER_INPUT", "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
<a name="getting-started-agent-access-streaming-url"></a>

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

### Menggunakan AWS Konsol Manajemen
<a name="getting-started-agent-access-streaming-url-console"></a>

**Untuk menghasilkan URL streaming menggunakan konsol**

1. Buka [konsol WorkSpaces Aplikasi](https://console.aws.amazon.com/appstream2/home).

1. Di panel navigasi kiri, pilih **Tumpukan**, lalu pilih tumpukan yang Anda buat dengan akses agen diaktifkan.

1. Pilih tombol **Tindakan**, dan di dropdown, pilih **Buat URL Streaming**. Tumpukan Anda harus dipilih agar opsi ini tersedia.

1. Di bagian **UserID**, masukkan pengguna. Anda dapat masuk `TestUser` jika Anda sedang menguji.

1. Di bagian **kedaluwarsa URL**, pilih waktu yang Anda inginkan agar URL valid. Waktu yang lebih singkat disarankan. 30 menit adalah default dan direkomendasikan untuk pengujian.

1. Pilih **getURL** dan salin URL yang dihasilkan.

### Menggunakan AWS CLI
<a name="getting-started-agent-access-streaming-url-cli"></a>

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
```

Respons termasuk `StreamingURL` yang Anda berikan kepada agen Anda di langkah berikutnya. URL valid untuk durasi yang ditentukan oleh `--validity` parameter.

## Langkah 3: Hubungkan agen Anda ke layanan MCP
<a name="getting-started-agent-access-connect"></a>

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 layanan. `agentaccess-mcp` 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
<a name="getting-started-agent-access-verify"></a>

Anda dapat memverifikasi aktivitas agen menggunakan AWS layanan berikut:
+ **AWS CloudTrail**— AWS CloudTrail log acara sesi agen. Buka AWS CloudTrail konsol untuk melihat aktivitas agen.
+ **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
<a name="getting-started-agent-access-cleanup"></a>

Untuk menghindari tagihan 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
<a name="getting-started-agent-access-cleanup-console"></a>

**Untuk membersihkan sumber daya**

1. Buka [konsol WorkSpaces Aplikasi](https://console.aws.amazon.com/appstream2/home).

1. Di panel navigasi kiri, pilih **Armada.**

1. Pilih armada yang terkait dengan tumpukan. Pilih **Tindakan**, **Berhenti**. Tunggu armada berhenti.

1. Di panel navigasi sebelah kiri, pilih **Tumpukan**.

1. Pilih tumpukan yang Anda buat, dan pilih **Actions**, **Disassociate Fleet**.

1. Dengan tumpukan yang masih dipilih, pilih **Tindakan**, **Hapus**.

1. (Opsional) Untuk menghapus armada, di panel navigasi kiri, pilih **Armada**. Pilih armada dan pilih **Tindakan**, **Hapus**.

### Menggunakan AWS CLI
<a name="getting-started-agent-access-cleanup-cli"></a>

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}}
```