View a markdown version of this page

Gestione delle risorse e delle sessioni - Fondamento Amazon AgentCore
autorizzazioni IAMCome funzionaCreazione di un interprete di codice e avvio di una sessione

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à.

Gestione delle risorse e delle sessioni

I seguenti argomenti mostrano come funziona Amazon Bedrock AgentCore Code Interpreter e come creare le risorse e gestire le sessioni.

Argomenti

autorizzazioni IAM

La seguente politica IAM fornisce le autorizzazioni necessarie per l'utilizzo del Code Interpreter: AgentCore 

{
"Version":"2012-10-17",
    "Statement": [
        {
            "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:us-east-1:111122223333:code-interpreter/*"
        }
    ]
}

È inoltre necessario aggiungere la seguente politica di fiducia al ruolo di esecuzione:

{
"Version":"2012-10-17",
    "Statement": [{
        "Sid": "BedrockAgentCoreBuiltInTools",
        "Effect": "Allow",
        "Principal": {
            "Service": "bedrock-agentcore.amazonaws.com"
        },
        "Action": "sts:AssumeRole",
        "Condition": {
            "StringEquals": {
                "aws:SourceAccount": "111122223333"
            },
            "ArnLike": {
                "aws:SourceArn": "arn:aws:bedrock-agentcore:us-east-1:111122223333:*"
            }
        }
    }]
}

Come funziona

  1. Crea un interprete di codice

    Crea il tuo interprete di codice o usa il System Code Interpreter per abilitare funzionalità come la scrittura e l'esecuzione di codice o l'esecuzione di calcoli complessi. Il Code Interpreter consente di aumentare il runtime dell'agente per eseguire il codice in modo sicuro in un ambiente completamente gestito con bassa latenza.

  2. Integratelo all'interno di un agente da richiamare

    Copia l'ID della risorsa dello strumento integrato nel codice del tuo agente di runtime per richiamarlo come parte della sessione. Per gli strumenti Code Interpreter, puoi eseguire codice e visualizzare i risultati in tempo reale.

  3. Valuta le prestazioni utilizzando l'osservabilità

    Monitora le metriche chiave per ogni strumento per CloudWatch ottenere informazioni sulle prestazioni in tempo reale.

Creazione di un interprete di codice e avvio di una sessione

  1. Creazione di un interprete di codice

    Quando si configura un interprete di codice, è possibile scegliere le impostazioni di rete (Sandbox o Public) e il ruolo di esecuzione che definisce a quali AWS risorse può accedere l'interprete del codice.

  2. Avviare una sessione

    Il Code Interpreter utilizza un modello basato sulla sessione. Dopo aver creato un Code Interpreter, si avvia una sessione con un periodo di timeout configurabile (il valore predefinito è 15 minuti). Le sessioni terminano automaticamente dopo il periodo di timeout. È possibile attivare più sessioni contemporaneamente per un singolo interprete di codice, ognuna delle quali mantiene il proprio stato e il proprio ambiente.

  3. Esegui codice

    All'interno di una sessione attiva, puoi eseguire codice nei linguaggi supportati (Python, JavaScript, TypeScript) e mantenere lo stato tra le esecuzioni. È inoltre possibile eseguire upload/download operazioni sui file e utilizzare il supporto fornito per i comandi della shell e i comandi AWS CLI.

  4. Interrompi la sessione e pulisci

    Quando hai finito di usare una sessione, dovresti interromperla per liberare risorse ed evitare costi non necessari. Puoi anche eliminare il Code Interpreter se non intendi più utilizzarlo.