Notion Custom Agentsを使う前に、先にコンテキストブリーフを書く
Notion Custom Agentsはより多くの業務文脈を読み、インテグレーションを使い、作業量に応じてクレジットを消費する場合があります。曖昧で高くつくエージェント実行を避けるために、短いコンテキストブリーフを先に用意します。
2026年5月8日
Notion Custom Agentsは、より多くの業務文脈を読み、インテグレーションを使い、skillsやAI Autofillと組み合わさるようになっています。Notionの資料では、読んだ量、検索、実行した操作、モデル、実行頻度などによってクレジットが使われることも説明されています。
Highlight Reel
チームで再利用できるエージェントブリーフを残す
AIへの指示、出典メモ、判断、レビュー基準を整理し、次のエージェント実行でも使える文脈として保存します。
つまり、エージェントへの依頼は単なるチャットメッセージというより、仕事のブリーフに近づいています。
Notion Custom Agentでタスクを自動化する前に、先にコンテキストブリーフを書いてください。
先に結論
良いNotion Custom Agentブリーフは、五つの問いに答えます。
- エージェントに何をしてほしいのか。
- どの情報源や文脈を使ってよいのか。
- 何を無視するべきか。
- どの形式で出力するべきか。
- 結果を信頼する前に、人間がどこを確認するべきか。
目的はプロンプトを長くすることではありません。仕事を明確にすることです。
なぜ文脈コストを先に考えるのか
NotionのCustom Agent pricing資料では、エージェントが一回の実行を完了するために必要な作業に応じてクレジットを使うと説明されています。読む量、検索する量、実行する操作、モデル、頻度、内容量などが関係します。
これは価格の話だけではありません。仕事の流れとして見ると、次の意味があります。
整理されていない文脈にもコストがかかる。エージェントが不要なワークスペース内容を読み、間違ったデータベースを検索し、曖昧な依頼に基づいて動けば、答えが悪くなるだけではありません。そもそも範囲が決まっていない作業にクレジットとレビュー時間を使うことになります。
解決策はエージェントから文脈を奪うことではありません。正しい文脈を渡すことです。
Custom Agentコンテキストブリーフのテンプレート
Custom Agentを作成または実行する前に使います。
# Custom Agentコンテキストブリーフ
## 依頼
エージェントに何をしてほしいか。
## 使用してよい情報源
- データベース:
- ページ:
- Slack / Teamsの文脈:
- 会議メモ:
## 無視するもの
- 古いドキュメント:
- 非公開の会話:
- まだ使うべきでない下書き:
## 出力形式
- 要約:
- 表:
- タスク:
- 判断メモ:
## レビュー基準
- レビュー担当:
- 確認すべきこと:
- エージェントが公開または変更してはいけないこと:このブリーフはNotion、プロジェクト文書、保存したHighlight Reelページのどこに置いてもかまいません。大事なのは、次回も使えることです。
エージェント実行後に何を保存するか
Custom Agentを実行したあと、最終回答だけを保存しないでください。
| 保存するもの | 理由 |
|---|---|
| 依頼 | 未来のチームメンバーが、エージェントに何を頼んだか分かる |
| 情報源 | 結果はエージェントが読んだものに依存する |
| 出力 | 回答、タスク、更新、下書きそのもの |
| 人間の編集 | エージェント出力と承認された内容の違いが分かる |
| 次の対応 | 次の実行で同じ文脈を探し直さなくて済む |
エージェントがタスクを作り、ページを更新し、データベース行を埋め、Slackの文脈を要約するなら、判断の流れも残します。そうしないと、ワークスペースは更新されても理由が消えます。
まだエージェントを走らせない方がよい場合
次の状態なら一度止めます。
- 情報源データベースが整理されていない
- 古いドキュメントと現在のポリシーが矛盾している
- 出力が顧客向けになる
- エージェントが非公開Slackチャンネルに触れる可能性がある
- レビュー担当が決まっていない
- タスクが曖昧でクレジット使用量を見積もりにくい
これは自動化に反対する話ではありません。自動化を再現可能にするための手順です。
Highlight Reelを使う場面
Highlight Reelは、情報源や文脈がAI会話、会議、散らかった調査から来ているときに役立ちます。
エージェント実行前には、整理された文脈ページを保存します。
- 判断要約
- 情報源リンク
- 採用した前提
- 却下した案
- 次の作業
エージェント実行後には、有用な出力と人間の判断を保存します。
- エージェントが作ったもの
- 採用または修正された内容
- 次回の実行で再利用すべきこと
こうすると、エージェントの実行はワークスペース活動の一行ではなく、長く使える仕事の成果物になります。
よくある質問
これはNotionだけの話ですか？
いいえ。NotionはCustom Agentsによってこの仕事の流れが見えやすい入口になっているだけです。同じコンテキストブリーフの型はSlackエージェント、Microsoftエージェント、MCPツール、社内自動化にも使えます。
コンテキストブリーフはNotionの中に置くべきですか？
チームが自然にレビューする場所でかまいません。情報源がAI会話なら、生ログよりも整理されたHighlight Reelページの方が引き継ぎに向くことがあります。
良いブリーフを書けばNotion creditsは必ず減りますか？
保証はできません。実際のクレジット使用量はエージェント設定、モデル、操作、頻度、内容量に依存します。ブリーフはコスト保証ではなく、範囲を明確にするための道具です。
最小限のブリーフには何が必要ですか？
依頼内容、使用してよい情報源、無視する情報源、出力形式、レビュー担当者です。