Notion カスタムエージェントの概要と利用手順・ベータ版注意点

Contents

1 1. カスタムエージェントとは
2 2. 利用前提条件
3 3. 機能の有効化とエージェント作成フロー
- 3.1 3.1 カスタムエージェント機能をオンにする手順
- 3.2 3.2 エージェント作成画面の主要項目
4 4. トリガーとアクションの具体例
- 4.1 4.1 主なトリガー設定例
- 4.2 4.2 アクション定義例
5 5. 外部サービス連携とセキュリティベストプラクティス
- 5.1 5.1 API・ファイル連携の基本フロー（管理者権限が必要）
- 5.2 5.2 最小権限原則と監査ログ活用
6 6. テスト・デバッグ手順
7 7. 実務ユースケース集
8 8. よくある落とし穴と対策
9 9. ベータ版のコストと利用制限（2026 年 4 月時点）
10 10. まとめ

スポンサードリンク

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

項目	内容
定義	ユーザーが設定したトリガー（例：スケジュール、データベース更新）に応じて、バックグラウンドで自動的に処理を実行する Notion AI の機能です。
提供形態	ベータ版として提供されており、対象プランと権限が必要です（下記「利用前提条件」参照）。
主な用途	週次レポートの自動生成、フィードバックのトリアージ、プロジェクト進捗サマリー作成など、手作業で行っていた定型業務をコードレスで自動化できます。

公式情報：https://www.notion.com/ja/help/custom-agents

2. 利用前提条件

2.1 必要プラン

プラン	カスタムエージェントの可否
Personal（個人）	❌ 利用できません
Team、Enterprise	✅ ベータ機能として利用可能

根拠：Notion のプラン比較ページに「Team 以上で AI ワークフローが利用可能」と記載されています。

2.2 必要な権限

管理者権限（Workspace 管理者またはオーナー）
カスタムエージェントの有効化・設定変更は管理者のみ実行できます。
API アクセス権（必要に応じて個別ページやデータベースへの「Read / Write」権限）
エージェントが操作する対象ページ／データベースには、あらかじめ適切な権限を付与しておく必要があります。

公式情報：https://www.notion.com/ja/help/permissions

2.3 ベータプログラムへの参加

管理者アカウントで Notion にサインイン
左サイドバーの 設定 → ベータプログラム を開く
「AI カスタムエージェント」のスイッチをオンにし、利用規約に同意

ベータアクセスは自動承認されることもありますが、承認メールが届かない場合はサポート窓口へお問い合わせください。

3. 機能の有効化とエージェント作成フロー

3.1 カスタムエージェント機能をオンにする手順

手順	操作内容
1	左サイドバー → 設定 → AI を選択
2	「カスタムエージェント」のトグルスイッチを ON にする
3	表示されたベータ利用規約を確認し、同意ボタンをクリック

有効化が完了すると、左サイドバーに 「エージェント」 メニューが表示されます。

3.2 エージェント作成画面の主要項目

項目	必須	説明
名前	◯	ワークスペース内で一意になる識別子
説明	◯	エージェントの目的・対象データベースを簡潔に記述
トリガー	◯	実行開始条件（スケジュール、DB 更新、ページ追加など）
アクション	◯	トリガー発生時に実行する処理
実行条件（オプション）	✕	フィルター式で対象を絞り込む例： `status = "Done"`
通知先（オプション）	✕	Slack、メール、Webhook など結果送信先

ポイント
- トリガーとアクションはドラッグ＆ドロップで順序変更可能です。
- 設定完了後は「保存」→「テスト実行」で即座に動作確認ができます。

4. トリガーとアクションの具体例

4.1 主なトリガー設定例

トリガー	設定手順概要	推奨ユースケース
スケジュール	「毎週」→「月曜」→「09:00」	週次レポート自動生成
データベース更新	対象 DB → 「プロパティ変更」→ 条件 `status = "In Review"`	フィードバックのトリアージ
ページ追加	特定フォルダ／ページ → 「新規作成」	プロジェクト開始時のタスク割り当て

条件式は Notion のフィルター構文と同様に記述でき、AND / OR で複数条件を組み合わせられます。

4.2 アクション定義例

アクション	実装イメージ	主な利用シーン
テンプレートページへのコンテンツ挿入	`{{view_summary}}` プレースホルダーに集計結果を埋め込む	自動レポート生成
データベース行の追加・更新	新規タスクを自動で作成し、担当者列へユーザーを割り当てる	タスク割り当て
コメントの自動分類と通知	コメント取得 → キーワードマッチング → Slack へ通知	フィードバック triage

備考：これらはすべて Notion の内部 API（ページ生成、データベース操作、コメント書き込み）を組み合わせたコードレス処理です。外部サーバや独自スクリプトは不要です。

5. 外部サービス連携とセキュリティベストプラクティス

5.1 API・ファイル連携の基本フロー（管理者権限が必要）

外部 API 呼び出し
エージェントの「アクション」→「HTTP リクエスト」を選択。
必要なヘッダーやボディは変数置換で動的に生成できます（例：{{page.title}}）。

{
  &quot;method&quot;: &quot;POST&quot;,
  &quot;url&quot;: &quot;https://api.example.com/notify&quot;,
  &quot;headers&quot;: {
    &quot;Authorization&quot;: &quot;Bearer {{integration_token}}&quot;,
    &quot;Content-Type&quot;: &quot;application/json&quot;
  },
  &quot;body&quot;: {
    &quot;title&quot;: &quot;{{page.title}}&quot;,
    &quot;status&quot;: &quot;{{database.status}}&quot;
  }
}

{

"method": "POST",

"url": "https://api.example.com/notify",

"headers": {

"Authorization": "Bearer {{integration_token}}",

"Content-Type": "application/json"

"body": {

"title": "{{page.title}}",

"status": "{{database.status}}"

}

CSV／JSON インポート
「ファイル取得」アクションで外部 URL から CSV をダウンロードし、{{csv_rows}} をデータベース行作成にマッピングします。

権限管理の要点
- 外部 API 用トークンはエージェントごとに個別発行し、スコープは「Read / Write」だけに絞ります。
- トークンの有効期限が切れた場合は、Notion の 統合設定 画面で自動更新通知を受け取るようにしておくと安心です。

5.2 最小権限原則と監査ログ活用

項目	推奨手順
権限の最小化	エージェントが操作するページ／データベースに対し、必要な「Read」または「Write」だけを付与。不要な領域にはアクセス権を設定しない。
監査ログの確認	管理コンソール → 「セキュリティ」→「アクションログ」でエージェント実行履歴を月次でレビュー。異常なリクエスト数は Slack などに通知設定すると早期検知が可能。
定期的な権限レビュー	四半期ごとにエージェント一覧と権限マトリックスを点検し、不要になったエージェントは無効化または削除する。

6. テスト・デバッグ手順

テスト実行
エージェント編集画面右上の 「テスト実行」 ボタンをクリック。
デバッグコンソールの確認
実行結果は画面下部に表示される デバッグコンソール に出力されます。成功時は ✅ Execution completed、失敗時はエラーメッセージとスタックトレースが掲載されます。 |
ログの永続化
管理コンソールの 「アクションログ」 から実行履歴を期間指定で閲覧・CSV エクスポート可能です。

サンドボックスモード（オプション）を有効にすると、テスト時に本番データを書き換えずにシミュレーションができます。

7. 実務ユースケース集

ユースケース	トリガー例	アクション例	主な効果
週次レポート自動生成	毎週月曜 09:00（スケジュール）	データベース集計 → テンプレートページへ埋め込み → Slack 通知	手作業の約80％削減、報告遅延ゼロ
フィードバック triage	フィードバック DB の新規レコード追加	コメント抽出 → キーワード分類 → 担当者タスク自動割り当て	対応漏れ防止、担当者負荷分散
プロジェクト進捗サマリー	ステータスが “Done” に変更（DB 更新）	進捗ページにサマリーブロック追加 → メールで週次まとめ送信	ステークホルダーへの可視化を自動化

ポイント：すべてのフローは Notion 内だけで完結でき、外部ツールが必要な場合でも API 呼び出し1回程度に抑えられます。

8. よくある落とし穴と対策

落とし穴	原因	回避策
トリガーが発火しない	ワークスペースのタイムゾーン設定ミス	設定 → 「Workspace」→「タイムゾーン」を確認し、エージェントでも同一に設定
権限エラーでアクション失敗	エージェントに必要なページ/DB の Write 権限が付与されていない	対象オブジェクトごとに最小限の Write 権限を個別付与
リクエスト上限超過	ループ処理や極端に短いスケジュール設定	トリガー間隔は最低 15 分以上、バッチ処理はまとめて実行
外部 API の認証失敗	トークンの有効期限切れまたはスコープ不足	トークン更新を自動通知（統合設定 → 「トークン管理」）

9. ベータ版のコストと利用制限（2026 年 4 月時点）

項目	内容
基本料金	カスタムエージェントはベータ機能として無料提供されています。
リクエスト上限	公式ヘルプに記載されている「1 日あたり 10,000 件」の API コール上限があります（Enterprise プランでは緩和オプションあり）。
超過時の課金	上限を超えると、追加リクエスト分は別途従量課金が発生する可能性があります。具体的な単価は公式ドキュメントに記載されている通りです（※現在は公開情報がありません）。
モニタリング	管理コンソールの「使用状況」ページで日次・月次のリクエスト数を確認でき、アラート設定も可能です。

おすすめ：大量レポートやリアルタイム通知が必要なチームは、利用状況ダッシュボードを定期的にチェックし、「追加リクエストパック」の購入検討をご相談ください。

10. まとめ

プランと権限：Team/Enterprise プラン＋管理者権限が必須。
有効化手順は数クリックで完了し、左サイドバーにエージェントメニューが追加されます。
トリガー・アクションはスケジュール、DB 更新、ページ作成の 3 パターンと、テンプレート挿入・データベース操作・コメント処理の組み合わせでほぼすべての業務を自動化可能。
外部連携は Notion の統合機能を利用し、最小権限で安全に実装できます。
テストとデバッグは「テスト実行」→「デバッグコンソール確認」の流れで迅速に問題点を特定。
ベータ版の制約（リクエスト上限・有料オプション）は公式ヘルプを参照し、使用量をモニタリングしてコスト管理を行うことが重要です。

Notion AI カスタムエージェントは、コードを書かずに業務効率化を実現できる強力なツールです。上記ガイドラインに沿って安全・効果的に導入し、チームの生産性向上につなげてください。

参考リンク

カスタムエージェント公式ヘルプ：https://www.notion.com/ja/help/custom-agents
プラン比較（Team / Enterprise）：https://www.notion.com/ja/pricing
権限と管理者設定：https://www.notion.com/ja/help/permissions
ベータプログラム参加方法：https://www.notion.com/ja/help/beta-program

スポンサードリンク