CLI または SDK AWS を使用してインスタンスの使用を開始する

aws bedrock-agentcore-control create-capacity-provider \
  --name "my_capacity_provider" \
  --permissions-configuration '{
    "capacityProviderOperatorRoleArn": "arn:aws:iam::111122223333:role/AgentCoreCapacityProviderOperatorRole"
  }' \
  --compute-configuration '{
    "ec2Configuration": {
      "launchTemplateSource": {
        "launchParameters": {
          "operatingSystem": "LINUX_X86_64",
          "instanceRequirements": {
            "allowedInstanceTypes": ["m5.large"]
          }
        }
      },
      "vpcConfiguration": {
        "subnets": ["subnet-0123456789abcdef0"],
        "securityGroups": ["sg-0123456789abcdef0"]
      },
      "lifecycleConfiguration": {
        "maxLifetime": 3600
      },
      "volumes": [
        { "ebsConfiguration": { "name": "scratch", "sizeGiB": 50, "volumeType": "gp3" } }
      ]
    }
  }'

boto3 を使用してキャパシティープロバイダーを作成する Python の例。

import boto3

client = boto3.client("bedrock-agentcore-control", region_name="us-west-2")

response = client.create_capacity_provider(
    name="my_capacity_provider",
    permissionsConfiguration={
        "capacityProviderOperatorRoleArn": "arn:aws:iam::111122223333:role/AgentCoreCapacityProviderOperatorRole"
    },
    computeConfiguration={
        "ec2Configuration": {
            "launchTemplateSource": {
                "launchParameters": {
                    "operatingSystem": "LINUX_X86_64",
                    "instanceRequirements": {
                        "allowedInstanceTypes": ["m5.large"],
                    },
                }
            },
            "vpcConfiguration": {
                "subnets": ["subnet-0123456789abcdef0"],
                "securityGroups": ["sg-0123456789abcdef0"],
            },
            "lifecycleConfiguration": {
                "maxLifetime": 3600,
            },
            "volumes": [
                {"ebsConfiguration": {"name": "scratch", "sizeGiB": 50, "volumeType": "gp3"}}
            ],
        }
    },
)

print(f"Capacity provider ARN: {response['capacityProviderArn']}")

aws bedrock-agentcore-control create-agent-runtime \
  --agent-runtime-name "my_instances_agent" \
  --role-arn "arn:aws:iam::111122223333:role/AgentRuntimeRole" \
  --agent-runtime-artifact '{
    "containerConfiguration": {
      "containerUri": "111122223333.dkr.ecr.us-west-2.amazonaws.com/my-agent:latest"
    }
  }' \
  --capacity-provider-configuration '{
    "capacityProviderArn": "arn:aws:bedrock-agentcore:us-west-2:111122223333:capacity-provider/my_capacity_provider-a1b2c3d4e5"
  }' \
  --lifecycle-configuration '{
    "idleRuntimeSessionTimeout": 300,
    "maxLifetime": 1800
  }' \
  --filesystem-configurations '[
    {
      "capacityProviderVolume": { "volumeName": "scratch", "mountPath": "/mnt/scratch" }
    }
  ]'

boto3 を使用してインスタンスにエージェントランタイムを作成する Python の例。

import boto3

client = boto3.client("bedrock-agentcore-control", region_name="us-west-2")

response = client.create_agent_runtime(
    agentRuntimeName="my_instances_agent",
    roleArn="arn:aws:iam::111122223333:role/AgentRuntimeRole",
    agentRuntimeArtifact={
        "containerConfiguration": {
            "containerUri": "111122223333.dkr.ecr.us-west-2.amazonaws.com/my-agent:latest"
        }
    },
    capacityProviderConfiguration={
        "capacityProviderArn": "arn:aws:bedrock-agentcore:us-west-2:111122223333:capacity-provider/my_capacity_provider-a1b2c3d4e5",
    },
    lifecycleConfiguration={
        "idleRuntimeSessionTimeout": 300,
        "maxLifetime": 1800,
    },
    filesystemConfigurations=[
        {
            "capacityProviderVolume": {"volumeName": "scratch", "mountPath": "/mnt/scratch"}
        }
    ],
)

print(f"Agent runtime ARN: {response['agentRuntimeArn']}")

echo '{"prompt": "Analyze the sales data and summarize the key trends."}' > payload.json

aws bedrock-agentcore invoke-agent-runtime \
  --agent-runtime-arn "arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/my_instances_agent-suffix" \
  --runtime-session-id "project-xyz-0000000000000000000000000000" \
  --qualifier "DEFAULT" \
  --payload fileb://payload.json \
  response.json

payload パラメータはバイナリ BLOB であり、CLI AWS は BLOB がデフォルトで base64 でエンコードされることを想定しています。などの raw JSON をインラインで渡すと--payload '{"prompt": "…​"}'、リクエストがサービスに到達する前にクライアント側でInvalid base64エラーが発生して失敗します。ここで使用するfileb://フォームは、cli_binary_format設定に関係なくファイルをバイナリとして読み取るため、エンコードステップを回避します。

aws bedrock-agentcore stop-runtime-session \
  --agent-runtime-arn "arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/my_instances_agent-suffix" \
  --runtime-session-id "project-xyz-0000000000000000000000000000"

boto3 を使用してランタイムセッションを停止する Python の例。

import boto3

client = boto3.client("bedrock-agentcore", region_name="us-west-2")

client.stop_runtime_session(
    agentRuntimeArn="arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/my_instances_agent-suffix",
    runtimeSessionId="project-xyz-0000000000000000000000000000",
)

aws bedrock-agentcore delete-capacity-provider-session \
  --capacity-provider-id "my_capacity_provider-a1b2c3d4e5" \
  --session-id "project-xyz-0000000000000000000000000000"

boto3 を使用してキャパシティープロバイダーセッションを削除する Python の例。

import boto3

client = boto3.client("bedrock-agentcore", region_name="us-west-2")

response = client.delete_capacity_provider_session(
    capacityProviderId="my_capacity_provider-a1b2c3d4e5",
    sessionId="project-xyz-0000000000000000000000000000",
)

print("Session status:", response["status"])

aws bedrock-agentcore-control delete-capacity-provider \
  --capacity-provider-id "my_capacity_provider-a1b2c3d4e5"

boto3 を使用してキャパシティープロバイダーを削除する Python の例。

import boto3

client = boto3.client("bedrock-agentcore-control", region_name="us-west-2")

client.delete_capacity_provider(
    capacityProviderId="my_capacity_provider-a1b2c3d4e5",
)