Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menguji dan memecahkan masalah perilaku agen
**catatan**
Amazon Bedrock Agents (sekarang Amazon Bedrock Agents Classic) tidak lagi terbuka untuk pelanggan baru. Untuk kemampuan yang mirip dengan Bedrock Agents Classic, jelajahi [ Amazon Bed AgentCore ](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/agentcore-get-started-cli.html) rock. Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Untuk informasi selengkapnya, lihat [Mode perawatan klasik Amazon Bedrock Agents](agents-classic-maintenance-mode.md).
Setelah Anda membuat agen, Anda akan memiliki dra * f 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 tersebut. Anda kemudian dapat menerapkan 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 cara Anda menguji agen Anda:
+ Di konsol Amazon Bedrock, Anda membuka jendela pengujian di samping dan mengirim masukan untuk ditanggapi agen Anda. Anda dapat memilih draft kerja atau versi yang telah Anda buat.
+ Di API, draf kerja adalah `DRAFT` versi. Anda mengirim masukan ke agen Anda [InvokeAgent](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 [PrepareAgent](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 penalaran langkah demi langkah agen. Untuk informasi lebih lanjut tentang jejak, lihat[Lacak proses penalaran langkah demi langkah agen menggunakan jejak](trace-events.md).
## Uji agen Anda
Berikut 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 ** A ** gen 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. Jen ** ** dela Test muncul di panel di sebelah kanan.
**catatan**
Jika jendela ** Tes ** ditutup, Anda dapat membukanya kembali dengan memilih U ** ji ** di bagian atas halaman detail agen atau halaman apa pun di dalamnya.
1. Setelah membuat agen, Anda harus mengemasnya dengan perubahan draf kerja dengan menyiapkannya dengan salah satu cara berikut:
+ Di ** jendela ** Tes, pilih Si ** apkan**.
+ Di ** halaman ** Draf kerja, pilih ** Si ** apkan di bagian atas halaman.
**catatan**
Setiap kali Anda memperbarui draf kerja, Anda harus menyiapkan agen untuk mengemas agen dengan perubahan terbaru Anda. Sebagai praktik terbaik, sebaiknya Anda selalu memeriksa ** Waktu persiapan ** terakhir agen Anda di ** bagian Ringkasan ** Agen di ** halaman Draf ** kerja untuk memverifikasi bahwa Anda menguji agen dengan konfigurasi terbaru.
1. Untuk memilih alias dan versi terkait untuk diuji, gunakan menu dropdown di bagian atas jendela ** ** Tes. 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 Throughput yang Disediakan, pilih U ** bah**. 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 () 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 J ** alankan**. Sementara 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 grup tindakan dan basis pengetahuannya, pilih ** Tampilkan pelacakan. ** 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 penalaran langkah demi langkah agen menggunakan jejak](trace-events.md).
+ Jika agen memanggil basis pengetahuan, respons berisi catatan kaki. Untuk melihat tautan ke objek S3 yang berisi informasi yang dikutip untuk bagian tertentu dari respons, pilih catatan kaki yang relevan.
+ Jika Anda menyetel agen 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 dan kemudian pilih ** Kirim ** untuk menghasilkan respons agen. Lihat gambar berikut untuk contoh:
Anda dapat melakukan tindakan berikut di ** jendela ** Tes:
+ Untuk memulai percakapan baru dengan agen, pilih ikon refresh.
+ Untuk melihat ** jendela ** Trace, pilih ikon memperluas. Untuk menutup ** jendela ** Trace, pilih ikon kecilkan.
+ Untuk menutup ** jendela ** Tes, pilih ikon panah kanan.
Anda dapat mengaktifkan atau menonaktifkan grup tindakan dan basis pengetahuan. Gunakan fitur ini untuk memecahkan masalah agen Anda dengan mengisolasi grup tindakan atau basis pengetahuan mana yang perlu diperbarui dengan menilai perilakunya dengan pengaturan yang berbeda.
**Untuk mengaktifkan grup tindakan 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 ** A ** gen 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 D ** raf kerja, pilih tautan untuk D ** raf Kerja**.
1. Di ** bagian Grup ** tindakan ** atau Basis ** pengetahuan, arahkan kursor ke ** ** Status grup tindakan atau basis pengetahuan yang statusnya ingin Anda ubah.
1. Tombol edit muncul. Pilih ikon edit dan kemudian pilih dari menu dropdown apakah grup tindakan atau basis pengetahuan diaktifkan atau ** din ** on ** aktifkan**.
1. Jika grup tindakan din ** onaktifkan**, agen tidak menggunakan grup tindakan. Jika basis pengetahuan din ** onaktifkan**, agen tidak menggunakan basis pengetahuan. Aktifkan atau menonaktifkan grup tindakan atau basis pengetahuan, lalu gunakan ** jendela ** Tes untuk memecahkan masalah agen Anda.
1. Pilih ** Siapkan ** untuk menerapkan perubahan yang telah Anda buat ke 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 untuk pertama kalinya, Anda harus mengemasnya dengan perubahan draf kerja dengan mengirimkan [PrepareAgent](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 dit `TSTALIASID` unjuk 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 Amazon Bedrock](bedrock-agent_example_bedrock-agent_Hello_section.md).
**catatan**
Setiap kali Anda memperbarui draf kerja, Anda harus menyiapkan agen untuk mengemas agen dengan perubahan terbaru Anda. Sebagai praktik terbaik, kami menyarankan Anda mengirim [GetAgent](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 memeriksa `preparedAt` waktu agen Anda untuk memverifikasi bahwa Anda menguji agen Anda dengan konfigurasi terbaru. ](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)
Untuk menguji agen Anda, ki [InvokeAgent](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html) rim permintaan ke agen. Untuk kode sampel, lihat [Memanggil agen dari aplikasi Anda](agents-invoke-agent.md).
**catatan**
Itu AWS CLI tidak mendukung [InvokeAgent](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html).
Bidang berikut ada dalam permintaan:
+ Minimal, berikan kolom 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 bersifat 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 peristiwa berisi a`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 pelacakan, `trace` objek juga dikembalikan. Jika terjadi kesalahan, bidang dikembalikan dengan pesan kesalahan. Untuk informasi selengkapnya tentang cara membaca jejak, lihat[Lacak proses penalaran langkah demi langkah agen menggunakan jejak](trace-events.md).
+ Jika Anda mengatur grup tindakan untuk melewatkan menggunakan fungsi Lambda, [ ReturnControlPayload ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ReturnControlPayload.html) objek dikembalikan di `returnControl` lapangan. 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 berikut ini:
+ Ob [ ApiInvocationInput ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ApiInvocationInput.html) jek yang berisi operasi API yang diprediksi agen harus dipanggil berdasarkan input pengguna, selain parameter dan informasi lain yang didapat 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"
}
]
}
}
}
```
+ Ob [ FunctionInvocationInput ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_FunctionInvocationInput.html) jek yang berisi fungsi yang diprediksi agen harus dipanggil berdasarkan input pengguna, selain parameter untuk fungsi yang didapat 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"
}
]
}
```
------