Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Uso directo AgentCore de Code Interpreter
<a name="code-interpreter-using-directly"></a>

En las siguientes secciones se muestra cómo utilizar el intérprete de AgentCore código de Amazon Bedrock directamente sin un marco de agente. Esto es especialmente útil cuando desea ejecutar fragmentos de código específicos mediante programación. Antes de revisar los ejemplos de esta sección, consulte Requisitos previos. [Requisitos previos](code-interpreter-getting-started.md#code-interpreter-prerequisites)

**Topics**
+ [Paso 1: Elija su enfoque e instale las dependencias](#code-interpreter-direct-install)
+ [Paso 2: Ejecute el código](#code-interpreter-direct-execute)

## Paso 1: Elija su enfoque e instale las dependencias
<a name="code-interpreter-direct-install"></a>

Amazon Bedrock AgentCore ofrece dos formas de interactuar con AgentCore Code Interpreter: mediante el cliente de SDK de alto nivel o mediante boto3 directamente.
+  **Cliente SDK**: el `bedrock_agentcore` SDK proporciona una interfaz simplificada que gestiona los detalles de administración de las sesiones. Utilice este enfoque para la mayoría de las aplicaciones.
+  **Cliente Boto3**: el AWS SDK le brinda acceso directo a las operaciones de la API del intérprete AgentCore de código. Utilice este enfoque cuando necesite un control detallado sobre la configuración de la sesión o quiera integrarse con las aplicaciones existentes basadas en boto3.

Crea una carpeta de proyecto (si no la creaste antes) e instala los paquetes necesarios:

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

En Windows, usa: `.venv\Scripts\activate` 

Instale los paquetes obligatorios:

```
pip install bedrock-agentcore boto3
```

Estos paquetes proporcionan:
+  `bedrock-agentcore`: El SDK para las AgentCore herramientas de Amazon Bedrock, incluido AgentCore Code Interpreter
+  `boto3`: AWS SDK para Python (Boto3) para crear, configurar y administrar servicios AWS 

## Paso 2: Ejecute el código
<a name="code-interpreter-direct-execute"></a>

Elija uno de los siguientes enfoques para ejecutar AgentCore código con Code Interpreter:

**nota**  
`<Region>`Sustitúyalo por su AWS región actual (por ejemplo, `us-east-1` o`us-west-2`).

**Example**  

1. Crea un archivo con el nombre `direct_code_execution_sdk.py` y agrega el siguiente código:

   ```
   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()
   ```

   Este código:
   + Crea un cliente AgentCore de interpretación de código para su región
   + Inicia una sesión (necesaria antes de ejecutar el código)
   + Ejecuta el código Python y transmite los resultados con todos los detalles del evento
   + Detiene la sesión para limpiar los recursos

      **Ejecuta el script ** 

     Ejecute el siguiente comando :

     ```
     python direct_code_execution_sdk.py
     ```

      **Salida esperada ** 

     Deberías ver una respuesta de JSON que contenga el resultado de la ejecución junto con `Hello World!!!` el contenido de salida.

1. Crea un archivo con el nombre `direct_code_execution_boto3.py` y agrega el siguiente código:

   ```
   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}")
   ```

   Este código:
   + Crea un cliente boto3 para el servicio bedrock-agentcore
   + Inicia una sesión de intérprete de código con un tiempo de espera de 900 segundos AgentCore 
   + Ejecuta el código de Python con el ID de sesión
   + Analiza la respuesta de transmisión para extraer el texto de salida
   + Detiene correctamente la sesión para liberar recursos

     El enfoque boto3 requiere una administración explícita de las sesiones. Debe llamar `start_code_interpreter_session` antes de ejecutar el código y `stop_code_interpreter_session` cuando haya terminado.

      **Ejecute el script ** 

     Ejecute el siguiente comando :

     ```
     python direct_code_execution_boto3.py
     ```

      **Salida esperada ** 

     Aparecerá `Hello World!!!` impreso el resultado de la ejecución del código, junto con la información del identificador de la sesión.