Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Pemecahan Masalah
Migrasi Sekarang Dibuka
AWS Agen Registry telah diluncurkan di bawah agent-registry namespace baru. Dukungan untuk bedrock-agentcore namespace pratinjau publik akan dihentikan pada 17 September 2026. Untuk petunjuk migrasi, lihat Panduan migrasi registri komprehensif.
Kesalahan validasi skema
Saat membuat berbagai jenis catatan, Anda mungkin melihat pengecualian validasi untuk deskriptor. Lihat bagian Jenis rekaman yang didukung untuk skema yang valid.
Kesalahan umum:
-
“Versi skema '0.3.0' tidak didukung untuk tipe deskriptor 'a2a'.” — Nilai bidang schemaVersion seharusnya
0.3bukan.0.3.0Ini sejalan dengan deskripsi versi protokol A2A resmidi situs web Protokol A2A: “Gunakan versi minor terbaru yang didukung per versi utama”. -
“Validasi skema gagal: konten tidak sesuai dengan skema versi '0.3' untuk tipe deskriptor 'a2a'.” - Anda dapat menemukan skema pada jenis catatan yang didukung. Perhatikan bahwa konten akan divalidasi terhadap #/ definitions/AgentCard dalam skema json.
Rekam kesalahan sinkronisasi
Saat Anda membuat atau memperbarui rekaman menggunakan fitur sinkronisasi, catatan dapat beralih ke status CREATE_FAILED atau UPDATE_FAILED, dengan penjelasan apa yang terjadi. statusReason
Pada tingkat tinggi, kesalahan dapat dikategorikan sebagai: kesalahan izin, kesalahan koneksi, kesalahan validasi, dan kesalahan sisi server.
Kesalahan izin
Konfigurasi sinkronisasi salah atau kedaluwarsa:
-
“Tidak dapat terhubung ke server MCP karena kredenSIAL pemanggil telah kedaluwarsa.” — Kredensi Anda untuk membuat atau memperbarui API telah kedaluwarsa. Anda dapat mencoba lagi dengan UpdateRegistryRecord API.
-
“Menerima pengecualian dari GetWorkloadAccessToken API:<detailed message>" — Registri memang GetWorkloadAccessToken gil API atas nama Anda. Lihat pesan terperinci untuk kesalahan spesifik. Lihat Menyinkronkan catatan dari sumber eksternal jika Anda melihat kesalahan akses ditolak.
-
“Tidak dapat mengurai penyedia kredensia ARN:<arn>" — Penyedia kredensia ARN salah format. Berikan penyedia kredensi valid ARN yang dibuat dari AgentCore Identity.
-
“Menerima pengecualian dari GetResourceOauth2Token API:<detailed message>" — Registri memang GetResourceOauth2Token gil API atas nama Anda. Lihat pesan terperinci untuk kesalahan spesifik. Lihat Menyinkronkan catatan dari sumber eksternal jika Anda melihat kesalahan akses ditolak.
-
“Tidak dapat mengambil peran IAM yang disediakan untuk otorisasi server MCP.” — Registri memanggil AssumeRole API atas nama Anda. Lihat Men yinkronkan catatan dari sumber eksternal untuk izin IAM yang diharapkan. Misalnya, Anda harus memiliki
iam:PassRoleizin.
Kesalahan koneksi
Tidak dapat menjangkau server:
-
“Gagal mengambil kartu agen dari URL: %s” — A2A IOException
-
“Server MCP mengembalikan HTTP<code>" — respon non- 200/202 HTTP dari server MCP. Harap periksa apakah URL-nya benar dan server MCP dapat dihubungkan.
-
Jika kode statusnya 401 atau 403, verifikasi bahwa Anda telah mengonfigurasi penyedia kredensia yang benar dan bahwa kredenSIAL Anda memiliki izin untuk terhubung ke server MCP. Untuk memecahkan masalah, dapatkan kredenSIAL secara manual dan sambungkan langsung ke server MCP.
-
“URL yang disediakan diselesaikan ke alamat IP non-publik” - Registry hanya mendukung koneksi ke server alamat IP publik.
-
“Gagal terhubung ke server MCP” — kegagalan IOException/connection
-
“URL server MCP tidak valid” — URL yang salah format
-
“Gagal menginisialisasi koneksi MCP” - menginisialisasi pengecualian permintaan
-
“Gagal mengirim pemberitahuan yang diinisialisasi” - pengecualian pemberitahuan
-
“Gagal membuat daftar alat dari server MCP” — pengecualian tools/list
-
“MCP server tools/list pagination out” — registri hanya mendukung paling banyak 30 detik saat membuat paginating alat dari server MCP. Hubun AWS gi dukungan jika server MCP Anda membutuhkan lebih banyak waktu untuk sinkronisasi.
Kesalahan validasi
Server merespons tetapi konten tidak didukung:
-
“Gagal mengurai kartu agen JSON” - Konten A2A kosong atau JSON salah format
-
“Kartu agen melebihi batas ukuran maksimum” - respons A2A terlalu besar
-
“Gagal mengurai respons server MCP JSON” - Konten MCP kosong atau cacat
-
“Server MCP mengembalikan respons yang tidak valid: hasil hilang” - hasil MCP JSON-RPC hilang
-
“Respon server MCP melebihi ukuran maksimum yang diizinkan” - respons MCP terlalu besar
-
“Tipe deskriptor %s tidak mendukung sinkronisasi URL” — tipe deskriptor yang tidak didukung
Kesalahan sisi server
-
“Kesalahan tidak diketahui” - Ini adalah kesalahan sisi server. Silakan coba lagi nanti atau hubungi AWS dukungan untuk bantuan.
Auto-detection kesalahan
“Membuat registri bercakupan organisasi mengharuskan pemanggil untuk menjadi bagian dari AWS Organisasi.”
Akun yang membuat registri bukan anggota AWS Organisasi (misalnya, ini adalah akun mandiri). Buat registri dari akun milik organisasi Anda.
“Auto-detection Prasyarat tidak terpenuhi untuk organisasi ini.”
Organisasi belum memenuhi prasyarat deteksi otomatis, atau mereka belum selesai menyebarkan. Konfirmasikan bahwa akses tepercaya diaktifkan untuk deteksi otomatis dan bahwa Anda membuat registri dari akun manajemen atau administrator delegasi terdaftar, lalu coba lagi setelah menunggu sebentar. Lihat Meng aktifkan deteksi otomatis di seluruh organisasi Anda.
“Registri bercakupan organisasi sudah ada untuk akun ini.”
Akun ini sudah memiliki registri bercakupan organisasi, dan akun hanya dapat memiliki satu. Gunakan registri yang ada, atau hapus sebelum membuat yang lain. Jika Anda tidak dapat menemukan registri di akun ini, lihat Menemukan registr i bercakupan organisasi yang ada.
“Registri bercakupan organisasi lain dengan deteksi otomatis aktif sudah ada untuk organisasi ini.”
Akun lain di organisasi Anda sudah memiliki registri bercakupan organisasi dengan deteksi otomatis aktif, dan organisasi hanya dapat memiliki satu per satu. Untuk alasan keamanan, pesan kesalahan tidak memberi nama akun yang memiliki registri yang ada. Untuk menemukannya dan memilih cara menyelesaikan konflik, lihat Menemukan registri bercakupan organisasi yang ada.
Menemukan registri bercakupan organisasi yang ada
Ketika CreateRegistry melaporkan bahwa registri bercakupan organisasi sudah ada — baik di akun Anda atau di tempat lain di organisasi Anda — kesalahan tidak memberi nama registri tertentu atau akun yang memilikinya. Temukan registri yang ada terlebih dahulu, lalu putuskan cara menyelesaikan konflik.
Registri bercakupan organisasi biasanya dimiliki oleh salah satu akun berikut:
-
Akun manajemen organisasi.
-
Akun yang saat ini terdaftar sebagai administrator yang di delegasikan untuk AWS Agen Registry.
Mintalah administrator dengan akses ke akun tersebut untuk mencantumkan registri di Wilayah yang sama dengan panggilan yang gagal, dan cari yang: autoDetectionConfiguration.scope ORGANIZATION
aws agent-registry-control list-registries --region us-east-1
Dari akun manajemen, konfirmasikan akun mana yang saat ini merupakan administrator yang didelegasikan:
aws organizations list-delegated-administrators \ --service-principal agent-registry.amazonaws.com
Konflik hanya berlaku dalam Wilayah yang sama — registri di us-east-1 tidak mencegah pembuatannya dius-west-2.
Setelah Anda menemukan registri yang ada, pilih salah satu jalur berikut:
-
Bagikan dan gunakan kembali. Mintalah akun pemilik memberikan akses akun Anda menggunakan AWS RAM, dan kelola catatan di registri bersama alih-alih membuat yang baru. Lihat Berbagi registri di seluruh akun dengan AWS RAM.
-
Bebaskan slot tanpa menghapus. Akun pemilik ditetapkan
autoDetectionConfiguration.enabledkefalseregistri yang ada; setelah pembaruan berlaku, coba lagiCreateRegistry. Lihat Men onaktifkan deteksi otomatis pada registr i. -
Hapus registri yang ada. Jika tidak lagi diperlukan, akun pemilik menghapusnya. Lihat Mematikan deteksi otomatis untuk urutan pembongkaran.
CreateRegistrygagal meskipun akses tepercaya diaktifkan dan administrator yang didelegasikan terdaftar
Konfirmasikan bahwa akun manajemen memiliki peran terkait layanan AWS Agen Registry ()AWSServiceRoleForAgentRegistry. Itu harus ada di akun manajemen sebelum registri bercakupan organisasi dapat dibuat, bahkan ketika administrator yang didelegasikan adalah yang membuatnya. Lihat Langkah 1: Mengaktifkan akses tepercaya dan membuat peran terkait layanan.
Registri SI AP tetapi catatan tidak muncul
Konfirmasikan status deteksi otomatis registri adalah ACTIVE (denganget-registry) dan bahwa akun anggota berisi jenis sumber daya yang didukung (AgentCore Runtimes atau Gateway). Berikan waktu untuk penyelesaian penemuan — pada penyiapan pertama, penemuan awal sumber daya yang sudah ada sebelumnya dapat memakan waktu hingga 20 menit.
Auto-detection status masih menunjukkan “Akun administrator yang didelegasikan registri telah dibatalkan pendaftaran” setelah administrator yang didelegasikan didaftarkan ulang
Ketika akun manajemen membatalkan pendaftaran administrator yang didelegasikan yang memiliki registri bercakupan organisasi, Registry AWS Agen menonaktifkan deteksi otomatis pada registri tersebut dan mencatat alasan status Alasan status The registry’s delegated administrator account was deregistered. ini menjelaskan mengapa deteksi otomatis awalnya dinonaktifkan — ini adalah catatan historis dan tidak diperbarui saat status organisasi berubah nanti.
Jika administrator yang didelegasikan terdaftar lagi, deteksi otomatis registri tidak dilanjutkan secara otomatis dan alasan status terus menampilkan pesan deregistrasi. Ini diharapkan dalam setiap situasi berikut:
-
Akun yang sama didaftarkan ulang sebagai administrator yang didelegasikan.
-
Akun yang berbeda didaftarkan sebagai administrator yang didelegasikan — termasuk ketika akun tersebut sudah memiliki registri bercakupan organisasi sendiri dengan deteksi otomatis yang sebelumnya dinonaktifkan.
-
Tidak ada administrator delegasi baru yang terdaftar, dan akun manajemen memiliki registri bercakupan organisasi secara langsung.
Untuk melanjutkan deteksi otomatis, akun yang memiliki registri yang terpengaruh harus secara eksplisit diatur enabled kembali ketrue. Hanya satu registri bercakupan organisasi per Wilayah yang dapat dis autoDetection.status etel ACTIVE dalam suatu organisasi, jadi jika beberapa registri memenuhi syarat, aktifkan kembali deteksi otomatis hanya pada registri yang ingin tetap aktif.
aws agent-registry-control update-registry \ --registry-id <registry-id-or-arn> \ --auto-detection-configuration '{"optionalValue":{"scope":"ORGANIZATION","enabled":true}}' \ --region us-east-1
Untuk siklus hidup lengkap, lihat Mem atikan deteksi otomatis.
“Registri tidak dapat dihapus saat deteksi otomatis diaktifkan. Nonaktifkan deteksi otomatis terlebih dahulu.”
Anda harus menonaktifkan deteksi otomatis sebelum dapat menghapus registri bercakupan organisasi. Untuk menghapus registri, selesaikan langkah-langkah ini secara berurutan:
-
Nonaktifkan deteksi otomatis pada registri (diatur
autoDetectionConfiguration.enabledkefalse). -
Hapus semua catatan registri.
-
Hapus registri.
Untuk informasi selengkapnya, lihat Menonaktifkan deteksi otomatis pada registr i.