エージェントコンテキスト

AIエージェントが自動で読み込むコンテキストをノートブックとして整備できます。チャットでの利用は AIエージェント を参照してください。

エージェントコンテキストはアクセス権限を変える機能ではありません。参照できる情報と実行できる操作は、利用するユーザーと AIプロファイル の権限範囲に制限されます。

エージェントコンテキストフォルダ

個人フォルダまたはチームスペースのルート直下に、名前が .agent のフォルダを作成します。左サイドバーのフォルダメニューから 新規エージェントコンテキストフォルダ を選べます。

配置	自動読み込み
個人フォルダ直下の .agent	オンのとき常に読み込みます（設定 の 個人）
チームスペース直下の .agent	そのチームスペースのノートブックを開いているときに読み込みます（設定 の チームスペース）
ワークスペース直下の .agent	自動読み込みされません。AIプロファイル のコンテキストに指定した場合のみ読み込みます
上記以外にある .agent	自動読み込みされません

個人フォルダ直下・チームスペース直下の .agent では、サブフォルダを含むすべてのノートブックが読み込み対象です。ノートブックには文章のほか、SQLブロックも含まれます。

エージェントコンテキストページ

ノートブック内に名前が .agent のページを置くと、そのノートブックを開いているときに内容が読み込まれます（設定 の ノートブック内ページ）。SQLブロックなどを置き、指標の算出方法などを渡せます。

ノートブック固有の前提には .agent ページを、個人またはチーム共通の情報には .agent フォルダを使います。

AIプロファイルのコンテキスト

セッションで選んだ AIプロファイル に紐づくノートブック・フォルダ・プレーンテキストもコンテキストになります。フォルダを指定した場合、サブフォルダ内のノートブックも対象です。

コンテキストのノートブックまたはフォルダを参照するには、利用するユーザーに対象の閲覧権限が必要です。参照できないノートブックが含まれる AIプロファイルは利用できません。

自動読み込みの設定

チャット入力欄の 設定 にある エージェントコンテキストの自動読み込み セクションで、種類ごとにオン / オフを切り替えられます。

項目	既定	対象
個人	オン	個人フォルダ直下の .agent
チームスペース	オン	現在のノートブックが所属するチームスペース直下の .agent
ノートブック内ページ	オン	現在のノートブック内の .agent ページ

AIプロファイルに設定したコンテキストは、このスイッチの対象外です。選択中の AIプロファイルの設定として常に読み込まれます。

チャット入力欄の コンテキスト使用量 から、現在自動読み込みの対象になっているノートブックやページを確認できます。

常時読み込みと必要時の参照

常時読み込む情報と、必要なときだけ参照する情報は、ノートブックの配置と AIプロファイルへの紐付けで分けます。

読み込み方	設定	動作
個人のコンテキストを常時読み込む	個人フォルダ直下の .agent にノートブックを置き、個人 をオンにする	AIエージェント実行時に、フォルダとサブフォルダ内のすべてのノートブックを読み込みます
チームスペースのコンテキストを読み込む	チームスペース直下の .agent にノートブックを置き、チームスペース をオンにする	そのチームスペースのノートブックを開いているときに読み込みます
ノートブック固有のコンテキストを読み込む	ノートブックに .agent ページを作り、ノートブック内ページ をオンにする	そのノートブックを開いているときに .agent ページを読み込みます
AIプロファイルで常時読み込む	AIプロファイルのプレーンテキスト・コンテキストノートブック・コンテキストフォルダに設定する	その AIプロファイルを使うたびに読み込みます
必要な場合だけ参照する	.agent 側には索引用のノートブックだけを置き、詳細は通常のフォルダに置いてページリンクを記載する	索引は自動読み込みされ、詳細は質問に応じてリンクから参照します

必要時に詳細ノートブックを参照させるには、利用するユーザーが対象を閲覧でき、かつ AIプロファイルの ノートブックアクセス が 権限のある全てのノートブック に設定されている必要があります。表示中のノートブックのみ の場合、現在のノートブック外に置いた詳細は参照できません。

Index ノートブック

.agent フォルダ内のノートブックは自動読み込みの対象です。詳細な仕様や過去の分析を大量に置くと、質問と無関係な情報にもコンテキストを使います。

詳細は通常のノートブックやフォルダに置き、.agent には索引（Index）用のノートブックを置く構成にできます。Index には次を記載します。

• どのような情報があるか
• どのような質問で参照するか
• 正本となるノートブックのページへのリンク
• ノートブックの保存場所
• 検索に使えるキーワード
• 情報が見つからない場合や判断できない場合の扱い

WARNING

参照先には、ノートブック名だけでなく対象ページへのリンクを設定してください。ノートブック名や保存場所だけでは、AIエージェントが .agent フォルダ外のページを直接特定できません。対象ページを開き、ページの URL をコピーして Index へリンクとして挿入します。

構成例です。WORKSPACE_ID / NOTEBOOK_ID / PAGE_ID は実際の URL に置き換えます。

# Agent Context Index

## 共通ルール

* 指標の定義は「KPI定義」ノートブックを正本とする
* 定義が見つからない場合は推測せず、ユーザーへ確認する
* SQLを作成する前に対象期間とタイムゾーンを確認する

## Knowledge Map

### 売上・受注

* 参照先: [売上・受注指標](https://app.codatum.com/workspace/WORKSPACE_ID/notebook/NOTEBOOK_ID/PAGE_ID)
* 保存場所: チームスペース「Data Knowledge」
* 利用する場面: 売上、受注、キャンセルに関する分析
* 検索キーワード: 売上、受注、キャンセル、GMV

フォルダ構成の例

索引と正本のノートブックは、たとえば次のように配置します。.agent 以外のフォルダ名・ノートブック名に決まりはなく、動作にも影響しません。GitHub の慣習にならい、フォルダごとに README という名前のノートブックを1冊置いて入口にすると、人と AIエージェントの双方に意図が伝わりやすくなります。

チームスペース「Data Knowledge」
├── .agent
│   └── README（全体の索引）
├── 売上・受注
│   ├── README（このフォルダの入口）
│   └── 受注キャンセルの分析
└── 顧客・解約
    └── README

README の中身は、参照先ページへのリンクと1行の説明の箇条書きで十分です。階層が深くなる場合は、上位の README から下位フォルダの README へリンクし、README をたどって詳細に到達できるようにします。

# README

* [売上・受注ガイド](ページのURL): 指標定義と集計SQLの正本
* [顧客・解約ガイド](ページのURL): 顧客セグメントと解約率の定義
* 定義が見つからない場合は推測せず、ユーザーへ確認する

売上、顧客のようにドメインごとへフォルダを分けると、索引からの参照と更新がしやすくなります。ナレッジをドキュメントの集まりとして管理する考え方は、Google Cloud の Open Knowledge Format の記事も参考になります。

避ける構成

次の構成は避けてください。

• .agent フォルダへ詳細な仕様書や過去の分析をすべて置く
• 同じ指標の定義を複数のコンテキストへ重複して書く
• 正本や参照先を示さず、要約だけを書く
• 更新日や適用範囲が不明なルールを書く
• コンテキストによってアクセス権限やツール実行範囲を制御しようとする

アクセス範囲や利用できるツールは、ノートブック・チームスペースの権限と AIプロファイル のツール権限で設定します。