View a markdown version of this page

リソースとセッションの管理 - Amazon Bedrock AgentCore
IAM アクセス許可仕組みCode Interpreter の作成とセッションの開始

リソースとセッションの管理

以下のトピックでは、Amazon Bedrock AgentCore Code Interpreter の仕組みと、リソースの作成とセッションの管理方法について説明します。

トピック

IAM アクセス許可

次の IAM ポリシーは、AgentCore Code Interpreter を使用するために必要なアクセス許可を提供します。

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

また、次の信頼ポリシーを実行ロールに追加する必要があります。

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

仕組み

  1. コードインタープリタを作成する

    独自のコードインタープリタを構築するか、システムコードインタープリタを使用して、コードの記述と実行、複雑な計算の実行などの機能を有効にします。Code Interpreter を使用すると、エージェントのランタイムを拡張して、低レイテンシーでフルマネージド環境でコードを安全に実行できます。

  2. エージェント内で統合して呼び出す

    組み込みツールリソース ID をランタイムエージェントコードにコピーして、セッションの一部として呼び出します。Code Interpreter ツールでは、コードを実行し、結果をリアルタイムで表示できます。

  3. オブザーバビリティを使用してパフォーマンスを評価する

    CloudWatch の各ツールの主要なメトリクスをモニタリングして、リアルタイムのパフォーマンスインサイトを取得します。

Code Interpreter の作成とセッションの開始

  1. コードインタープリタを作成する

    Code Interpreter を設定するときは、ネットワーク設定 (サンドボックスまたはパブリック) と、Code Interpreter がアクセスできる AWS リソースを定義する実行ロールを選択できます。

  2. セッションの開始

    Code Interpreter はセッションベースのモデルを使用します。Code Interpreter を作成したら、設定可能なタイムアウト期間 (デフォルトは 15 分) でセッションを開始します。セッションはタイムアウト期間後に自動的に終了します。1 つの Code Interpreter に対して複数のセッションを同時にアクティブにでき、各セッションは独自の状態と環境を維持します。

  3. コードの実行

    アクティブなセッション内では、サポートされている言語 (Python、JavaScript、TypeScript) でコードを実行し、実行間の状態を維持できます。ファイルのアップロード/ダウンロードオペレーションを実行し、シェルコマンドと AWS CLI コマンドで提供されるサポートを使用することもできます。

  4. セッションを停止してクリーンアップする

    セッションの使用が終了したら、セッションを停止してリソースを解放し、不要な料金を回避する必要があります。今後使用する予定がない場合は、Code Interpreter を削除することもできます。