はじめに

名前と実行ロールを使用してハーネスを作成します。

aws bedrock-agentcore-control create-harness \
  --harness-name "MyHarness" \
  --execution-role-arn "arn:aws:iam::123456789012:role/MyHarnessRole"

get-harness までポーリングします"status": "READY"。レスポンス内の arn を書き留めます。

aws bedrock-agentcore-control get-harness \
  --harness-id "MyHarness-XyZ123"

Python から を呼び出します。モデルを指定しない場合、ハーネスのデフォルトは Amazon Bedrock の Anthropic Claude Sonnet 4.6 です。

import boto3

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

response = client.invoke_harness(
    harnessArn="arn:aws:bedrock-agentcore:us-west-2:123456789012:harness/MyHarness-XyZ123",  # Replace with your harness ARN
    runtimeSessionId="1234abcd-12ab-34cd-56ef-1234567890ab",
    messages=[{
        "role": "user",
        "content": [{"text": "Research three tropical vacation options under $3k."}]
    }],
)

for event in response["stream"]:
    if "contentBlockDelta" in event:
        delta = event["contentBlockDelta"].get("delta", {})
        if "text" in delta:
            print(delta["text"], end="", flush=True)
    elif "runtimeClientError" in event:
        print(f"\nError: {event['runtimeClientError']['message']}")

AgentCore CLI をインストールします。

npm install -g @aws/agentcore

フラグを使用して非インタラクティブにハーネスプロジェクトを作成します。

agentcore create --name myresearchagent --model-provider bedrock

デプロイして呼び出す:

agentcore deploy
agentcore invoke --harness myresearchagent \
  --session-id "$(uuidgen)" \
  "Research three tropical vacation options under $3k, within five hours of NYC."

レスポンスはターミナルにストリーミングされます。呼び出し--session-id間で同じ を再利用して、同じ環境で会話を続行します。

既存のプロジェクトにハーネスを追加するには、 を使用しますagentcore add harness。スタンドアロンの Python 呼び出しスクリプトを生成するには、 を追加します--with-invoke-script。

便利なフラグ:

AgentCore CLI をインストールします。

npm install -g @aws/agentcore

フラグagentcore createなしで を実行して、インタラクティブウィザードを起動します。

agentcore create

確認後、ウィザードはプロジェクトをスキャフォールドします。でデプロイしagentcore deploy、 で を呼び出しますagentcore invoke。

を使用して、いつでもプロジェクトのステータスを確認しますagentcore status。

ローカル環境でハーネスをテストする場合は、開発サーバーを実行できます。

agentcore dev

を実行するとagentcore dev、CLI はまずハーネスリソースを にデプロイし AWS、IAM ロール、ハーネス、およびプロジェクトで設定されたメモリまたは認証情報を作成します。

デプロイが完了すると、ローカルサーバーが開始され、ブラウザでエージェントインスペクターが開き、ハーネスとチャットしたり、トレースを検査したり、プロジェクトリソースを参照したりできます。

ハーネス設定を展開して、現在のセッションのハーネス設定を表示および上書きします。