

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

# Buat, jalankan, dan uji kode untuk aplikasi Anda dengan mengaktifkan interpretasi kode
<a name="agents-code-interpretation"></a>

Interpretasi kode memungkinkan agen Anda untuk menghasilkan, menjalankan, dan memecahkan masalah kode aplikasi Anda di lingkungan pengujian yang aman. Dengan interpretasi kode, Anda dapat menggunakan model dasar agen untuk menghasilkan kode untuk menerapkan kemampuan dasar saat Anda fokus membangun aplikasi AI generatif. 

Anda dapat melakukan tugas-tugas berikut dengan interpretasi kode di Amazon Bedrock:
+ Memahami permintaan pengguna untuk tugas-tugas tertentu, menghasilkan kode yang dapat melakukan tugas yang diminta oleh pengguna, mengeksekusi kode, dan memberikan hasil dari eksekusi kode.
+ Memahami query generik pengguna, menghasilkan dan menjalankan kode untuk memberikan respon kepada pengguna.
+ Hasilkan kode untuk melakukan analisis, visualisasi, dan evaluasi data.
+ Ekstrak informasi dari file yang diunggah oleh pengguna, proses informasi dan jawab pertanyaan pengguna. 
+ Hasilkan kode berdasarkan percakapan interaktif dengan pengguna untuk pembuatan prototipe cepat. 

Secara default, jumlah maksimum interpretasi kode aktif bersamaan per sesi per Akun AWS adalah 25. Ini berarti, masing-masing Akun AWS dapat memiliki hingga 25 percakapan yang sedang berlangsung dengan agen sekaligus menggunakan penerjemah kode.

Berikut ini adalah beberapa kasus penggunaan di mana interpretasi kode dapat membantu dengan membuat dan menjalankan kode dalam Amazon Bedrock 

1. Menganalisis transaksi keuangan dari file data seperti .csv untuk menentukan apakah mereka menghasilkan keuntungan atau kerugian. 

1. Mengonversi format tanggal, seperti *14 Maret 2020* ke format API standar `YYYY-MM-DD` untuk format file seperti.txt atau.csv

1. Melakukan analisis data pada spreadsheet (XLS) untuk menghitung metrik seperti pendapatan quarterly/yearly perusahaan atau tingkat pertumbuhan populasi.

Untuk menggunakan interpretasi kode di Amazon Bedrock, lakukan langkah-langkah berikut, 
+ Aktifkan interpretasi kode saat Anda membangun agen Anda. Setelah Anda mengaktifkan interpretasi kode, Anda dapat mulai menggunakannya.
+ Mulai gunakan interpretasi kode di Amazon Bedrock dengan memberikan petunjuk. Misalnya Anda dapat bertanya “hitung akar kuadrat pi hingga 127 digit”. Interpretasi kode akan menghasilkan dan menjalankan kode python untuk memberikan respons.
+ Anda juga dapat melampirkan file. Anda dapat menggunakan informasi dalam file untuk mengajukan pertanyaan dan meringkas atau menganalisis data. Anda dapat melampirkan file dari komputer Anda atau dari bucket Amazon S3.

**Wilayah yang didukung**

Interpretasi Kode untuk Agen Bedrock Amazon didukung di Wilayah berikut:


****  

| Wilayah | 
| --- | 
| AS Timur (Virginia Utara) | 
| AS Barat (Oregon) | 
| Eropa (Frankfurt) | 

**Dukungan file**

Dengan interpretasi kode, Anda dapat melampirkan file dan kemudian menggunakan file terlampir untuk mengajukan pertanyaan dan meringkas atau menganalisis data yang didasarkan pada konten file terlampir. 

Anda dapat melampirkan maksimal 5 file. Ukuran total semua file bisa sampai 10 MB.
+ **Jenis file input yang didukung**: CSV, XLS, XLSX, YAMAL, JSON, DOC, DOCX, HTML, MD, TXT, dan PDF 
+ **Jenis file keluaran yang didukung**: CSV, XLS, XLSX, YAMAL, JSON, DOC, DOCX, HTML, MD, TXT, PDF, dan PNG 

# Aktifkan interpretasi kode di Amazon Bedrock
<a name="agents-enable-code-interpretation"></a>

Anda dapat mengaktifkan interpretasi kode di konsol Amazon Bedrock saat [membuat](https://docs.aws.amazon.com//bedrock/latest/userguide/agents-create.html) atau [memperbarui](https://docs.aws.amazon.com//bedrock/latest/userguide/agents-manage.html#agents-edit) agen Anda. Jika Anda menggunakan API atau SDKs, Anda dapat mengaktifkan interpretasi kode saat [membuat](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_CreateAgentActionGroup.html) atau [memperbarui](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_UpdateAgentActionGroup.html) grup tindakan.

Untuk mempelajari cara mengaktifkan interpretasi kode di Amazon Bedrock, pilih tab untuk metode pilihan Anda, lalu ikuti langkah-langkahnya:

------
#### [ Console ]

**Untuk mengaktifkan interpretasi kode untuk agen Anda**

1. Jika Anda belum berada di agen builder, lakukan hal berikut:

   1. Masuk ke Konsol Manajemen AWS dengan identitas IAM yang memiliki izin untuk menggunakan konsol Amazon Bedrock. Kemudian, buka konsol Amazon Bedrock di [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock).

   1. Pilih **Agen** dari panel navigasi kiri. Kemudian, pilih agen di bagian **Agen**.

   1. Pilih **Edit di Agent Builder**

1. Buka **Pengaturan tambahan** dan perluas bagian.

1. Untuk **Penerjemah Kode**, pilih **Aktifkan**.

1. Pastikan untuk terlebih dahulu **Simpan** dan kemudian **Bersiaplah** untuk menerapkan perubahan yang telah Anda buat ke agen sebelum mengujinya.

------
#### [ API ]

Untuk mengaktifkan interpretasi kode untuk agen Anda, kirim [CreateActionGroup](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_CreateAgentActionGroup.html)permintaan (lihat tautan untuk format permintaan dan respons serta detail bidang) dengan [titik akhir waktu pembuatan Agen untuk Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) dan tentukan bidang berikut:


****  

| Bidang | Deskripsi singkat | 
| --- | --- | 
| actionGroupName | Nama grup aksi | 
| parentActionGroupTanda tangan | Tentukan AMAZON.CodeInterpreter untuk memungkinkan agen menghasilkan dan menguji kode | 
| actionGroupState | Tentukan ENABLED untuk mengizinkan agen untuk memanggil interpretasi kode | 

Berikut ini menunjukkan format umum bidang yang diperlukan untuk mengaktifkan interpretasi kode dengan [CreateActionGroup](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_CreateAgentActionGroup.html)permintaan.

```
CreateAgentActionGroup:
{
  "actionGroupName": "CodeInterpreterAction",
  "parentActionGroupSignature": "AMAZON.CodeInterpreter",
  "actionGroupState": "ENABLED"
}
```

------

# Uji interpretasi kode di Amazon Bedrock
<a name="agents-test-code-interpretation"></a>

Sebelum Anda menguji interpretasi kode di Amazon Bedrock, pastikan untuk mempersiapkan agen Anda untuk menerapkan perubahan yang baru saja Anda buat.

Dengan interpretasi kode diaktifkan, ketika Anda mulai menguji agen Anda, Anda dapat secara opsional melampirkan file dan memilih bagaimana Anda ingin file yang Anda lampirkan digunakan oleh interpretasi kode. Bergantung pada kasus penggunaan Anda, Anda dapat meminta interpretasi kode untuk menggunakan informasi dalam file terlampir untuk meringkas isi file dan untuk menjawab pertanyaan tentang konten file selama percakapan obrolan interaktif. Atau, Anda dapat meminta interpretasi kode untuk menganalisis konten dalam file terlampir dan memberikan metrik dan laporan visualisasi data.

**Lampirkan file**

Untuk mempelajari cara melampirkan file untuk interpretasi kode, pilih tab untuk metode pilihan Anda, lalu ikuti langkah-langkahnya:

------
#### [ Console ]

**Untuk melampirkan file untuk interpretasi kode,**

1. Jika Anda belum berada di agen builder, lakukan hal berikut:

   1. Masuk ke Konsol Manajemen AWS dengan identitas IAM yang memiliki izin untuk menggunakan konsol Amazon Bedrock. Kemudian, buka konsol Amazon Bedrock di [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock).

   1. Pilih **Agen** dari panel navigasi kiri. Kemudian, pilih agen di bagian **Agen**.

   1. Pilih **Edit di Agent Builder**

   1. Perluas **Pengaturan tambahan** dan konfirmasikan bahwa **Penerjemah Kode** diaktifkan.

   1. Pastikan agen sudah siap.

1. Jika jendela uji tidak terbuka, pilih **Uji**.

1. Di bagian bawah jendela tes, pilih ikon paper clip untuk melampirkan file.

1. Di halaman **Lampirkan file**,

   1. 

**Untuk **fungsi Pilih**, tentukan yang berikut ini:**
      + Jika Anda melampirkan file untuk agen untuk digunakan untuk menjawab pertanyaan Anda dan meringkas konten, pilih **Lampirkan file untuk mengobrol (**lebih cepat).
      + Jika Anda melampirkan file untuk interpretasi kode untuk menganalisis konten dan menyediakan metrik, pilih **Lampirkan file ke interpreter kode**.

   1. 

**Untuk **memilih metode upload**, pilih dari mana Anda ingin meng-upload file Anda:**
      + Jika Anda mengunggah dari komputer, pilih Pilih **file dan pilih file** yang akan dilampirkan.
      + **Jika Anda mengunggah dari Amazon S3, **pilih Jelajahi** S3, pilih file, pilih Pilih, lalu **pilih** Tambah.**

1. Pilih **Lampirkan**.

------
#### [ API ]

Untuk menguji interpretasi kode, kirim [InvokeAgent](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_InvokeAgent.html)permintaan (lihat tautan untuk format permintaan dan respons serta detail bidang) dengan titik akhir [waktu pembuatan Agen untuk Amazon Bedrock.](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)

**Untuk melampirkan file untuk agen yang akan digunakan untuk menjawab pertanyaan Anda dan meringkas konten, tentukan bidang berikut:**


****  

| Bidang | Deskripsi singkat | 
| --- | --- | 
| name | Nama file terlampir. | 
| sourceType | Lokasi file yang akan dilampirkan. Tentukan s3 apakah file Anda berada di bucket Amazon S3. Tentukan byte\$1content apakah file Anda berada di komputer Anda. | 
| S3Location | Jalur S3 tempat file Anda berada. Diperlukan jika sourceType adalah S3. | 
| MediaType | Jenis file dari file terlampir. **Jenis file input yang didukung**: CSV, XLS, XLSX, YAMAL, JSON, DOC, DOCX, HTML, MD, TXT, dan PDF   | 
| data | String yang dikodekan Base64. Ukuran file maks 10MB. Jika Anda menggunakan SDK, Anda hanya perlu menyediakan konten byte file. AWS SDK secara otomatis mengkodekan string ke base64. | 
| UseCase | Bagaimana Anda ingin file terlampir digunakan. Nilai yang valid: CHAT \$1 CODE\$1INTERPRETER | 

 Contoh berikut menunjukkan format umum untuk menentukan bidang yang diperlukan untuk melampirkan file ke obrolan.

```
                  
"sessionState": {
        "promptSessionAttributes": {
            "string": "string"
        },
        "sessionAttributes": {
            "string": "string"
        },
        "files": [ 
            {
                "name": "banking_data", 
                "source": { 
                    "sourceType": "S3", 
                    "s3Location": 
                        "uri": "s3Uri" 
                    }
                },
                "useCase": "CHAT" 
            },
            {
                "name": "housing_stats.csv", 
                "source": { 
                    "sourceType": "BYTE_CONTENT", 
                    "byteContent": {
                        "mediaType": "text/csv", 
                        "data": "file byte content"
                    }
                },
                "useCase": "CHAT"
            }
        ]
    }
```

Contoh berikut menunjukkan format umum untuk menentukan bidang yang diperlukan untuk melampirkan file untuk interpretasi kode.

```
"sessionState": {
        "promptSessionAttributes": {
            "string": "string"
        },
        "sessionAttributes": {
            "string": "string"
        },
        "files": [ 
            {
                "name": "banking_data", 
                "source": { 
                    "sourceType": "S3",
                    "s3Location": {
                        "uri": "s3Uri" 
                    }
                },
                "useCase": "CODE_INTERPRETER" 
            },
            {
                "name": "housing_stats.csv", 
                "source": { 
                    "sourceType": "BYTE_CONTENT", 
                    "byteContent": {
             "mediaType": "text/csv", 
             "data": "file byte content" 
                    }
                },
                "useCase": "CODE_INTERPRETER"
            }
        ]
    }
```

------

# Nonaktifkan interpretasi kode di Amazon Bedrock
<a name="agents-disable-code-interpretation"></a>

Anda dapat menonaktifkan interpretasi kode di Amazon Bedrock kapan saja.

Untuk mempelajari cara menonaktifkan interpretasi kode, pilih tab untuk metode pilihan Anda, lalu ikuti langkah-langkahnya:

------
#### [ Console ]

**Untuk menonaktifkan interpretasi kode,**

1. Masuk ke Konsol Manajemen AWS dengan identitas IAM yang memiliki izin untuk menggunakan konsol Amazon Bedrock. Kemudian, buka konsol Amazon Bedrock di [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock).

1. Pilih **Agen** dari panel navigasi kiri. Kemudian, pilih agen di bagian **Agen**.

1. Pilih **Edit di Pembangun Agen**.

1. Perluas bagian **Pengaturan tambahan**, pilih **Nonaktifkan** untuk **Penerjemah Kode**.

1. Pilih **Siapkan** di bagian atas halaman. Dan kemudian pilih **Simpan** untuk menyimpan perubahan ke agen Anda.

------
#### [ API ]

Untuk menonaktifkan interpretasi kode, kirim [UpdateAgentActionGroup](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_UpdateAgentActionGroup.html)permintaan (lihat tautan untuk format permintaan dan respons serta detail bidang) dengan [titik akhir waktu pembuatan Agen untuk Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) dan tentukan bidang berikut:


****  

| Bidang | Deskripsi singkat | 
| --- | --- | 
| actionGroupName | Nama grup aksi | 
| parentActionGroupTanda tangan | Tentukan AMAZON.CodeInterpreter untuk menonaktifkan penerjemah kode | 
| actionGroupState | Tentukan DISABLED untuk menonaktifkan penerjemah kode | 

Contoh berikut menunjukkan format umum untuk menentukan bidang yang diperlukan untuk menonaktifkan interpretasi kode.

```
UpdateAgentActionGroup:
{
  "actionGroupName": "CodeInterpreterAction",
  "parentActionGroupSignature": "AMAZON.CodeInterpreter",
  "actionGroupState": "DISABLED"
}
```

------

Setelah menonaktifkan interpretasi kode untuk agen Anda, pastikan untuk mengirim [PrepareAgent](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_PrepareAgent.html)permintaan (lihat tautan untuk format permintaan dan respons serta detail bidang) dengan titik akhir waktu [pembuatan Agen untuk Amazon Bedrock.](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)