Menggunakan AgentCore Code Interpreter secara langsung

Bagian berikut menunjukkan cara menggunakan Amazon Bedrock AgentCore Code Interpreter secara langsung tanpa kerangka kerja agen. Ini sangat berguna ketika Anda ingin mengeksekusi cuplikan kode tertentu secara terprogram. Sebelum Anda membaca contoh di bagian ini, lihat Pras yarat.

Langkah 1: Pilih pendekatan Anda dan instal dependensi

Amazon Bedrock AgentCore menyediakan dua cara untuk berinteraksi dengan AgentCore Code Interpreter: menggunakan klien SDK tingkat tinggi atau menggunakan boto3 secara langsung.

• Klien SDK: bedrock_agentcore SDK menyediakan antarmuka yang disederhanakan yang menangani detail manajemen sesi. Gunakan pendekatan ini untuk sebagian besar aplikasi.

• Klien Boto3: AWS SDK memberi Anda akses langsung ke operasi AgentCore Code Interpreter API. Gunakan pendekatan ini ketika Anda memerlukan kontrol halus atas konfigurasi sesi atau ingin mengintegrasikan dengan aplikasi berbasis boto3 yang ada.

Buat folder proyek (jika Anda tidak membuatnya sebelumnya) dan instal paket yang diperlukan:

mkdir agentcore-tools-quickstart
cd agentcore-tools-quickstart
python3 -m venv .venv
source .venv/bin/activate

Di Windows, gunakan: .venv\Scripts\activate

Instal paket yang diperlukan:

pip install bedrock-agentcore boto3

Paket-paket ini menyediakan:

• bedrock-agentcore: SDK untuk AgentCore alat Amazon Bedrock termasuk AgentCore Code Interpreter

• boto3: AWS SDK untuk Python (Boto3) untuk membuat, mengkonfigurasi, dan mengelola layanan AWS

Langkah 2: Jalankan kode

Pilih salah satu pendekatan berikut untuk mengeksekusi kode dengan AgentCore Code Interpreter:

catatan

Ganti <Region> dengan Wil AWS ayah Anda yang sebenarnya (misalnya, us-east-1 atauus-west-2).

contoh

SDK Client

1. Buat file bernama direct_code_execution_sdk.py dan tambahkan kode berikut:

   from bedrock_agentcore.tools.code_interpreter_client import CodeInterpreter
   import json
   
   # Initialize the Code Interpreter client for your region
   code_client = CodeInterpreter('<Region>')
   
   # Start a Code Interpreter session
   code_client.start()
   
   try:
       # Execute Python code
       response = code_client.invoke("executeCode", {
           "language": "python",
           "code": 'print("Hello World!!!")'
       })
   
       # Process and print the response
       for event in response["stream"]:
           print(json.dumps(event["result"], indent=2))
   
   finally:
       # Always clean up the session
       code_client.stop()

   Kode ini:

   • Membuat klien AgentCore Code Interpreter untuk wilayah Anda

   • Memulai sesi (diperlukan sebelum mengeksekusi kode)

   • Mengeksekusi kode Python dan mengalirkan hasilnya dengan detail acara lengkap

   • Menghentikan sesi untuk membersihkan sumber daya

     Jalankan skrip

     Jalankan perintah berikut:

     python direct_code_execution_sdk.py

     Output yang diharapkan

     Anda akan melihat respons JSON yang berisi hasil eksekusi Hello World!!! dengan konten keluaran.

Boto3

1. Buat file bernama direct_code_execution_boto3.py dan tambahkan kode berikut:

   import boto3
   import json
   
   # Code to execute
   code_to_execute = """
   print("Hello World!!!")
   """
   
   # Initialize the bedrock-agentcore client
   client = boto3.client(
       "bedrock-agentcore",
       region_name="<Region>"
   )
   
   # Start a Code Interpreter session
   session_response = client.start_code_interpreter_session(
       codeInterpreterIdentifier="aws.codeinterpreter.v1",
       name="my-code-session",
       sessionTimeoutSeconds=900
   )
   session_id = session_response["sessionId"]
   
   print(f"Started session: {session_id}\n\n")
   
   try:
       # Execute code in the session
       execute_response = client.invoke_code_interpreter(
           codeInterpreterIdentifier="aws.codeinterpreter.v1",
           sessionId=session_id,
           name="executeCode",
           arguments={
               "language": "python",
               "code": code_to_execute
           }
       )
   
       # Extract and print the text output from the stream
       for event in execute_response['stream']:
           if 'result' in event:
               result = event['result']
               if 'content' in result:
                   for content_item in result['content']:
                       if content_item['type'] == 'text':
                           print(content_item['text'])
   
   finally:
       # Stop the session when done
       client.stop_code_interpreter_session(
           codeInterpreterIdentifier="aws.codeinterpreter.v1",
           sessionId=session_id
       )
       print(f"\n\nStopped session: {session_id}")

   Kode ini:

   • Membuat klien boto3 untuk layanan bedrock-agentcore

   • Memulai sesi AgentCore Code Interpreter dengan batas waktu 900 detik

   • Mengeksekusi kode Python menggunakan ID sesi

   • Mengurai respons streaming untuk mengekstrak output teks

   • Menghentikan sesi dengan benar untuk melepaskan sumber daya

     Pendekatan boto3 membutuhkan manajemen sesi eksplisit. Anda harus menelepon start_code_interpreter_session sebelum mengeksekusi kode dan setelah stop_code_interpreter_session selesai.

     Jalankan skrip

     Jalankan perintah berikut:

     python direct_code_execution_boto3.py

     Output yang diharapkan

     Anda akan melihat Hello World!!! dicetak sebagai hasil eksekusi kode, bersama dengan informasi ID sesi.