View a markdown version of this page

Konfigurasi propagasi bundel dan observabilitas - Batuan Dasar Amazon AgentCore
Bagaimana bundel konfigurasi menyebarPerilaku pada target MCPBatasanObservabilitas untuk resolusi aturan

Konfigurasi propagasi bundel dan observabilitas

Ketika gateway menyelesaikan bundel konfigurasi melalui aturan, gateway menyebarkan bundel ke layanan hilir melalui header bagasi OpenTelemetry (OTel). Ini memungkinkan manajemen konfigurasi ujung ke ujung di seluruh gateway dan arsitektur agen Anda.

Bagaimana bundel konfigurasi menyebar

Gateway menetapkan bundel ARN dan versi yang diselesaikan dalam bagasi OTel menggunakan kunci berikut:

Kunci bagasi Deskripsi

aws.agentcore.configbundle_arn

ARN dari bundel konfigurasi yang diselesaikan.

aws.agentcore.configbundle_version

Versi bundel konfigurasi yang diselesaikan.

Aliran propagasi bekerja sebagai berikut:

  1. Gateway mengevaluasi aturan dan menyelesaikan bundel konfigurasi.

  2. Gateway menetapkan bundel ARN dan versi di header bagasi OTel pada permintaan keluar.

  3. Runtime agen menerima permintaan dengan header bagasi. Runtime dikendalikan oleh Anda. Kode agen Anda dapat membaca paket konfigurasi ARN dan versi dari bagasi OTel jika diperlukan.

  4. Jika agen memanggil gateway dengan target MCP, gateway akan membaca bundel dari bagasi OTel dan menerapkan penggantian deskripsi alat pada respons. tools/list Lihat perinciannya di Perilaku pada target MCP.

Perilaku pada target MCP

Gateway menerapkan penggantian bundel konfigurasi pada target MCP hanya untuk jalur. tools/list search_toolJalur invoke_tool dan tidak mendukung penggantian bundel konfigurasi.

Misalnya, jika bundel konfigurasi mengganti deskripsi alat target, deskripsi yang diperbarui akan muncul dalam tools/list tanggapan tetapi tidak dalam search_tool tanggapan.

Untuk menerapkan penggantian ini, gateway memanggil GetConfigurationBundleVersion untuk membaca konten bundel. Tambahkan izin ini ke peran eksekusi gateway:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "bedrock-agentcore:GetConfigurationBundleVersion",
            "Resource": "arn:aws:bedrock-agentcore:us-west-2:123456789012:configuration-bundle/*"
        }
    ]
}
catatan

Izin ini hanya diperlukan pada peran eksekusi gateway untuk tools/list operasi MCP. Runtime agen melewati bundel tanpa mengaksesnya dan tidak memerlukan izin ini.

Batasan

  • Bundel konfigurasi harus berada di akun yang sama dengan gateway. Cross-account akses bundel tidak didukung.

  • Gateway dengan target HTTP tidak membaca bundel konfigurasi dari bagasi OTel. Mereka menyelesaikan bundel hanya melalui aturan mereka sendiri. Jika Anda meneruskan bundel dalam bagasi OTel ke gateway dengan target HTTP, gateway akan mengabaikannya.

  • Gateway dengan target MCP membaca bundel konfigurasi dari bagasi OTel dan menerapkan penggantian di jalur saja. tools/list

Observabilitas untuk resolusi aturan

Saat gateway menyelesaikan aturan untuk permintaan, gateway memancarkan atribut span pada rentang server gateway. Anda dapat menggunakan atribut ini untuk mengamati versi bundel konfigurasi dan keputusan perutean yang diterapkan.

Atribut penggantian bundel konfigurasi

Atribut rentang Deskripsi

aws.agentcore.configbundle_arn

ARN dari bundel konfigurasi yang diselesaikan.

aws.agentcore.configbundle_version

Versi bundel konfigurasi yang diselesaikan.

Atribut perutean target

Atribut rentang Deskripsi

aws.agentcore.gateway.resolved_target_name

Nama target yang diselesaikan.

Gunakan atribut ini untuk memverifikasi bahwa aturan diselesaikan seperti yang diharapkan dan untuk memecahkan masalah perilaku perutean.