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
<a name="runtime-code-deploy-common-issues"></a>

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](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/runtime-troubleshooting.html).

## AccessDenied: Izin S3 tidak mencukupi
<a name="permission-issues-s3"></a>

 **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
<a name="permission-issues-cmk"></a>

 **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
<a name="code-package-compatibility"></a>

 **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:

1. Pastikan kode dikompilasi untuk arm64.

1. Gunakan versi bahasa yang kompatibel (periksa versi AgentCore yang didukung Runtime).

1. Verifikasi struktur ZIP berisi titik masuk dan dependensi yang tepat.

1. Bangun kembali paket pada lingkungan runtime yang kompatibel.

 **Indikator kesalahan: ** 
+ Status agen: CREATE\_FAILED atau kesalahan runtime
+ Mengimpor kesalahan atau pesan “tidak dapat mengeksekusi file biner” di log cloudwatch
+ Kesalahan ketidakcocokan arsitektur saat Anda mendap AgentRuntimeEndpoint atkannya.

## Ketidakcocokan Biner ARM64
<a name="arm64-binary-incompatibility"></a>

 **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:** 
+  **Python: ** Gunakan `uv pip install --python-platform aarch64-manylinux2014 --only-binary=:all:` untuk mengunduh roda yang kompatibel dengan arm64.
+  **Node.js: ** Instal modul asli pada mesin arm64 atau gunakan`npm install --arch=arm64 --platform=linux`.
+ Atau, buat dependensi Anda pada instans AWS Graviton-based Amazon EC2 untuk memastikan kompatibilitas arm64.

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

## Titik Masuk Hilang
<a name="missing-entry-point"></a>

 **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:** 
+ Pastikan file titik masuk ada di ZIP Anda: `unzip -l deployment_package.zip | grep app.js` 
+ Pastikan jalur di `entryPoint` cocok dengan jalur file dalam ZIP (termasuk subdirektori seperti `src/app.js` atau`dist/index.js`)
+ Untuk agen Python, titik masuk harus diakhiri dengan`.py`; untuk Node.js agen, itu harus diakhiri dengan `.js` 

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

## Node.js Deklarasi engines.node yang tidak kompatibel
<a name="node-incompatible-engines"></a>

 **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:** 
+ Perbarui `engines.node` bidang di Anda `package.json` untuk menyertakan Node.js versi target (misalnya,`">=18"`)
+ Perbarui dependensi yang tidak kompatibel ke versi yang mendukung versi target Node.js 
+ H `engines` apus bidang jika tidak diperlukan

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

## Node.js Paket OTEL Hilang
<a name="node-missing-otel-package"></a>

 **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."`