View a markdown version of this page

Gestione delle risorse e delle sessioni - Amazon Bedrock AgentCore

Gestione delle risorse e delle sessioni

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

autorizzazioni IAM

La seguente policy IAM fornisce le autorizzazioni necessarie per l'utilizzo di 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 l'interprete di codice di sistema 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 runtime agent 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. Creare un interprete di codice

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

  2. Avviare una sessione

    Il Code Interpreter utilizza un modello basato sulla sessione. Dopo aver creato un interprete di codice, si avvia una sessione con un periodo di timeout configurabile (l'impostazione predefinita è 15 minuti). Le sessioni terminano automaticamente dopo il periodo di timeout. È possibile attivare più sessioni contemporaneamente per un singolo interprete di codice, con ogni sessione che mantiene il proprio stato e 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 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 addebiti inutili. Puoi anche eliminare il Code Interpreter se non intendi più utilizzarlo.