Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Uji dan pecahkan masalah perilaku agen
Setelah Anda membuat agen, Anda akan memiliki *konsep kerja*. Draf kerja adalah versi agen yang dapat Anda gunakan untuk membangun agen secara berulang. Setiap kali Anda membuat perubahan pada agen Anda, draf kerja diperbarui. Ketika Anda puas dengan konfigurasi agen Anda, Anda dapat membuat *versi*, yang merupakan snapshot dari agen Anda, dan *alias*, yang menunjuk ke versi. Anda kemudian dapat menyebarkan agen Anda ke aplikasi Anda dengan memanggil alias. Untuk informasi selengkapnya, lihat [Menyebarkan dan menggunakan agen Amazon Bedrock di aplikasi Anda](agents-deploy.md).
Daftar berikut menjelaskan bagaimana Anda menguji agen Anda:
+ Di konsol Amazon Bedrock, Anda membuka jendela pengujian di samping dan mengirim masukan agar agen Anda merespons. Anda dapat memilih draf kerja atau versi yang telah Anda buat.
+ Di API, draf kerja adalah `DRAFT` versinya. Anda mengirim masukan ke agen Anda [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html)dengan menggunakan alias pengujian,`TSTALIASID`, atau alias lain yang menunjuk ke versi statis. Sebelum Anda dapat menguji agen Anda, Anda harus mempersiapkan agen Anda dengan menelepon [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PrepareAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PrepareAgent.html).
## Menelusuri perilaku agen
Untuk membantu memecahkan masalah perilaku agen Anda, Amazon Bedrock Agents menyediakan kemampuan untuk melihat *jejak* selama sesi dengan agen Anda. Jejak menunjukkan proses step-by-step penalaran agen. Untuk informasi lebih lanjut tentang jejak, lihat[Lacak proses step-by-step penalaran agen menggunakan jejak](trace-events.md).
## Menguji agen Anda
Berikut ini adalah langkah-langkah untuk menguji agen Anda. Pilih tab untuk metode pilihan Anda, lalu ikuti langkah-langkahnya:
------
#### [ Console ]
**Untuk menguji agen**
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. Di bagian **Agen**, pilih tautan untuk agen yang ingin Anda uji dari daftar agen.
1. Jendela **Uji** muncul di panel di sebelah kanan.
**catatan**
Jika **jendela Uji** ditutup, Anda dapat membukanya kembali dengan memilih **Uji** di bagian atas halaman detail agen atau halaman mana pun di dalamnya.
1. Setelah Anda membuat agen, Anda harus mengemasnya dengan perubahan draf kerja dengan menyiapkannya dalam salah satu cara berikut:
+ Di jendela **Uji**, pilih **Siapkan**.
+ Di halaman **Draf kerja**, pilih **Siapkan** di bagian atas halaman.
**catatan**
Setiap kali Anda memperbarui draf kerja, Anda harus mempersiapkan agen untuk mengemas agen dengan perubahan terbaru Anda. Sebagai praktik terbaik, kami menyarankan Anda untuk selalu memeriksa waktu **terakhir** agen Anda di bagian **Ikhtisar agen** di halaman **draf Kerja** untuk memverifikasi bahwa Anda sedang menguji agen Anda dengan konfigurasi terbaru.
1. **Untuk memilih alias dan versi terkait untuk diuji, gunakan menu tarik-turun di bagian atas jendela Uji.** Secara default, kombinasi **TestAlias: Draf kerja** dipilih.
1. **(Opsional) Untuk memilih Provisioned Throughput untuk alias Anda, teks di bawah alias pengujian yang Anda pilih akan menunjukkan **Menggunakan ODT atau Menggunakan** PT.** **Untuk membuat model Provisioned Throughput, pilih Ubah.** Untuk informasi selengkapnya, lihat [Tingkatkan kapasitas pemanggilan model dengan Provisioned Throughput di Amazon Bedrock](prov-throughput.md).
1. (Opsional) Untuk menggunakan prompt dari manajemen Prompt, pilih ikon opsi (![\[Vertical ellipsis icon representing a menu or more options.\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/images/icons/vertical-ellipsis.png)) di kotak pesan dan pilih **Impor prompt**. Pilih prompt dan versi. Masukkan nilai untuk variabel prompt di bagian **Nilai variabel Uji**. Untuk informasi selengkapnya tentang petunjuk di Manajemen Prompt, lihat[Buat dan simpan petunjuk yang dapat digunakan kembali dengan manajemen Prompt di Amazon Bedrock](prompt-management.md).
1. Untuk menguji agen, masukkan pesan dan pilih **Jalankan**. Saat Anda menunggu respons dihasilkan atau setelah dihasilkan, Anda memiliki opsi berikut:
+ **Untuk melihat detail untuk setiap langkah proses orkestrasi agen, termasuk prompt, konfigurasi inferensi, dan proses penalaran agen untuk setiap langkah dan penggunaan kelompok tindakan dan basis pengetahuannya, pilih Tampilkan jejak.** Jejak diperbarui secara real-time sehingga Anda dapat melihatnya sebelum respons dikembalikan. Untuk memperluas atau menciutkan jejak untuk satu langkah, pilih panah di sebelah langkah. Untuk informasi selengkapnya tentang jendela **Trace** dan detail yang muncul, lihat[Lacak proses step-by-step penalaran agen menggunakan jejak](trace-events.md).
+ Jika agen memanggil basis pengetahuan, responsnya berisi catatan kaki. Untuk melihat tautan ke objek S3 yang berisi informasi yang dikutip untuk bagian respons tertentu, pilih catatan kaki yang relevan.
+ Jika Anda menyetel agen Anda untuk mengembalikan kontrol daripada menggunakan fungsi Lambda untuk menangani grup tindakan, respons berisi tindakan yang diprediksi dan parameternya. Berikan contoh nilai keluaran dari API atau fungsi untuk tindakan, lalu pilih **Kirim** untuk menghasilkan respons agen. Lihat gambar berikut untuk contoh:
![\[Permintaan jendela uji untuk memberikan contoh keluaran untuk tindakan.\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/images/agents/roc-testwindow.png)
Anda dapat melakukan tindakan berikut di jendela **Uji**:
+ Untuk memulai percakapan baru dengan agen, pilih ikon penyegaran.
+ Untuk melihat jendela **Trace**, pilih ikon perluas. Untuk menutup jendela **Trace**, pilih ikon shrink.
+ Untuk menutup jendela **Uji**, pilih ikon panah kanan.
Anda dapat mengaktifkan atau menonaktifkan grup tindakan dan basis pengetahuan. Gunakan fitur ini untuk memecahkan masalah agen Anda dengan mengisolasi kelompok tindakan atau basis pengetahuan mana yang perlu diperbarui dengan menilai perilakunya dengan pengaturan yang berbeda.
**Untuk mengaktifkan kelompok aksi atau basis pengetahuan**
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. Di bagian **Agen.** pilih tautan untuk agen yang ingin Anda uji dari daftar agen.
1. Pada halaman detail agen, di bagian **Draf kerja**, pilih tautan untuk **draf Kerja**.
1. Di bagian **Grup aksi** atau **basis Pengetahuan**, arahkan kursor ke **Status** kelompok tindakan atau basis pengetahuan yang statusnya ingin Anda ubah.
1. Tombol edit muncul. **Pilih ikon edit dan kemudian pilih dari menu tarik-turun apakah grup tindakan atau basis pengetahuan Diaktifkan atau **Dinonaktifkan**.**
1. Jika grup tindakan **Dinonaktifkan**, agen tidak menggunakan grup tindakan. Jika basis pengetahuan **Dinonaktifkan**, agen tidak menggunakan basis pengetahuan. Aktifkan atau nonaktifkan grup tindakan atau basis pengetahuan, lalu gunakan jendela **Uji** untuk memecahkan masalah agen Anda.
1. Pilih **Siapkan** untuk menerapkan perubahan yang telah Anda buat pada agen sebelum mengujinya.
------
#### [ API ]
Untuk agen yang dibuat 31 `after` Maret 2025:
+ Jika Anda telah membuat agen di konsol, streaming diaktifkan secara default. Anda dapat menonaktifkan streaming kapan saja.
+ Pastikan peran eksekusi Agen menyertakan `bedrock:InvokeModelWithResponseStream` izin untuk model agen yang dikonfigurasi.
Sebelum menguji agen Anda untuk pertama kalinya, Anda harus mengemasnya dengan perubahan draf kerja dengan mengirimkan [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PrepareAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PrepareAgent.html)permintaan dengan titik akhir waktu [pembuatan Agen untuk Amazon Bedrock.](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) Sertakan `agentId` dalam permintaan. Perubahan berlaku untuk `DRAFT` versi, yang ditunjuk `TSTALIASID` alias.
```
def prepare_agent(self, agent_id):
"""
Creates a DRAFT version of the agent that can be used for internal testing.
:param agent_id: The unique identifier of the agent to prepare.
:return: The response from Amazon Bedrock Agents if successful, otherwise raises an exception.
"""
try:
prepared_agent_details = self.client.prepare_agent(agentId=agent_id)
except ClientError as e:
logger.error(f"Couldn't prepare agent. {e}")
raise
else:
return prepared_agent_details
```
Untuk informasi selengkapnya, lihat [Halo Agen Bedrock Amazon](bedrock-agent_example_bedrock-agent_Hello_section.md).
**catatan**
Setiap kali Anda memperbarui draf kerja, Anda harus mempersiapkan agen untuk mengemas agen dengan perubahan terbaru Anda. Sebagai praktik terbaik, kami menyarankan Anda mengirim [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgent.html)permintaan (lihat tautan untuk format permintaan dan respons serta detail bidang) dengan [titik akhir waktu pembuatan Agen untuk Amazon Bedrock dan periksa waktu](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) agen Anda untuk memverifikasi bahwa Anda sedang menguji agen Anda dengan konfigurasi terbaru. `preparedAt`
Untuk menguji agen Anda, kirim [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html)permintaan ke agen. Untuk kode sampel, lihat [Memanggil agen dari aplikasi Anda](agents-invoke-agent.md).
**catatan**
Yang AWS CLI tidak mendukung [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html).
Bidang berikut ada dalam permintaan:
+ Minimal, berikan bidang wajib berikut:
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/agents-test.html)
+ Bidang berikut adalah opsional:
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/agents-test.html)
Respons dikembalikan dalam aliran acara. Setiap acara berisi`chunk`, yang berisi bagian dari respons di `bytes` lapangan, yang harus diterjemahkan. Objek berikut juga dapat dikembalikan:
+ Jika agen menanyakan basis pengetahuan, itu `chunk` juga termasuk`citations`.
+ Jika streaming diaktifkan dan pagar pembatas dikonfigurasi untuk agen, respons dihasilkan dalam interval karakter yang ditentukan untuk interval pagar pembatas. Secara default, interval diatur ke 50 karakter.
+ Jika Anda mengaktifkan jejak, `trace` objek juga dikembalikan. Jika terjadi kesalahan, bidang dikembalikan dengan pesan kesalahan. Untuk informasi lebih lanjut tentang cara membaca jejak, lihat[Lacak proses step-by-step penalaran agen menggunakan jejak](trace-events.md).
+ Jika Anda mengatur grup tindakan untuk dilewati menggunakan fungsi Lambda, [ReturnControlPayload](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ReturnControlPayload.html)objek akan dikembalikan di `returnControl` bidang. Struktur umum [ReturnControlPayload](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ReturnControlPayload.html)objek adalah sebagai berikut:
```
{
"invocationId": "string",
"invocationInputs": [
[ApiInvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ApiInvocationInput.html) or [FunctionInvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_FunctionInvocationInput.html),
...
]
}
```
Setiap anggota `invocationInputs` daftar adalah salah satu dari yang berikut:
+ [ApiInvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ApiInvocationInput.html)Objek yang berisi operasi API yang diprediksi agen harus dipanggil berdasarkan input pengguna, selain parameter dan informasi lain yang didapatnya dari pengguna untuk memenuhi API. Struktur [ApiInvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ApiInvocationInput.html)objek adalah sebagai berikut:
```
{
"actionGroup": "string",
"apiPath": "string",
"httpMethod": "string",
"parameters": [
{
"name": "string",
"type": "string",
"value": "string"
},
...
],
"requestBody": {
: {
"properties": [
{
"name": "string",
"type": "string",
"value": "string"
}
]
}
}
}
```
+ [FunctionInvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_FunctionInvocationInput.html)Objek yang berisi fungsi yang diprediksi agen harus dipanggil berdasarkan input pengguna, selain parameter untuk fungsi yang didapatnya dari pengguna. Strukturnya [FunctionInvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_FunctionInvocationInput.html)adalah sebagai berikut:
```
{
"actionGroup": "string",
"function": "string",
"parameters": [
{
"name": "string",
"type": "string",
"value": "string"
}
]
}
```
------