View a markdown version of this page

Memulai dengan AgentCore Code Interpreter - Batuan Dasar Amazon AgentCore
PrasyaratMengonfigurasi kredensial Anda

Memulai dengan AgentCore Code Interpreter

AgentCore Code Interpreter memungkinkan agen Anda 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 membangun 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

Sebelum Anda mulai, pastikan Anda memiliki:

Mengonfigurasi kredensial Anda

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

  1. Verifikasi AWS kredensi Anda

    Konfirmasikan AWS kredenal Anda dikonfigurasi:

    aws sts get-caller-identity
    catatan

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

    Jika perintah ini gagal, konfigurasikan kredensialmu. Untuk informasi selengkapnya, lihat Pengaturan konfigurasi dan file kredensi 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 ditampilkan untuk operasi get-caller-identity API.

  3. Pilih Tambahkan 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 AgentCore Runtime.

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