Memulai dengan AgentCore Code Interpreter

AgentCore Code Interpreter memungkinkan agen Anda untuk mengeksekusi kode Python di lingkungan yang aman dan terkelola. Agen dapat melakukan perhitungan, menganalisis data, menghasilkan visualisasi, dan memvalidasi jawaban melalui eksekusi kode.

Halaman ini mencakup prasyarat dan menyediakan dua pendekatan untuk memulai:

• Menggunakan AWS Strands - Kerangka kerja agen tingkat tinggi yang menyederhanakan pembuatan agen AI dengan integrasi alat bawaan, manajemen percakapan, dan penanganan sesi otomatis.

• Penggunaan langsung - Pendekatan SDK dan Boto3 yang memberikan kontrol lebih besar atas manajemen sesi dan eksekusi kode untuk implementasi khusus.

Topik

• Prasyarat

• Mengonfigurasi kredensial Anda

• Menggunakan AgentCore Code Interpreter melalui AWS Helai

• Menggunakan AgentCore Code Interpreter secara langsung

Prasyarat

Sebelum memulai, pastikan Anda memiliki:

• AWS akun dengan kredenSIAL dikonfigurasi. Lihat Mengon figurasi kredensibilitas Anda.

• Python 3.10+ diinstal

• Boto3 diinstal. Lihat dokument asi Boto3.

• Peran eksekusi IAM dengan izin yang diperlukan. Lihat Mengon figurasi kredensibilitas Anda.

• Akses model: Anthropic Claude Sonnet 4.0 diaktifkan di konsol Amazon Bedrock. Untuk informasi tentang menggunakan model yang berbeda dengan Strands Agents lihat bagian Penye dia Model dalam dokumentasi Strands Agents SDK.

• AWS Wilayah di mana Amazon Bedrock AgentCore tersedia. Lihat Wil AWS ayah yang Didukung.

Mengonfigurasi kredensial Anda

Lakukan langkah-langkah berikut untuk mengonfigurasi AWS kredenSIAL Anda dan melampirkan izin yang diperlukan.

1. Verifikasi AWS kredensi Anda

   Konfirmasikan AWS kredensi Anda dikonfigurasi:

   aws sts get-caller-identity

   catatan

   Catat pengguna atau kredenSIAL yang dikembalikan di sini, karena Anda akan menggunakannya saat melampirkan izin yang diperlukan.

   Jika perintah ini gagal, konfigurasikan kredenSIAL Anda. Untuk informasi selengkapnya, lihat Konfigurasi dan pengaturan file kredensia di AWS CLI.

2. Lampirkan izin yang diperlukan

   Pengguna atau peran IAM Anda memerlukan izin untuk menggunakan Penerjemah AgentCore Kode. Lampirkan kebijakan ini ke identitas IAM Anda:

   catatan

   Ganti <region> dengan wilayah yang Anda pilih (misalnya,us-west-2) dan <account_id> dengan ID AWS akun Anda dalam kebijakan di bawah ini:

   {
       "Version":"2012-10-17",	
       "Statement": [
           {
               "Sid": "BedrockAgentCoreCodeInterpreterFullAccess",
               "Effect": "Allow",
               "Action": [
                   "bedrock-agentcore:CreateCodeInterpreter",
                   "bedrock-agentcore:StartCodeInterpreterSession",
                   "bedrock-agentcore:InvokeCodeInterpreter",
                   "bedrock-agentcore:StopCodeInterpreterSession",
                   "bedrock-agentcore:DeleteCodeInterpreter",
                   "bedrock-agentcore:ListCodeInterpreters",
                   "bedrock-agentcore:GetCodeInterpreter",
                   "bedrock-agentcore:GetCodeInterpreterSession",
                   "bedrock-agentcore:ListCodeInterpreterSessions"
               ],
               "Resource": "arn:aws:bedrock-agentcore:<region>:++<account_id>++:code-interpreter/*"
           }
       ]
   }

Untuk melampirkan kebijakan ini

Ikuti langkah-langkah ini:

1. Buka Konsol IAM.

2. Temukan pengguna atau peran Anda dari respons yang dikembalikan untuk operasi get-caller-identity API.

3. Pilih Tambah izin lalu pilih Buat kebijakan sebaris

4. Beralih ke tampilan JSON dan tempel kebijakan di atas

5. Beri nama AgentCoreCodeInterpreterAccess dan simpan

catatan

Jika Anda menerapkan agen ke Amazon Bedrock AgentCore Runtime, Anda juga harus membuat peran eksekusi IAM dengan kebijakan kepercayaan layanan. Untuk informasi selengkapnya, lihat Memulai dengan AgentCore Runtime.

Bagian berikut menunjukkan cara menggunakan Amazon Bedrock AgentCore Code Interpreter dengan dan tanpa kerangka kerja agen. Menggunakan Code Interpreter secara langsung tanpa kerangka kerja agen sangat berguna ketika Anda ingin mengeksekusi cuplikan kode tertentu secara terprogram.