View a markdown version of this page

Comience con AgentCore Code Interpreter - Amazon Bedrock AgentCore
Requisitos previosConfiguración de las credenciales

Comience con AgentCore Code Interpreter

AgentCore El intérprete de código permite a sus agentes ejecutar código Python en un entorno gestionado y seguro. El agente puede realizar cálculos, analizar datos, generar visualizaciones y validar las respuestas mediante la ejecución del 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 IA 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 de SDK y Boto3 que proporcionan un mayor control sobre la gestión de las sesiones y la ejecución del código para implementaciones personalizadas.

Temas

Requisitos previos

Antes de empezar, asegúrate de tener:

  • AWS cuenta con credenciales configuradas. Consulte Configurar sus 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 Configuración de las credenciales.

  • Acceso al modelo: Anthropic Claude Sonnet 4.0 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. Verifica tus 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 los usarás al adjuntar los permisos necesarios.

    Si se produce un error con este comando, 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. Adjunta esta política a tu identidad de IAM:

    nota

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

    {
    "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. Busque su usuario o rol en la respuesta devuelta para la operación de la get-caller-identity API.

  3. Selecciona Añadir permisos y, a continuación, selecciona Crear política en línea

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

  5. Ponle un nombre AgentCoreCodeInterpreterAccess y guárdalo

nota

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

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