View a markdown version of this page

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

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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 degli 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 le 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 sono configurate:

    aws sts get-caller-identity
    Nota

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

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

  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 policy in linea

  4. Passa alla visualizzazione JSON e incolla la policy 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 sezioni seguenti mostrano come utilizzare Amazon Bedrock AgentCore Code Interpreter con e senza il framework degli agenti. L'uso diretto del Code Interpreter senza un framework di agenti è particolarmente utile quando si desidera eseguire frammenti di codice specifici a livello di codice.