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

Memecahkan masalah penerapan kode langsung

Masalah dan solusi umum saat memulai dengan penyebaran kode AgentCore langsung Amazon Bedrock. Untuk informasi pemecahan masalah selengkapnya, lihat Mem ecahkan Masalah Amazon Bedrock AgentCore Runtime.

AccessDenied: Izin S3 tidak mencukupi

Ketika ini terjadi: Selama pembuatan atau pembaruan agen dengan artefak zip di S3 melalui konsol, SDK, atau CLI

Mengapa ini terjadi: Peran yang digunakan untuk memang Create/UpdateAgentRuntime gil tidak memiliki GetObject izin s3: pada S3 uri yang diteruskan dalam input API.

Solusi: Tambahkan s3: GetObject izin dalam peran yang digunakan untuk memanggil Agentcore Runtime create/update API.

{
"Version": "2012-10-17",
  "Statement": [
    {
        "Effect": "Allow",
        "Action": "s3:GetObject",
        "Resource": "arn:aws:s3:::your-bucket-name/*"
    }
  ]
}

AccessDenied: Akses objek S3 terenkripsi CMK

Ketika ini terjadi: Selama pembuatan agen dengan objek CMK-encrypted S3 ketika peran eksekusi tidak memiliki izin dekripsi KMS.

Mengapa ini terjadi: Per an yang digunakan untuk memanggil Create/UpdateAgentRuntime tidak memiliki izin KMS:Decrypt pada CMK yang digunakan untuk mengenkripsi objek S3 yang berisi kode agen.

Solusi: Tambahkan KMS:mendekripsi izin ke peran untuk CMK tertentu:

{
"Version": "2012-10-17",
  "Statement": [
    {
        "Effect": "Allow",
        "Action": [
            "s3:GetObject",
            "kms:Decrypt"
        ],
        "Resource": [
            "arn:aws:s3:::your-bucket-name/*",
            "arn:aws:kms:us-west-2:your-account:key/your-cmk-key-id"
        ]
    }
  ]
}

CREATE_FAILED: Kompatibilitas paket kode

Ketika ini terjadi: Selama pembuatan agen atau pembaruan dengan paket kode yang tidak kompatibel (arsitektur, versi bahasa, atau format paket yang salah).

Mengapa ini terjadi: File ZIP yang diunggah berisi biner yang dikompilasi untuk arsitektur yang salah (ARM64 vs x86_64), versi bahasa yang tidak kompatibel, atau struktur paket salah yang tidak sesuai dengan persyaratan Runtime. AgentCore

Solusi:

Untuk menyelesaikan masalah ini:

Indikator kesalahan:

Ketidakcocokan Biner ARM64

Ketika ini terjadi: Selama pembuatan agen ketika ZIP Anda berisi binari asli yang dikompilasi untuk arsitektur non-ARM64.

Mengapa ini terjadi: AgentCore Runtime hanya mendukung arsitektur set instruksi arm64. Layanan memindai semua file biner asli dalam paket penerapan Anda - .so file untuk Python dan keduanya .so dan .node file untuk Node.js - dan memvalidasi header ELF mereka untuk kompatibilitas ARM64. Jika ada biner yang dikompilasi untuk x86_64, macOS (Mach-O), atau arsitektur lain, validasi gagal.

Solusi:

Indikator kesalahan: "Your artifact contains binary files that are incompatible with Linux ARM64."

Titik Masuk Hilang

Ketika ini terjadi: Selama pembuatan agen ketika file titik masuk yang ditentukan tidak ada di ZIP Anda.

Mengapa ini terjadi: Jalur file titik masuk yang Anda tentukan dalam entryPoint konfigurasi tidak cocok dengan file apa pun dalam paket penerapan. Ini dapat terjadi jika file tidak disertakan dalam ZIP, jalur salah eja, atau struktur ZIP berbeda dari yang Anda harapkan.

Solusi:

Indikator kesalahan: "The specified entrypoint could not be found or accessed in your artifact."

Node.js Deklarasi engines.node yang tidak kompatibel

Ketika ini terjadi: Selama pembuatan Node.js agen ketika ketergantungan Anda package.json atau umum mendeklarasikan engines.node rentang yang mengecualikan Node.js versi target.

Mengapa ini terjadi: AgentCore Runtime memeriksa engines.node bidang di root Anda package.json dan di dependensi umum. Jika rentang versi mengecualikan Node.js versi target (misalnya, <18 atau >=14 <18 saat menerapkan ke Node.js 22), pembuatan agen gagal.

Solusi:

Indikator kesalahan: "Your artifact contains dependencies with engines.node declarations incompatible with the target Node.js version."

Node.js Paket OTEL Hilang

Ketika ini terjadi: Selama pembuatan Node.js agen ketika Anda menentukan opentelemetry-instrument di titik masuk tetapi paket ADOT tidak termasuk dalam ZIP.

Mengapa ini terjadi: Saat Anda menggunakan"entryPoint": ["opentelemetry-instrument", "app.js"], AgentCore Runtime mengharapkan paket @aws/aws-distro-opentelemetry-node-autoinstrumentation npm hadir di node_modules/ dalam paket penerapan Anda.

Solusi:

Instal paket ADOT sebelum mengemas ZIP Anda:

npm install @aws/aws-distro-opentelemetry-node-autoinstrumentation
zip -r deployment_package.zip app.js node_modules/ package.json

Atau, hapus opentelemetry-instrument awalan dari titik masuk Anda jika Anda tidak memerlukan instrumentasi otomatis.

Indikator kesalahan: "OpenTelemetry instrumentation executable not found. The ZIP file requires open-telemetry dependencies, but none are present."