Memecahkan masalah penyebaran kode langsung

Masalah dan solusi umum saat memulai penerapan kode AgentCore langsung Amazon Bedrock. Untuk informasi pemecahan masalah lainnya, lihat Memecahkan Masalah Amazon Bedrock Runtime. AgentCore

AccessDenied: Izin S3 tidak mencukupi

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

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

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

{
"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: Peran yang digunakan untuk memanggil Create/UpdateAgentRuntime tidak memiliki izin KMS: Dekripsi pada CMK yang digunakan untuk mengenkripsi objek S3 yang berisi kode agen.

Solusi: Tambahkan izin KMS: Dekripsi 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 yang salah, versi bahasa, atau format paket).

Mengapa ini terjadi: File ZIP yang diunggah berisi binari yang dikompilasi untuk arsitektur yang salah (ARM64 vs x86_64), versi bahasa yang tidak kompatibel, atau struktur paket yang 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 ini memindai semua file biner asli dalam paket penyebaran Anda — .so file untuk Python dan keduanya dan .node file untuk Node.js — dan memvalidasi .so 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 bisa terjadi jika file tidak disertakan dalam ZIP, jalurnya 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 dependensi Anda package.json atau umum mendeklarasikan engines.node rentang yang mengecualikan versi target. Node.js

Mengapa ini terjadi: AgentCore Runtime memeriksa engines.node bidang di root Anda package.json dan dalam 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."