View a markdown version of this page

Inizia a usare AgentCore Code Interpreter - Amazon Bedrock AgentCore
PrerequisitiConfigurazione delle credenziali

Inizia a usare AgentCore Code Interpreter

AgentCore Code Interpreter consente ai tuoi agenti di eseguire codice Python in un ambiente sicuro e gestito. L'agente può eseguire calcoli, analizzare dati, generare visualizzazioni e convalidare le risposte tramite l'esecuzione di codice.

Questa pagina illustra i prerequisiti e fornisce due approcci per iniziare:

  • Utilizzo di AWS Strands: un framework di agenti di alto livello che semplifica la creazione di agenti AI con integrazione di strumenti integrati, gestione delle conversazioni e gestione automatica delle sessioni.

  • Utilizzo diretto: approcci SDK e Boto3 che forniscono un maggiore controllo sulla gestione delle sessioni e sull'esecuzione del codice per implementazioni personalizzate.

Argomenti

Prerequisiti

Prima di iniziare, assicurati di avere:

Configurazione delle credenziali

Esegui i passaggi seguenti per configurare AWS le tue credenziali e allegare le autorizzazioni richieste.

  1. Verifica le tue credenziali AWS

    Conferma che le tue AWS credenziali siano configurate:

    aws sts get-caller-identity
    Nota

    Prendi nota dell'utente o delle credenziali restituite qui, poiché li utilizzerai per allegare le autorizzazioni richieste.

    Se questo comando fallisce, configura le tue credenziali. Per ulteriori informazioni, consulta Configurazione e impostazioni dei file di credenziali nella AWS CLI.

  2. Allega le autorizzazioni richieste

    Il tuo utente o ruolo IAM necessita delle autorizzazioni per utilizzare AgentCore Code Interpreter. Allega questa policy alla tua identità IAM:

    Nota

    Sostituiscila <region> con la regione prescelta (ad esempious-west-2) e <account_id> con l'ID del tuo AWS account nella politica seguente:

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

Per allegare questa politica

Completare la procedura riportata di seguito.

  1. Vai alla console IAM.

  2. Trova il tuo utente o ruolo nella risposta restituita per l'operazione get-caller-identity API.

  3. Scegli Aggiungi autorizzazioni, quindi scegli Crea politica in linea

  4. Passa alla visualizzazione JSON e incolla la politica sopra riportata

  5. Assegna un nome AgentCoreCodeInterpreterAccess e salva

Nota

Se stai distribuendo agenti su Amazon Bedrock AgentCore Runtime, dovrai anche creare un ruolo di esecuzione IAM con una policy di fiducia del servizio. Per ulteriori informazioni, consulta Get started with AgentCore Runtime.

Le seguenti sezioni mostrano come utilizzare Amazon Bedrock AgentCore Code Interpreter con e senza il framework dell'agente. L'uso diretto di Code Interpreter senza un framework di agenti è particolarmente utile quando desideri eseguire frammenti di codice specifici a livello di codice a livello di codice.