View a markdown version of this page

Menguji dan memecahkan masalah perilaku agen - Amazon Bedrock
Menelusuri perilaku agenUji agen Anda

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 rock. Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Untuk informasi selengkapnya, lihat Mode perawatan klasik Amazon Bedrock Agents.

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.

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 dengan menggunakan alias pengujianTSTALIASID, atau alias lain yang menunjuk ke versi statis. Sebelum Anda dapat menguji agen Anda, Anda harus mempersiapkan agen Anda dengan menelepon PrepareAgent.

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

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.

  2. Pilih A gen 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. 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.

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

  6. Untuk memilih alias dan versi terkait untuk diuji, gunakan menu dropdown di bagian atas jendela Tes. 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 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.

  8. (Opsional) Untuk menggunakan prompt dari manajemen prompt, pilih ikon opsi ( Vertical ellipsis icon representing a menu or more options. ) 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, lihatBuat dan simpan petunjuk yang dapat digunakan kembali dengan manajemen Prompt di Amazon Bedrock.

  9. 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, lihatLacak proses penalaran langkah demi langkah agen menggunakan jejak.

    • 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:

      Permintaan jendela uji untuk memberikan contoh output untuk tindakan.

    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.

  2. Pilih A gen 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 D raf kerja, pilih tautan untuk D raf Kerja.

  5. Di bagian Grup tindakan atau Basis pengetahuan, arahkan kursor ke Status grup tindakan atau basis pengetahuan yang statusnya ingin Anda ubah.

  6. Tombol edit muncul. Pilih ikon edit dan kemudian pilih dari menu dropdown apakah grup tindakan atau basis pengetahuan diaktifkan atau din on aktifkan.

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

  8. 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 permintaan dengan titik akhir waktu pembuatan Agen untuk Amazon Bedrock. 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.

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

Untuk menguji agen Anda, ki InvokeAgent rim permintaan ke agen. Untuk kode sampel, lihat Memanggil agen dari aplikasi Anda.

catatan

Itu AWS CLI tidak mendukung InvokeAgent.

Bidang berikut ada dalam permintaan:

  • Minimal, berikan kolom wajib berikut:

    Bidang Deskripsi singkat
    agentId ID agen
    agen AliasId ID alias. Gunakan TSTALIASID untuk memanggil versi DRAFT
    ID sesi ID alfanumerik untuk sesi (2-100 karakter)
    MasukanTeks Permintaan pengguna untuk mengirim ke agen

  • Bidang berikut bersifat opsional:

    Bidang Deskripsi singkat
    AktifkanTrace Tentukan TRUE untuk melihat jejak.
    Sesi Akhir Tentukan TRUE untuk mengakhiri sesi dengan agen setelah permintaan ini.
    SesiNegara Termasuk konteks yang mempengaruhi perilaku agen atau perilaku basis pengetahuan yang melekat pada agen. Untuk informasi selengkapnya, lihat Konteks sesi agen kontrol.
    Konfigurasi Streaming Termasuk konfigurasi untuk respons streaming. Untuk mengaktifkan streaming, setel streamFinalResponse keTRUE.

Respons dikembalikan dalam aliran acara. Setiap peristiwa berisi achunk, 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, lihatLacak proses penalaran langkah demi langkah agen menggunakan jejak.

  • Jika Anda mengatur grup tindakan untuk melewatkan menggunakan fungsi Lambda, ReturnControlPayload objek dikembalikan di returnControl lapangan. Struktur umum ReturnControlPayload objek adalah sebagai berikut:

    {
    "invocationId": "string",
    "invocationInputs": [
        ApiInvocationInput or FunctionInvocationInput,
        ...
    ]
}

    Setiap anggota invocationInputs daftar adalah salah satu dari berikut ini:

    • Ob ApiInvocationInput 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 objek adalah sebagai berikut:

      {
    "actionGroup": "string",
    "apiPath": "string",
    "httpMethod": "string",
    "parameters": [
        {
            "name": "string",
            "type": "string",
            "value": "string"
        },
        ...
    ],
    "requestBody": {
        <content-type>: {
            "properties": [
                {
                    "name": "string",
                    "type": "string",
                    "value": "string"
                }
            ]
        }
    }
}

    • Ob FunctionInvocationInput jek yang berisi fungsi yang diprediksi agen harus dipanggil berdasarkan input pengguna, selain parameter untuk fungsi yang didapat dari pengguna. Strukturnya FunctionInvocationInput adalah sebagai berikut:

      {
    "actionGroup": "string",
    "function": "string",
    "parameters": [
        {
            "name": "string",
            "type": "string",
            "value": "string"
        }
    ]
}