ハーネスのクイック作成

Amazon Bedrock AgentCoreコンソールから、フォーム操作だけでハーネスを作ります。CLIやCloudFormationは使わず、必要なリソースはコンソールが裏側で自動作成する形になります。

マネジメントコンソールで Amazon Bedrock AgentCore コンソール を開き、左メニューの「構築」からハーネスを選択します。「ハーネス」画面の右上にあるハーネスをクイック作成ボタンをクリックし、表示されたメニューからハーネスをクイック作成を選択します。

「ハーネスを作成」ダイアログが開きます。クイック作成で入力するのはハーネス名だけで、モデル・システムプロンプト・実行ロールなどはコンソールが既定値で裏側から自動設定します。

設定項目 値 設定の基準
ハーネス名 MyHarness ハンズオン用に分かりやすい名前をつける。作成後は変更できないので、この場で確定させる

値を入力したら作成をクリックします。

作成には1〜2分ほどかかります。ハーネス一覧に戻り、MyHarness のステータスが準備完了になっていれば作成完了です。

一覧の MyHarness をクリックすると詳細画面が開き、ARN欄に arn:aws:bedrock-agentcore:ap-northeast-1:<アカウントID>:harness/MyHarness-XXXXXX の形式でハーネスのARNが表示されます。この値は次の章で使うのでメモしておいてください。

1. 出来上がったハーネスの確認

一覧から MyHarness をクリックして詳細画面を開き、まずはどのようなハーネスが作成されたのかを上から順に見ていきます。

1.1 ハーネスの詳細

画面上部のハーネスの詳細パネルには、名前・ステータス・IAMロール・ARN・IDなどが並びます。特に押さえておきたいのは以下です。

  • IAMロール: AmazonBedrockAgentCoreHarnessDefaultServiceRole-XXXX として、コンソールがハーネス用のIAMロールを自動作成する
  • ハーネスARN と ランタイムARN の両方が払い出されている。ハーネスは内部でランタイム上に載っているため、それぞれ別のARNが振られる形になる
  • ステータス が 準備完了 になっていれば、実際に呼び出せる状態

1.2 呼び出しコード

呼び出しコードを表示パネルには、このハーネスが外部のアプリケーションから呼び出される際に使うサンプルコードが表示されます。Python・TypeScript・JavaScript の3言語から選んで確認できます。この章の後半のPythonからの呼び出しセクションで、実際にこのサンプルコードをローカルの Python から動かします。

1.3 エンドポイント

AgentCore におけるエンドポイントは、クライアントがハーネスを呼び出すときの入口で、それぞれが特定のバージョンに紐づけられます。クライアントはエンドポイント名を指定して呼び出すため、ハーネスの設定を更新したときも、エンドポイントに割り当てるバージョンを差し替えるだけで済み、クライアント側のコードを書き換えずにバージョンを切り替えられる作りになっています。

エンドポイントパネルには、クイック作成の時点で DEFAULT エンドポイントが自動作成されています。DEFAULT は常に最新バージョンに追従するエンドポイントです。バージョンを固定して呼び出したい場合や、新しいバージョンを段階的に切り替えたい場合は、別のエンドポイントを作ってそこに特定バージョンを割り当てます。

1.4 バージョン

バージョンパネルには、バージョン 1 が自動で作られています。ハーネスは設定を更新するたびに新しいバージョンのスナップショットが作られ、DEFAULT エンドポイントは常に最新バージョンを指す形になります。ロールバックや過去バージョンとの比較を行うときはこの単位で扱います。

1.5 モデルとシステムプロンプト

モデルとシステムプロンプトパネルには、クイック作成が入れた既定値が並んでいます。

項目 値 意味
プロバイダー Bedrock ハーネスがモデル推論を委譲するサービスを指定する項目。今回は Amazon Bedrock を使う構成になっている
API フォーマット Converse API プロバイダー側で呼び出す API の種類を指定する項目。Converse API は複数モデル横断で統一されたインターフェースを提供する Bedrock の現行推奨 API
モデル global.anthropic.claude-sonnet-4-6 推論を実行する具体的なモデルを指定する項目。global. プレフィックスはクロスリージョン推論プロファイルを表し、リージョン間で負荷を分散する
システムプロンプト You are a helpful assistant. モデルへの基本指示文で、毎回の会話の先頭に自動で付与される。エージェントの人格や応答スタイルの土台になる。既定値の You are a helpful assistant. は「あなたは親切なアシスタントです」という意味で、方向付けをほとんどしない汎用的な指示にとどまっている

このパネルが、後のセクションで「システムプロンプトを書き換えて挙動を変える」ときに設定を変更する対象になります。

1.6 メモリ・ツール・スキル

メモリ・ツール・スキルのパネルはいずれも 0 件です。クイック作成はモデルとシステムプロンプトだけのシンプルな構成で立ち上がり、外部ツール呼び出し・会話履歴保持・スキル追加といった要素は空の状態で用意されます。必要になったら詳細画面から追加していく形になります。

これらのパネルへの追加は、本章の後半と後続の章で段階的に扱います。

1.7 高度な設定

高度な設定パネルには、ハーネスの内部動作にまつわる既定値が並びます。

項目 値 意味
許可されたツール すべてのツール (*) ハーネスが呼び出しを許可するツールのフィルタを指定する項目。* は全ツール許可を意味する(今回はツール0件のため実質的な効果はない)
ネットワーク PUBLIC ハーネスの実行環境が持つネットワーク到達性を指定する項目。PUBLIC はインターネットに出られる状態を意味する
切り詰め戦略 sliding_window(150 メッセージ) 会話履歴が長くなったときの詰め直し方針を指定する項目。sliding_window は直近N件のメッセージだけをモデルに渡す方式で、既定値は 150 メッセージ
呼び出しの制限 最大イテレーション 75 / タイムアウト 1時間 1回の呼び出しでモデル→ツール→モデルのループを回せる上限回数と、全体のタイムアウト時間を指定する項目
ライフサイクル アイドル 15分 / 最大有効期間 8時間 セッションが自動的に切断される条件を指定する項目。何も操作しないと15分でアイドル切断され、連続稼働は最長8時間

会話履歴の切り詰めやセッションタイムアウトなど、実運用で必要になる制御が既定値であらかじめ入っているのが分かります。

1.8 インバウンド認証

インバウンド認証パネルのインバウンド認証タイプは IAM です。ハーネスを呼び出すクライアント(ローカルの Python・Lambda など)は AWS IAM 認証情報を持っている必要があり、この章の後半でローカル Python から呼び出すときも、AWS CLI で設定済みの認証情報を暗黙的に使う形になります。

IAM 以外の認証方式(Cognito などの OAuth 2.0 / OIDC プロバイダとの連携、社内 SSO のトークンをそのままエージェント呼び出しに使う構成など)については、AgentCore Identityでアクセス制御を設計しよう で扱います。

1.9 オブザーバビリティ

オブザーバビリティパネルには、セッション数・呼び出し数・トークン数・エラー率などのメトリクスが並びます。まだ一度も呼び出していないためすべて 0 ですが、後のセクションでプレイグラウンドから何回か会話したあとに戻ってくると、実行回数やトークン数が反映されます。

1.10 ログの配信とトレース

ログの配信とトレースパネルでは、CloudWatch へのログ/トレース配信の有効化を設定できます。既定では未設定で、トレース配信を有効化するには Transaction Search を先に有効化する必要がある旨のメッセージが表示されます。オブザーバビリティを本格的に扱う手順は AgentCore Observabilityでエージェントを可視化しよう で扱うため、この章では未設定のまま先に進みます。

1.11 タグ

タグパネルは空の状態です。運用でコスト集計や環境の切り分けをタグで行う場合はここに追加していきますが、このハンズオンでは何も設定しません。