View a markdown version of this page

Pencernaan ulang gagal - Batu Dasar Amazon AgentCore

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Pencernaan ulang gagal

Ekstraksi dari memori jangka pendek ke memori jangka panjang biasanya otomatis. Jika ekstraksi dari memori jangka pendek ke memori jangka panjang tidak berhasil karena alasan apa pun, AgentCore Memori mencoba mengatasi masalah tersebut. Jika masalah tetap ada, intervensi pengembang mungkin diperlukan dan pekerjaan yang gagal dipindahkan ke antrian khusus untuk sumber daya memori Anda. Salah satu contohnya adalah jika akun Anda menelan memori jangka panjang pada tingkat yang lebih besar daripada yang diizinkan. Dalam hal ini, Anda harus menunggu sampai lalu lintas lebih rendah dan secara manual mengulang pekerjaan yang terkena dampak.

Untuk mengidentifikasi dan mengembalikan pekerjaan yang gagal:

  1. Panggilan ListMemoryExtractionJobs untuk daftar pekerjaan yang gagal. Setiap pekerjaan dalam respons termasuk jobId a dan a failureReason yang menunjukkan mengapa ekstraksi gagal.

  2. Atasi akar penyebab menggunakan kode alasan kegagalan dalam tabel berikut.

  3. Panggil StartMemoryExtractionJob, meneruskan jobId dari daftar pekerjaan yang gagal untuk menelannya kembali ke memori jangka panjang.

Kami merekomendasikan pemantauan metrik yang dijual FailedExtraction untuk diberitahu tentang masalah apa pun. Metrik ini juga memiliki dimensi pada StrategyId, Resource (memori ARN), dan StrategyType. AgentCore Memori memancarkan hitungan metrik ini setiap kali pekerjaan ekstraksi gagal dan ditulis ke penyimpanan pekerjaan ekstraksi.

Untuk strategi bawaan, satu-satunya skenario kegagalan adalah mencapai batas konsumsi. Untuk bawaan dengan override, ada skenario kegagalan tambahan, termasuk masalah dengan model yang telah Anda pilih untuk digunakan di akun Anda atau izin yang telah Anda berikan ke AgentCore Memori.

Kode Alasan Kegagalan Deskripsi Mitigasi yang disarankan

LTM_RATE_EXCEEDED

Akun ini telah melampaui kuota token per menit yang dialokasikan untuk pemrosesan memori jangka panjang

Melalui Kuota Layanan, minta batas yang lebih tinggi untuk kuota Bedrock Agentcore “Token per menit untuk ekstraksi memori jangka panjang.” Kemudian panggil StartMemoryExtractionJob API pada JobID ekstraksi yang gagal.

CUSTOM_MODEL_BEDROCK_ACCESS_DENIED

Memori yang ExecutionRoleArn disediakan selama CreateMemory tidak memiliki izin yang memadai untuk memanggil semua ID model yang disediakan dalam strategi khusus yang dilampirkan ke memori

Pastikan peran tersebut memiliki izin dan kebijakan kepercayaan seperti yang didefinisikan di sini dan tambahkan izin yang hilang. Atau panggil UpdateMemory untuk beralih ke peran yang berbeda dengan izin yang memadai. Kemudian panggil StartMemoryExtractionJob API pada JobID ekstraksi yang gagal.

CUSTOM_MODEL_BEDROCK_INTERNAL_ERROR

Layanan menerima kesalahan internal dari Bedrock ketika mencoba memanggil model yang disediakan dalam strategi khusus.

Ini bisa menjadi kesalahan layanan sementara dari Bedrock. Coba lagi nanti dengan memanggil StartMemoryExtractionJob API pada JobID ekstraksi yang gagal.

CUSTOM_MODEL_BEDROCK_THROTTLING

Layanan menerima pengecualian pelambatan dari Bedrock ketika mencoba memanggil model yang disediakan dalam strategi khusus.

Pastikan akun Anda telah meminta kuota TPM dan RPM yang memadai untuk model tersebut dari Bedrock. Memanggil StartMemoryExtractionJob API pada JobID ekstraksi yang gagal setelah peningkatan kuota atau selama jam lalu lintas rendah.

CUSTOM_MODEL_BEDROCK_MODEL_ERROR

Layanan menerima Pengecualian Kesalahan Model dari Bedrock ketika mencoba memanggil model yang disediakan dalam strategi khusus.

Ini biasanya merupakan kesalahan layanan sementara dari Bedrock. Coba lagi nanti dengan memanggil StartMemoryExtractionJob API pada JobID ekstraksi yang gagal.

CUSTOM_MODEL_BEDROCK_MODEL_TIMEOUT

Layanan menerima Pengecualian Waktu Batas Model dari Bedrock ketika mencoba memanggil model yang disediakan dalam strategi khusus.

Ini terjadi ketika waktu pemrosesan model melebihi batas waktunya. Pertimbangkan untuk beralih ke model yang lebih cepat sebelum memanggil StartMemoryExtractionJob API pada JobID ekstraksi yang gagal.

CUSTOM_MODEL_BEDROCK_RESOURCE_NOT_FOUND

Layanan menerima Sumber Daya Tidak Ditemukan dari Bedrock ketika mencoba memanggil model yang disediakan dalam strategi khusus.

Pastikan modelID yang disediakan dalam strategi kustom apa pun yang terkait dengan memori sudah benar. Panggil UpdateMemory untuk memperbarui nilai-nilai tersebut jika perlu. Kemudian panggil StartMemoryExtractionJob API pada JobID ekstraksi yang gagal.

CUSTOM_MODEL_BEDROCK_MODEL_NOT_READY

Layanan menerima Model Not Ready dari Bedrock ketika mencoba memanggil model yang disediakan dalam strategi khusus.

Tunggu hingga model berada dalam keadaan siap. Lihat dokumentasi Bedrock untuk lebih jelasnya. Kemudian panggil StartMemoryExtractionJob API pada JobID ekstraksi yang gagal.

CUSTOM_MODEL_BEDROCK_SERVICE_UNAVAILABLE

Layanan menerima Layanan Tidak Tersedia dari Bedrock ketika mencoba memanggil model yang disediakan dalam strategi khusus.

Ini biasanya merupakan kesalahan layanan sementara dari Bedrock. Coba lagi nanti dengan memanggil StartMemoryExtractionJob API pada JobID ekstraksi yang gagal.

CUSTOM_MODEL_BEDROCK_VALIDATION_EXCEPTION

Layanan menerima Pengecualian Validasi dari Bedrock ketika mencoba memanggil model yang disediakan dalam strategi khusus.

Pastikan modelID yang disediakan dalam strategi kustom apa pun yang terkait dengan memori sudah benar. Panggil UpdateMemory untuk memperbarui nilai-nilai tersebut jika perlu. Kemudian panggil StartMemoryExtractionJob API pada JobID ekstraksi yang gagal.