Comience con AgentCore Code Interpreter

AgentCore Code Interpreter permite a sus agentes ejecutar código Python en un entorno seguro y gestionado. El agente puede realizar cálculos, analizar datos, generar visualizaciones y validar las respuestas mediante la ejecución de código.

En esta página se describen los requisitos previos y se proporcionan dos enfoques para empezar:

• Uso de AWS Strands: un marco de agentes de alto nivel que simplifica la creación de agentes de inteligencia artificial con la integración de herramientas integradas, la gestión de las conversaciones y la gestión automática de las sesiones.

• Uso directo: enfoques basados en el SDK y Boto3 que proporcionan un mayor control sobre la gestión de las sesiones y la ejecución del código para las implementaciones personalizadas.

Temas

• Requisitos previos

• Configuración de las credenciales

• Uso AgentCore del intérprete de código mediante AWS Hebras

• Uso directo AgentCore de Code Interpreter

Requisitos previos

Antes de empezar, asegúrese de tener:

• AWS cuenta con credenciales configuradas. Consulte Configurar las credenciales.

• Python 3.10+ instalado

• Boto3 instalado. Consulte la documentación de Boto3.

• Función de ejecución de IAM con los permisos necesarios. Consulte Configurar las credenciales.

• Acceso modelo: el Anthropic Claude Sonnet 4.0 está habilitado en la consola Amazon Bedrock. Para obtener información sobre el uso de un modelo diferente con los agentes de Strands, consulte la sección de proveedores de modelos de la documentación del SDK de Strands Agents.

• AWS Región en la que Amazon Bedrock AgentCore está disponible. Consulte las AWS regiones compatibles.

Configuración de las credenciales

Realice los siguientes pasos para configurar sus AWS credenciales y adjuntar los permisos necesarios.

1. Verifique sus AWS credenciales

   Confirme que sus AWS credenciales estén configuradas:

   aws sts get-caller-identity

   nota

   Toma nota del usuario o las credenciales que aparecen aquí, ya que las utilizarás para adjuntar los permisos necesarios.

   Si este comando falla, configure sus credenciales. Para obtener más información, consulte Configuración y configuración del archivo de credenciales en la AWS CLI.

2. Adjunte los permisos necesarios

   Su usuario o rol de IAM necesita permisos para usar AgentCore Code Interpreter. Adjunte esta política a su identidad de IAM:

   nota

   <region>Sustitúyala por la región que hayas elegido (por ejemplous-west-2) y <account_id> por la ID de tu AWS cuenta en la política que aparece a continuación:

   {
       "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/*"
           }
       ]
   }

Para adjuntar esta política

Siga estos pasos:

1. Vaya a la consola de IAM.

2. Busca tu usuario o rol en la respuesta devuelta por la operación de la get-caller-identity API.

3. Elige Agregar permisos y, a continuación, elige Crear política integrada

4. Cambia a la vista JSON y pega la política de arriba

5. Ponle un nombre AgentCoreCodeInterpreterAccess y guárdala

nota

Si va a implementar agentes en Amazon Bedrock AgentCore Runtime, también tendrá que crear un rol de ejecución de IAM con una política de confianza en el servicio. Para obtener más información, consulte Introducción a Runtime. AgentCore

En las siguientes secciones se muestra cómo utilizar el intérprete de AgentCore código de Amazon Bedrock con y sin el marco del agente. El uso del intérprete de código directamente sin un marco de agente es especialmente útil cuando desea ejecutar fragmentos de código específicos mediante programación.