Menguji dan memecahkan masalah perilaku agen - Amazon Bedrock

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

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 mengintegrasikan agen Amazon Bedrock ke dalam aplikasi Anda.

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.

  • DalamAPI, draf kerja adalah DRAFT versinya. Anda mengirim masukan ke agen Anda dengan menggunakan InvokeAgentdengan alias pengujian,TSTALIASID, atau alias berbeda yang menunjuk ke versi statis.

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, lihatLacak proses step-by-step penalaran agen menggunakan jejak.

Berikut ini adalah langkah-langkah untuk menguji agen Anda. Pilih tab yang sesuai dengan metode pilihan Anda dan ikuti langkah-langkahnya:

Console
Untuk menguji agen

  1. Masuk ke AWS Management Console menggunakan IAMperan dengan izin Amazon Bedrock, dan buka konsol Amazon Bedrock di. https://console.aws.amazon.com/bedrock/

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

  3. Di bagian Agen, pilih tautan untuk agen yang ingin Anda uji dari daftar agen.

  4. 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.

  5. 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.

  6. Untuk memilih alias dan versi terkait untuk diuji, gunakan menu tarik-turun di bagian atas jendela Uji. Secara default, kombinasi TestAlias: Draf kerja dipilih.

  7. (Opsional) Untuk memilih Provisioned Throughput untuk alias Anda, teks di bawah alias pengujian yang Anda pilih akan menunjukkan Menggunakan atau Menggunakan PT. ODT Untuk membuat model Provisioned Throughput, pilih Ubah. Untuk informasi selengkapnya, lihat Tingkatkan kapasitas pemanggilan model dengan Provisioned Throughput di Amazon Bedrock.

  8. 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, lihatLacak proses step-by-step penalaran agen menggunakan jejak.

    • 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 output dari fungsi API or untuk tindakan dan kemudian pilih Kirim untuk menghasilkan respons agen. Lihat gambar berikut untuk contoh:

      Permintaan jendela uji untuk memberikan contoh keluaran untuk tindakan.

    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 AWS Management Console menggunakan IAMperan dengan izin Amazon Bedrock, dan buka konsol Amazon Bedrock di. https://console.aws.amazon.com/bedrock/

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

  3. Di bagian Agen. pilih tautan untuk agen yang ingin Anda uji dari daftar agen.

  4. Pada halaman detail agen, di bagian Draf kerja, pilih tautan untuk draf Kerja.

  5. Di bagian Grup aksi atau basis Pengetahuan, arahkan kursor ke Status kelompok tindakan atau basis pengetahuan yang statusnya ingin Anda ubah.

  6. Tombol edit muncul. Pilih ikon edit dan kemudian pilih dari menu tarik-turun apakah grup tindakan atau basis pengetahuan Diaktifkan atau Dinonaktifkan.

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

  8. Pilih Siapkan untuk menerapkan perubahan yang telah Anda buat pada agen sebelum mengujinya.

API

Sebelum Anda menguji agen Anda untuk pertama kalinya, Anda harus mengemasnya dengan perubahan draf kerja dengan mengirimkan PrepareAgentpermintaan (lihat tautan untuk format permintaan dan respons serta detail bidang) dengan titik akhir waktu pembuatan Agen untuk Amazon Bedrock. Sertakan agentId dalam permintaan. Perubahan berlaku untuk DRAFT versi, yang ditunjuk TSTALIASID alias.

Lihat contoh kode

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 GetAgentpermintaan (lihat tautan untuk format permintaan dan respons serta detail bidang) dengan titik akhir waktu pembuatan Agen untuk Amazon Bedrock dan periksa preparedAt waktu agen Anda untuk memverifikasi bahwa Anda sedang menguji agen Anda dengan konfigurasi terbaru.

Untuk menguji agen Anda, kirim InvokeAgentpermintaan (lihat tautan untuk format permintaan dan respons serta detail bidang) dengan titik akhir waktu proses Agen untuk Amazon Bedrock.

catatan

Yang AWS CLI tidak mendukung InvokeAgent.

Lihat contoh kode

Bidang berikut ada dalam permintaan:

  • Minimal, berikan bidang wajib berikut:

    Bidang Deskripsi singkat
    agentId ID agen
    agentAliasId ID alias. Gunakan TSTALIASID untuk memanggil versi DRAFT
    sessionId ID alfanumerik untuk sesi (2-100 karakter)
    inputText Pengguna meminta untuk mengirim ke agen

  • Bidang berikut adalah opsional:

    Bidang Deskripsi singkat
    enableTrace Tentukan TRUE untuk melihat jejak.
    endSession Tentukan TRUE untuk mengakhiri sesi dengan agen setelah permintaan ini.
    sessionState Termasuk konteks yang mempengaruhi perilaku agen atau perilaku basis pengetahuan yang melekat pada agen. Untuk informasi selengkapnya, lihat Konteks sesi agen kontrol.

Respons dikembalikan dalam aliran acara. Setiap acara berisichunk, yang berisi bagian dari respons di bytes lapangan, yang harus diterjemahkan. Jika agen menanyakan basis pengetahuan, itu chunk juga termasukcitations. Objek berikut juga dapat dikembalikan: