View a markdown version of this page

Memecahkan masalah pembayaran AgentCore - Batuan Dasar Amazon AgentCore
Kesalahan validasiKesalahan izinKesalahan sumber daya tidak ditemukanKesalahan konflikKesalahan kuota layananKesalahan throttlingKesalahan pemrosesan pembayaranKesalahan server

Memecahkan masalah pembayaran AgentCore

Bagian ini memberikan solusi untuk kesalahan umum saat menggunakan AgentCore pembayaran AWS Amazon Bedrock.

Kesalahan validasi

Saat membuat atau memperbarui sumber daya pembayaran, layanan mengembalikan fileValidationException. Tabel berikut mencantumkan kesalahan validasi umum dan resolusinya.

Pesan kesalahan Resolusi

roleArn must contain a valid account ID

roleArnHarus menjadi ARN peran IAM yang valid dengan ID akun 12 digit. Verifikasi formatnya:arn:aws:iam::<accountId>:role/<roleName>.

roleArn must belong to your account

ID akun roleArn harus sesuai dengan akun pemanggil. Cross-account peran tidak didukung.

Invalid role ARN: {roleArn}

Itu tidak roleArn bisa diurai. Verifikasi format ARN.

credentialProviderConfigurations list cannot be empty

Berikan setidaknya satu konfigurasi penyedia kredensi saat membuat atau memperbarui konektor pembayaran.

credentialProviderArn is required but not found in the request

Setiap konfigurasi penyedia kredensi harus menyertakan file. credentialProviderArn Buat yang pertama menggunakan Create a Credential Provider.

Connector type '{type}' does not match the provided credentialProviderConfiguration

Varian konfigurasi penyedia kredensi harus sesuai dengan jenis konektor. Misalnya, CoinbaseCDP konektor memerlukan coinbaseCDP konfigurasi, bukanstripePrivy.

Kendala penamaan bidang juga diberlakukan:

  • Nama manajer pembayaran harus dimulai dengan huruf dan hanya berisi karakter alfanumerik (maks 48 karakter).

  • Nama konektor pembayaran mengikuti aturan yang sama tetapi juga memungkinkan garis bawah.

  • Deskripsi memungkinkan karakter dan spasi alfanumerik (maks 4096 karakter).

Kesalahan izin

Pesan kesalahan Resolusi

Access denied due to account security restrictions. Contact AWS Support for assistance.

Akun Anda telah dibatasi. Hubungi AWS Support untuk menyelesaikannya.

Access denied for {CREATE|UPDATE} due to account security restrictions. Contact AWS Support for assistance.

Akun Anda dalam status akses terbatas. Operasi baca dan daftar diizinkan, tetapi operasi buat dan perbarui dibatasi hingga pembatasan diselesaikan.

Kegagalan otorisasi IAM SiGv4

Pastikan kepala sekolah panggilan memiliki bedrock-agentcore: izin yang sesuai. Layanan ini menggunakan penandatanganan SiGv4 dengan nama bedrock-agentcore penandatanganan.

PassRole kegagalan

Saat memberikan aroleArn, penelepon harus memiliki iam:PassRole izin untuk peran tersebut. Kebijakan kepercayaan peran harus memungkinkan bedrock-agentcore.amazonaws.com sebagai kepala layanan.

Kesalahan sumber daya tidak ditemukan

Pesan kesalahan Resolusi

Payment manager not found: {managerId}

Manajer pembayaran yang ditentukan tidak ada. Verifikasi ID dengan meneleponListPaymentManagers.

Payment connector not found: connectorId={connectorId}, managerId={managerId}

Konektor yang ditentukan tidak ada di bawah manajer yang diberikan. Verifikasi kedua ID menggunakanListPaymentConnectors.

Sumber daya tidak ditemukan selama CreatePaymentConnector

Manajer pembayaran induk tidak ada. Buat manajer pembayaran terlebih dahulu.

Kesalahan konflik

Layanan mengembalikan ConflictException ketika dua permintaan memodifikasi sumber daya yang sama pada saat yang sama, atau saat membuat sumber daya yang sudah ada. Coba lagi permintaannya. Membuat dan memperbarui operasi mendukung a clientToken untuk percobaan ulang yang aman.

Kesalahan kuota layanan

Layanan kembali "{limitType} limit exceeded for account {accountId}" ketika Anda mencapai jumlah maksimum manajer pembayaran atau konektor untuk akun Anda. Hapus sumber daya yang tidak digunakan atau hubungi AWS Support untuk meminta peningkatan batas.

Kesalahan throttling

Layanan kembali "Rate exceeded" ketika tingkat permintaan melebihi batas yang diizinkan. Terapkan backoff eksponensial dengan jitter dalam logika coba lagi Anda. Jika Anda secara konsisten mencapai batas, hubungi AWS Support.

Kesalahan pemrosesan pembayaran

Jika penyedia pembayaran eksternal menolak permintaan penandatanganan, layanan mengembalikan AccessDeniedException atauValidationException. Tabel berikut mencantumkan kesalahan umum dan resolusinya.

Pesan kesalahan Resolusi

Delegated signing grant is not active for the end user wallet. Please redirect end user to the WalletHub to grant the permissions.

Anda belum memberikan izin delegasi yang memungkinkan agen Anda untuk menandatangani transaksi atas nama Anda, atau Anda sebelumnya mencaatnya. Untuk menyelesaikan:

  1. Ambil WalletHub URL dari CreatePaymentInstrument or GetPaymentInstrument response body (paymentInstrumentDetails.redirectUrl).

  2. Arahkan pengguna ke. WalletHub

  3. Masuk dan berikan izin penandatanganan kepada agen.

Untuk informasi lebih lanjut tentang implementasi frontend yang menangani alur hibah delegasi, lihat AgentCore template Coinbase di situs web. GitHub Untuk informasi selengkapnya tentang mendanai dompet, lihat Mendanai dompet.

Delegated signing is not enabled for your Coinbase project. Please enable delegated signing in your Coinbase project policies.

Proyek Platform Pengembang Coinbase Anda tidak memiliki penandatanganan yang didelegasikan yang dikonfigurasi. Untuk menyelesaikan:

  1. Masuk ke Platform Pengembang Coinbase di situs web Coinbase.

  2. Arahkan ke setelan Kebijakan proyek Anda.

  3. Aktifkan sakelar Penandatanganan Delegasi.

Anda harus menyelesaikan langkah ini sebelum agen Anda dapat menandatangani transaksi atas nama pengguna.

Privy credentials are invalid. Please verify the credential configuration.

Penyedia kredensi Anda memiliki kunci otorisasi dompet Privy yang tidak valid atau kedaluwarsa. Untuk menyelesaikan:

  1. Masuk ke Dasbor Privy di situs web Privy.

  2. Arahkan ke setelan aplikasi Anda dan verifikasi kunci otorisasi aktif.

  3. Perbarui penyedia kredensi di AgentCore Identity dengan kunci saat ini. Untuk melakukan ini, hubungi UpdatePaymentConnector atau perbarui AWS rahasia di Secrets Manager.

Untuk informasi selengkapnya tentang konfigurasi kredensi, lihat Privy AgentCore SDK di situs web. GitHub

Kesalahan server

Layanan kembali "Something went wrong in processing your request" untuk kesalahan internal. Coba lagi permintaan setelah penundaan singkat. Jika kesalahan berlanjut, hubungi AWS Support dengan ID permintaan dari header x-amzn-requestid respons.