コンテキストセットは、エージェントがワークスペース全体を手探りで検索する代わりに最初に読み込む、承認済みコンテキストのガバナンス付きバンドルです。
コンテキストセット
コンテキストセット（/platform/context-graph?view=library&set=<id>）は、エージェントがワークスペース全体を手探りで検索する代わりに起点とする、ガバナンス付きの承認済みコンテキストバンドルです。
コンテキストセットの構成
各コンテキストセットは次の 3 つの要素を定義します。
- セットの概要: 一意の名前（最大 120 文字）と、エージェントがタスクに適したセットを選ぶために読む目的（最大 2,000 文字）。
- スコープ: 選択したコレクション（最大 8 個）または選択した文書（最大 20 件）。このセットを使うエージェントはこのスコープ内のみを読み取り、文書権限をバイパスすることはありません。
- メンバー:
- 承認済みライブラリ項目（最大 100 件）: ビジネス用語、検証済みの回答、指示、および承認済みクエリテンプレート。それぞれライブラリが提供するバージョンに固定されます。セットのスコープ外の文書を引用している項目は追加できません（後のライブラリ更新でスコープ外の文書を引用した場合は
outOfScopeとして除外されます）。 - ルールテンプレート（最大 20 件）: セットのエージェントが実行できる検証済みテンポラルグラフルールテンプレート。
- 必須文書と必須エンティティ（各最大 20 件）: セットから構築されるすべてのコンテキストパックで、承認済み項目の次に優先される項目。
- 承認済みライブラリ項目（最大 100 件）: ビジネス用語、検証済みの回答、指示、および承認済みクエリテンプレート。それぞれライブラリが提供するバージョンに固定されます。セットのスコープ外の文書を引用している項目は追加できません（後のライブラリ更新でスコープ外の文書を引用した場合は
ライフサイクル、アクセス、バージョン
セットの状態は下書き（draft）、有効（active）、またはアーカイブ済み（archived）です。エージェントに提供されるのは有効なセットのみです（それ以外は AGENT_CONTEXT_SET_INACTIVE）。
| アクセスレベル | 対象 | できること |
|---|---|---|
| スチュワード（Steward） | ワークスペースの owner/admin、または library:edit を持つメンバー | 変更の直接適用、編集者の提案の承認・却下、理由付きのロールバック、有効化、アーカイブ、下書きとしての復元、評価データセットの紐づけ、アクセス管理 |
| 編集者（Editor） | library:edit を持つメンバー | 変更の提案、エージェントが受け取る内容のプレビュー実行、影響測定 / 変更のチェックの実行 |
| 閲覧者（Reader） | メンバー、ワークスペースロール、またはエージェント認証情報（認証情報の追加には agent_credential:manage が必要） | セットの閲覧、パックのプレビュー、セットからのエージェントコンテキストパック構築 |
すべての変更は不変のバージョン（context_set_versions）を追加します。ビジネスコンテキストライブラリでメンバー項目が承認、ロールバック、廃止、または提供停止されると、Bundata は新しい提供バージョンに再固定するシステムの member_updated セットバージョンを自動的に記録します。
プレビューと影響測定
- エージェントが受け取る内容のプレビュー（
POST /api/w/:wsId/context-sets/:setId/preview）: タスクを入力すると、そのセットを読むエージェントが受け取るパックと、パート別（verified_answers、definitions、instructions、required_evidence、evidence）のトークン内訳を確認できます。 - 影響測定と変更のチェック: スチュワードは評価スタジオの RAG/検索データセットをセットに紐づけられます（
PUT /api/w/:wsId/eval/change-checks/sets/:setId/attachment）。影響測定はワークスペースエージェントのtools_onlyとcontext_set_firstを比較します。変更のチェックは現在のバージョンと提案バージョンを比較し、精度低下（回帰）が検出された提案を承認するにはoverrideReasonが必要です（409 REGRESSION_OVERRIDE_REQUIRED）。
エージェント認証情報のバインド
設定 → エージェントアクセス で、管理者は認証情報を最大 10 個のセットにバインドできます（PUT /api/w/:wsId/agent-credentials/:id/context-sets）。
- バインドされた認証情報は、有効なバインド先セットの内部（そのスコープ、承認済み項目、クエリテンプレート、ルールテンプレート）のみを読み取ります。ワークスペース全体のテンポラルグラフツール（
query_as_of、get_entity_history、compare_times、get_value_series、get_activity_series）は非表示となり拒否されます（AGENT_CONTEXT_SET_TOOL_REFUSED）。 - バインドされていない認証情報は、従来どおり読み取り可能なコレクション全体で動作しつつ、スチュワードから閲覧者権限を付与されたセットを検索して利用することもできます。