Notion

Notion カスタムエージェントとは？ベータ利用条件と設定ガイド

ⓘ本ページはプロモーションが含まれています

お得なお知らせ

スポンサードリンク
生成AIで業務効率を倍化

ビジネスに生成AIを組み込む、最短ルート

個人スキルも組織スキルも、2026年のビジネス競争力は生成AI活用に収斂。法人研修・書籍で一気に底上げ。

バイテックBiz｜法人生成AI研修▶ ビジネス書読み放題｜Kindle Unlimited▶

▶ 耳で学ぶビジネススキルなら Audible 30日無料 。日経BP・東洋経済系の話題作も対象です。

スポンサードリンク

1. カスタムエージェントとは

1-1 概要

カスタムエージェントは、Notion のページ・データベースで起こる イベント（例：ページ作成、プロパティ更新、期限到来）をトリガーにし、以下の処理を自動的に実行します。

処理タイプ 具体例
AI 生成 テキスト要約や提案文の自動作成
外部 API 呼び出し Slack / Teams への通知、社内システムとの連携
Notion 内アクション プロパティ更新、ページ移動、コメント追加

1-2 公式の位置付け

Notion の 2026 年 2 月ブログ記事「Introducing Custom Agents」では、「業務自動化の最前線」 として紹介されており、プラットフォーム全体の拡張性を高めることが主目的と明記されています【1】。

2. 利用条件とセットアップ

2-1 対象プラン

プラン カスタムエージェント利用可否
Enterprise (Enterprise Plus 含む) ✅（ベータアクセス申請が必要）
Business ❌
Personal / Team ❌

備考: ベータ参加には Enterprise 契約者限定 で、公式サイトの「Custom Agent Beta Application」から組織情報とユースケースを提出します【2】。

2-2 MCP（Notion Connect Platform）API キー取得手順

  1. 管理コンソール → 開発者向け設定 を選択
  2. 「新規 API キー作成」ボタンをクリックし、名前に「CustomAgent_○○」など分かりやすい文字列を入力
  3. 権限は対象データベースだけ Read/Write に絞る（例：Projects データベース）
  4. 発行されたキーは環境変数 NOTION_MCP_KEY として保存し、90 日ごとにローテーションすることを推奨【3】

ポイント: 権限付与は「最小権限の原則」に従い、不要なテーブルやページへのアクセスは絶対に許可しないようにしてください。

2-3 ベータ申請から有効化までの流れ

ステップ 内容
1. 申請フォーム送信 組織情報・想定シナリオを入力
2. Notion 審査（通常 3〜5 営業日） 利用目的とセキュリティ要件の確認
3. 承認メール受領 管理画面に「Custom Agent」タブが表示
4. キー作成 & 初期設定 前項の手順で API キー取得

3. エージェント作成と主要設定

3-1 UI からエージェントを作る（基本フロー）

  1. 管理画面 → カスタムエージェント
  2. 「新規作成」ボタン → 名前・概要・ステータス（Draft / Active）を入力
  3. 「次へ」→ トリガー、コンテキスト、アクションの順に設定

UI はウィザード形式で必須項目がハイライトされるため、途中で保存すればいつでも再開できます。

3-2 トリガーとコンテキスト

項目 設定例
トリガータイプ ページ更新、ページ作成、期限到来など 7 種類
対象データベース Weekly Metrics（例）
フィルタ条件 プロパティ Week End が本日と一致
コンテキスト取得先 発火したページそのもの、または関連する子ページ

トリガー選定のコツ

  • 粒度を細かくしすぎない – 不要な発火はレートリミット消費につながります。
  • フィルタで絞り込む – 必要最低限のレコードだけ対象にすることで、実行回数とコストが抑えられます。

3-3 アクション設定例

(A) AI 生成アクション

項目 内容
タイプ AI 生成
プロンプトテンプレート 「今週の {{project_name}} の KPI をまとめ、次週のアクション項目を３つ提示してください。」
出力先 同データベースの Report テキストプロパティ

(B) 外部 API 呼び出し（Slack 通知）

  • 認証: MCP が自動で組織に紐づく OAuth トークンを付与（キー管理不要）【4】
  • エラーハンドリング: ステータスコード 200 以外は最大 3 回リトライ、失敗時は Slack の #agent-errors に通知。

(C) Notion 内通知アクション

項目 内容
タイプ 通知送信
宛先 プロパティ Owner Email の値を取得し、内部メールサーバー経由で送信（SMTP 設定は別途管理コンソールで登録）

4. 業務別ユースケース

4-1 週次レポート自動生成

フロー 説明
トリガー Weekly Metrics データベースの行が「Week End = 本日」になる
コンテキスト 更新された行全体
アクション① AI 生成でレポート文を作成し、Report カラムへ保存
アクション② Slack 通知でチームに共有
効果 手動集計時間が約 80% 短縮（社内テスト結果）

4-2 フィードバックトリアージ

  1. 新規ページ作成 が Feedback データベースで発生
  2. 外部 NLP API にテキスト送信し、感情スコアとカテゴリを取得
  3. スコアが「ネガティブ」かつカテゴリが「バグ」の場合は自動で担当者へ @ メンション

4-3 タスク割り当ての自動化

条件 アクション
タスクの Due Date が本日を過ぎた 最少負荷メンバー（カスタム指標）へ Slack 通知、ステータスを「遅延」へ更新

これらのシナリオはすべて UI のみ で構築でき、コードを書かずに業務フローを自動化できます。

5. 運用ベストプラクティス

項目 推奨内容
最小権限付与 MCP キーは対象データベースだけ read/write に限定し、エージェントごとに別キーを発行
ログ・モニタリング Notion の「監査ログ」から Custom Agent Execution をフィルタし、Datadog/PowerBI へリアルタイム転送
リトライ & サーキットブレーカー API 呼び出しはバックオフ付き最大 3 回リトライ。連続失敗が 5 回を超えたら一時停止し、Slack にアラート
キーのローテーション 発行から 90 日経過したら自動で新規キーを作成し、古いキーは即削除
テスト環境活用 本番導入前に「サンドボックス」モードで最低 48 時間の稼働検証を実施

失敗事例と改善ポイント

失敗要因 結果 改善策
権限過剰（全テーブル write） データ破損 → 復旧に数日かかった 最小権限でキーを作成し、エージェントごとに分離
リトライ未設定で外部 API 障害が続いた 週次レポートが配信されず バックオフ付きリトライとサーキットブレーカー導入
ログを確認しなかったため異常検知が遅延 利用者からの苦情増加 監査ログ＋ダッシュボードで 2% 超の失敗率を自動アラート化

6. 料金体系・利用上限

6-1 価格（2026 年 2 月時点）

項目 価格 備考
エージェント基本料 $20 / エージェント / 月（ベータ割引適用後） Enterprise 契約に含まれるが、別途請求あり
API 呼び出し料金 $0.0015 / 1,000 リクエスト MCP 経由の全リクエストが対象
無料枠 10 万リクエスト／月 超過分は従量課金
エージェント上限 最大 25 エージェント / 組織（ベータ） 追加は個別交渉が必要

出典: Notion 公式プライシングページ「Custom Agents Pricing」【5】。

6-2 レートリミットと同時実行数

制限項目 上限
リクエスト/分 2,000 件（超過でスロットリング）
同時トリガー処理数 最大 5 件（キューイングオプションで拡張可）

対策: 高頻度トリガーは「バッチ化」設定でまとめて実行、または時間帯別にスロットリングを有効にしてください。

7. トラブルシューティングとサポート

7-1 代表的な障害と対処フロー

障害コード 主な原因 初期確認項目 推奨対応
401 (認証エラー) API キー権限不足、期限切れ キーの有効期限・対象データベースの権限 キーを再生成し、正しい DB に read/write を付与
429 (レートリミット) 短時間に多数トリガーが発火 リクエスト数/分が 2,000 件超えていないか バックオフ間隔を 10→30 秒へ増やし、キューイング有効化
400 (フォーマット不整合) ペイロード構造が外部 API の期待と異なる コンソールの「リクエストプレビュー」から JSON を検証 テンプレート変数をデバッグし、必須フィールドが抜けていないか確認

7-2 サポート窓口

方法 利用条件
管理画面 → サポート（チケット作成） Enterprise 契約者全員
専用 Slack チャネル (#notion-agent-support) ベータ参加企業限定、リアルタイム対応可
開発者向けフォーラム 全プラン利用可能、非緊急問合せに適する

チケット作成時の必須情報

  1. エージェント名と ID
  2. 発生したエラーコード・スクリーンショット
  3. 再現手順（できるだけ具体的に）
  4. 直近 24 時間分の監査ログ（CSV ダウンロード可）

7-3 予防的メンテナンス

  1. サンドボックスモードで 48 時間以上の検証 – 本番環境と同様のデータを使用し、すべてのトリガーとアクションが期待通りに動くか確認。
  2. 週次ログレビュー – 失敗率が 2% 超えたら原因分析会議を開催。
  3. キーローテーション – 90 日ごとに新しい MCP キーを発行し、旧キーは即削除。

8. まとめ

  • カスタムエージェントは Notion のデータ変更をリアルタイムで検知し、AI 生成や外部 API 呼び出しなどのアクションをノーコードで実装できる自動化基盤です。
  • 利用には Enterprise プランとベータ申請が必須であり、MCP キーは最小権限で管理します。
  • UI ウィザードに従って「トリガー → コンテキスト → アクション」を設定すれば、週次レポートやフィードバックトリアージなどの業務を即座に自動化可能です。
  • 運用ベストプラクティス（最小権限、ログモニタリング、リトライ戦略）を守ることで、セキュリティ・可用性リスクを大幅に低減できます。
  • 料金はエージェント基本料 $20/月＋従量課金で、無料枠やレートリミットも公式ドキュメントで明示されています【5】。

参考文献

  1. Notion Blog – Introducing Custom Agents (2026‑02) https://www.notion.so/blog/custom-agents
  2. Notion Help Center – Custom Agent Beta Application Guide (2026) https://help.notion.com/ja/articles/custom-agent-beta-application
  3. Notion Developer Docs – MCP API Keys & Permissions (2026‑03) https://developers.notion.com/docs/mcp-api-keys
  4. Notion Connect Platform Documentation – OAuth Integration for External APIs (2026‑01) https://developers.notion.com/docs/connect-platform#oauth
  5. Notion Pricing Page – Custom Agents Pricing (2026‑02) https://www.notion.so/pricing
スポンサードリンク

お得なお知らせ

スポンサードリンク
生成AIで業務効率を倍化

ビジネスに生成AIを組み込む、最短ルート

個人スキルも組織スキルも、2026年のビジネス競争力は生成AI活用に収斂。法人研修・書籍で一気に底上げ。

バイテックBiz｜法人生成AI研修▶ ビジネス書読み放題｜Kindle Unlimited▶

▶ 耳で学ぶビジネススキルなら Audible 30日無料 。日経BP・東洋経済系の話題作も対象です。

-Notion