カスタムエージェント

カスタムエージェントを構築する方法
この記事の内容

カスタムエージェントを使って、チームの反復作業を自動化する共有ワークフローを構築しましょう。必要なときに、バックグラウンドで正確に実行されます 🤖

よくあるご質問(FAQ)に移動

カスタムエージェントは現在ベータ版であり、既存の契約(存在する場合)のベータ版に関する条項が適用されます。

カスタムエージェントは、チーム全体の定期的な手動ワークフローを自動化します。設定されたトリガーが作動すると、既存のドキュメントやデータベースをコンテキストとして使い、バックグラウンドで自動的に実行されます。

週次レポートやフィードバックのトリアージなど、反復作業のワークフローを一度設定すると、チーム全体が頼れる共有リソースになります。

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

カスタムエージェントはNotion内に存在し、ユーザーの指示に従って動作します。設定すると、次のことが可能になります。

  • Notionのページやデータベース、特定の接続済みアプリから読み取る。

  • 定期的なトリガーやワークスペースのイベントに応じて実行する。

  • レポートの投稿、バグの報告、記録の更新、メッセージの送信などのアクションを実行する。

Notionエージェントとは異なり、カスタムエージェントはトリガーとスケジュールに基づいてバックグラウンドで自動的に実行されるように設計されています。

既存のドキュメントやデータベースをコンテキストとして使う

カスタムエージェントはNotionに直接組み込まれています。エージェントは既存のドキュメントやデータベースをコンテキストとして使い、Slackと連携して生産性を向上させます。カスタムエージェントを使うと、以下のことを行えます。

  • Notionのページ、データベースのプロパティ、コメントでエージェントを@メンションする。

  • データベースのイベントに添付する(ページが作成または更新されたときなど)。

  • 設定したトリガーに従って、ワークスペースや接続されたツールを監視する。

トリガーを使って反復作業を自動的に処理する

カスタムエージェントのトリガーを使うと、毎回手動で開始せずに実行できます。トリガーを一度設定すると、その後はバックグラウンドで作業が継続されます。

  • スケジュールに従って実行できます(毎日、毎週、毎月など)。

  • NotionとSlackのイベントに反応します。

  • 公開後もバックグラウンドで実行を継続します。

これにより、定期的なレポート、トリアージキュー、ナレッジメンテナンスなどの自動化されたワークフローが可能になり、時間の節約につながります。

安全性と透明性を重視した設計

エージェントは、アクセス権を明示的に付与されたページ、データベース、外部アプリに対してのみ動作します。デフォルトではワークスペースへのフルアクセス権を持たないため、リスクが低減されます。

  • 各エージェントを編集、実行、または操作できるユーザーの管理が可能です。

  • アクティビティログを表示し、エージェントがいつどのような操作を行ったかを確認できます。

  • バージョン履歴を使い、過去の構成を確認または復元できます。

  • 実行内容を確認して変更できる状態に保つことで、安全に反復作業を行えます。

  • Notionのビジネスプランまたはエンタープライズプランを利用していること。カスタムエージェントの料金設定について詳しく見る。

  • カスタムエージェントの作成、編集、閲覧、操作には、デスクトップ版またはWeb版のNotionを使用してください。

カスタムエージェントは、複数の場所から構築できます。主なエントリーポイントは、サイドバーのエージェントセクションです。

  1. サイドバーのエージェントセクションに移動し、+ を選択して新しいカスタムエージェントを作成します。

2. 開始方法を選択します。

  • AIチャットで作成する

    • チャットで、エージェントに何をさせたいかを自然言語で説明します。

    • Notion AIが生成して反復する下書き指示、トリガー、アクセス権を確認します。

    • 保存します。

  • テンプレートから作成する

    • テンプレートを選択します。

    • Notion AIが生成して反復する下書き指示、トリガー、アクセス権を確認します。

    • 保存します。

  • 一から作成する

    • 空白を作成を選択します。

    • 空の指示フィールドから始めるか、チャットで指示を出します。

    • 明確で具体的な指示のベストプラクティスに従って、指示を手動で作成します。エージェントが何をすべきか、どのように動作するべきか、どのような仕事を処理すべきかを定義します。

    • ワークフローに合わせてトリガー、アクセス権、AIモデルを設定します。

    • 保存します。

エージェントに的確な指示を出すには、まず作業内容と期待される結果を明確にすることから始めます。次に、具体的な実行ステップ、インプット、アウトプットを書き加えます。具体例があれば、活用しましょう。

ヒントカスタムエージェントのテンプレートをベースにカスタマイズしていくと便利です。

トリガーは、エージェントを実行するタイミングを決定します。単一のエージェントに対して複数のトリガータイプを組み合わせることができます。

時間ベースの定期的なスケジュールでワークフローを自動化する

定期的なスケジュールを使い、スケジュールに基づいてエージェントを実行します。

  1. カスタムエージェントの設定を開きます。

  2. トリガーセクションに移動します。

  3. 定期的なトリガーを追加します。

  4. エージェントを実行するタイミングを選択します。

    • 頻度を選択します(毎日、毎週、毎月、または毎年)。

    • タイムゾーンを含む特定の時間を設定します(たとえば「毎日午前0時(太平洋標準時)」など)。

  5. 次にスケジュールされた実行時間を確認し、スケジュールが正しいことを確かめます。

  6. トリガーを保存します。

Notionトリガーを使う

Notionトリガーは、ワークスペース内のイベントに基づいてエージェントを実行します。次の場合にエージェントをトリガーできます。

  • ページにコメントが追加されたとき。

  • ページがデータベースに追加されたとき。

  • データベース内のプロパティが更新されたとき。

  • ページがデータベースから削除されたとき。

Notionトリガーを追加するには:

  1. カスタムエージェントの設定を開き、トリガーを選択します。

  2. Notionトリガーの種類を選択します。

  3. 以下を指定します。

    • 監視するページまたはデータベース。

    • イベント(たとえば「データベースで作成されたページ」など)。

    • その他のフィルターや条件(利用可能な場合)。

  4. 保存します。

Slackトリガーを使う

Slackトリガーを使うと、エージェントは公開Slackチャンネルでイベントを監視できます。

設定要件

Slackトリガーを設定するには、まずSlackワークスペースの管理者が、カスタムエージェント用のNotionインテグレーションを有効にする必要があります。この設定により、カスタムエージェントがSlack内で活動するのに必要な「読み取り」と「書き込み」の権限が付与されます。インテグレーションが有効になれば、新しいメッセージや絵文字リアクションに基づいたトリガーを設定できるようになります。

エージェントは以下のことを監視できます。

  • チャンネルへのメッセージ投稿

  • メッセージへの絵文字リアクションの追加。

  • チャンネル内でのスレッドの開始

  • メッセージ内でのカスタムエージェントのメンション

    • 備考:Slack内でメンションしてエージェントを起動するには、まずSlackワークスペースの管理者が、すべてのメンバーに対してユーザーグループの作成を許可している必要があります。この設定が有効になると、関連付けられたSlackチャンネル内でエージェントの名前をメンションするだけで、ワークペース内のメンバー全員がエージェントを起動できるようになります。

Slackトリガーを追加するには:

  1. まだSlackをエージェントに接続していない場合は、セットアップ中に接続します。

  2. トリガーで、Slackトリガーを追加します。

  3. 以下を選択します。

    • イベントの種類。

    • 監視するチャンネル。

    • その他のフィルターや条件(利用可能な場合)。

  4. 保存します。

備考:

  • Slackでカスタムエージェントを名前で@メンションしたい場合は、Slackワークスペースの管理者が、メンバーに対してユーザーグループの作成を許可している必要があります。これは、Slack側の要件です(Notionの設定ではありません)。

  • Slackの「保存済み」や「後で」セクションのメッセージには対応していません。

カスタムエージェントは、作業のために明示的にアクセスを許可されたコンテンツのみを使います。これは、各エージェントのアクセス設定で構成します。

カスタムエージェントにワークスペース内のコンテンツへのアクセス権を付与する

エージェントがNotionで表示できるものを制御するには:

  1. カスタムエージェントの設定を開きます。

  2. ツールとアクセスセクションに移動します。

  3. エージェントがコンテキストとして使う特定のページまたはデータベースを追加します。

    • 対象となるワークフローにフォーカスしたページやデータベースを追加します(たとえば「顧客チケット」「バグ」「インシデント」など)。

    • ワークスペース全体のコンテンツを含む幅広い範囲を対象にする場合は、Notionの全員と共有されたページへのアクセスを許可します。

  4. 範囲を狭めたい場合は、アクセスを「なし」または少数のページに制限します。

指示の中にNotionページへのリンクを貼り付けても、そのページは関連するツールとアクセスで設定したアクセス権には追加されません。

Webアクセスを許可またはブロックする

エージェントは、必要に応じて任意でWebを閲覧できます。ワークフローが外部情報に依存している場合は、Webアクセスを使います。厳密に内部のワークフローの場合、またはソースをより厳しく制御したい場合は、Webアクセスをオフにしてください。Webアクセスを制御するには:

  1. エージェントの設定を開きます。

  2. Webアクセスのトグルを見つけます。

  3. Webアクセスをオンにすると、エージェントはインターネットから情報を取得できるようになります。

  4. Webアクセスをオフにして、エージェントをNotionと設定されたアプリのみに制限します。

カスタムエージェントにSlackへのアクセス権を付与する

カスタムエージェントは、専用のインテグレーションを通じてSlackの読み取りと書き込みを行えます。Slackをカスタムエージェントに接続する前に、管理者はまずNotion AI設定からSlack AIコネクターをワークスペースに接続する必要があります。エージェントは次のことができます。

  • 選択した公開チャンネルとプライベートチャンネルからの読み取り。

  • 選択した特定のチャンネルにのみ、メッセージの投稿、返信、更新を行う。

  • スレッドにリアクションし、Slackの情報をコンテキストとして使う。

Slack Enterprise Gridはサポートされていません。

Slackを接続するには:

  1. エージェントを設定する際に、プロンプトに従ってSlackに接続します。

  2. SlackアカウントがNotionアカウントと同じメールアドレスを使っていることを確認します。

  3. Slackの認証フローで要求されたスコープを承認します。

  4. エージェントがアクセスできるチャンネルを選択します。

カスタムエージェントは、さまざまな大規模言語モデルで実行できます。これにより、スピード、コスト、品質のバランスを取ることができます。ワークフローが変更された場合や、パフォーマンスのニーズが異なる場合は、時間の経過とともにモデルを調整できます。サポートされているモデルには、Claude、GPT、Geminiがあります。自動が推奨されるデフォルトです。

Notionクレジットダッシュボードでクレジット使用量を追跡する方法を見る。

モデルを選択するには:

  1. エージェントの設定を開きます。

  2. モデルセクションに移動します。

  3. 一貫した動作を実現するには特定のモデルを選択し、リクエストごとに最適なモデルをNotionに選択させるには自動を選択します。

  4. 保存します。

カスタムエージェントは、ワークスペース内の他のユーザーとの共有に関しては、Notionのページと同様に動作しますが、いくつかの違いがあります。

エージェントをチームと共有する

共有すると、エージェントはサイドバーのエージェントセクション、検索結果、およびエージェントを一覧表示または参照するワークスペースエリアに表示されます。

エージェントを共有するには:

  1. 「カスタムエージェント」を開きます。

  2. 共有をクリックします。

  3. ユーザー、グループ、またはワークスペース全体を追加します。

権限レベル

エージェントは、簡略化された権限レベルを使います。

  • フルアクセスエージェントへのフルアクセス権を持つユーザーは、指示、トリガー、アクセス、モデルを設定し、アクティビティログを表示および管理し、エージェントを実行または操作できます。

  • 編集権限エージェントに対する編集権限を持つユーザーは、指示や設定を変更したり、アクティビティを確認したりできます。

  • 閲覧可能とやり取りエージェントに対する閲覧可能とやり取り の権限を持つユーザーは、エージェントを実行してチャットしたり、読み取り専用モードで設定ページ(トリガー、指示、ツール、アクセス)を閲覧したりできます。エージェントの編集や共有はできません。

エージェント自体へのアクセス権を持たないユーザーでも、自身がアクセスできるチャンネル内のSlackメッセージなどに反応するよう設定されたエージェントであれば、トリガーを発生させたり、それと対話したりできる場合があります。

カスタムエージェントが構築されると、サイドバーに表示されます。すべてのカスタムエージェントページには、3つのコアタブがあります。これらのタブを組み合わせて、エージェントの設計、テスト、および長期的なメンテナンスを行います。

  1. チャット特定のエージェント用のプライベートまたは共有の1対1の会話エリア。

    • 新しい指示をテストしたり、エージェントに1回限りのタスクの実行を依頼したり、動作を反復したりするのに役立ちます。

  2. アクティビティフルアクセス権を持つユーザーに表示される、すべてのエージェント実行のログ。

    • ログには、実行のトリガー、実行されたアクション、エラーや失敗が含まれます。

  3. 設定エージェントのコントロールセンター。

    • 設定パネルには、エージェントの指示トリガー、アクセス許可、モデルの選択が含まれます。

設定作業はまさにエージェントとの会話です。カスタムエージェントとのチャットを使って、指示のテスト、修正、ブラッシュアップを行えます。単発タスクや、エラーが発生した状況の説明、さまざまなシナリオを想定したテストの実行などを依頼できます。

設定タブを使ってエージェントを編集する

  1. エージェントページを開きます。

  2. 設定タブに移動します。

  3. 指示トリガー、ページ、データベース、外部ツールへのアクセス、またはモデルの選択を更新します。

  4. 変更を保存して公開します。

  5. チャットタブとアクティビティタブを使い、編集後にエージェントが期待どおりに動作することを確認します。

バージョン履歴を使って変更を元に戻す

カスタムエージェントの以前のバージョンを復元するには:

  1. エージェントページを開きます。

  2. バージョン履歴にアクセスします。

  3. 過去のバージョンを確かめ、次のことを確認します。

    • 変更したユーザー。

    • 変更が行われた日時。

    • 各バージョンで変更された箇所。

  4. 復元したいバージョンを選択します。

  5. エージェントをそのバージョンに戻すことを確認します。


よくあるご質問(FAQ)

右下のNotionエージェントとは何が違うのですか?

Notionエージェントは以下の作業に役立ちます。

  • コンテンツの下書き、編集、要約。

  • ページやデータベースに関する質問に答える。

  • あなたが仕事をする間、単発タスクに取り組む。

カスタムエージェントは以下を行います。

  • ユーザー定義の細かい指示にきちんと従う。

  • トリガーやスケジュールに応じて、バックグラウンドで自律的に働く。

  • ユーザーから明示的にアクセス権を付与されたページ、データベース、外部ツールのみ操作する。

Notionエージェントはオンデマンドで働きます。一方のカスタムエージェントは、自律的に動作します。

実行に失敗した場合、どのようにデバッグすればよいですか?

デバッグは以下の手順で行ってください。

  1. 「エージェント」ページを開きます。

  2. エージェントの設定画面またはエージェントとのチャットビューからアクティビティタブを開きます。

  3. 表示される一覧の中から失敗した実行を見つけます。

  4. それを開いて以下を確認します。

    • 実行をトリガーしたもの。

    • 各ステップでのエージェントの「思考」および実際に行ったアクション。

    • エラーメッセージや説明。

エージェントが意図しない動作をした場合は、以下を確認します。

  • そのエージェントに対する指示やトリガーを調整する。

  • 更新した設定を基に再実行する。

  • 不適切または疑わしい点がある場合は、低評価を付け、可能な範囲で詳しい状況をご説明ください。その情報は、開発チームがシステムの改善に活用させていただきます。

接続するにはどのSlackアプリが必要ですか?

カスタムエージェントでSlackを使用するには:

  1. SlackがNotionで使用しているものと同じメールアドレスに接続されていることを確認してください。

  2. エージェントの設定中にプロンプトが表示されたら、Notionの他の場所でSlackを使用している場合でも、Slackアプリを接続します。

  3. アクセスを承認し、エージェントが読み取りまたは書き込みできるチャンネルを設定します。

The Agent showed "Working on it..." in Slack, but never replied. Why?

The “Working on it…” typing indicator appears as soon as a Custom Agent is triggered. Sometime the Agent will decide not to reply (based on instructions), or may time out before it can send a message. If this happens, the typing indicator will disappear automatically.

If you want to avoid this, you can always turn off the typing indicator in the Slack trigger’s settings, or update the agent’s instructions so it’s more likely to respond to the situations you care about.

カスタムエージェントを作成できるユーザーは?

  • カスタムエージェントは、デフォルトでワークスペース内のすべてのユーザーが利用できます。

    • エンタープライズプランの管理者は、設定 >Notion AI >

      エージェント > エージェントを作成できるユーザーを管理を選択してアクセスを制限できます。

  • エージェントごとに以下の設定を行います。

    • 作成者は、どのユーザーがどのレベルでアクセスできるかを決定します(フルアクセス編集権限対話可能)。

    • Slackでは、チャンネル内の誰もがそのチャンネルのエージェントが投稿したメッセージを閲覧できます。

    • エージェントへのアクセス権限があるユーザーは、そのエージェントが関連付けられているSlackの非公開チャネルへのアクセス権限がなくても、そのエージェントの出力を閲覧できます。

このエージェントがどこで実行されるかを知るにはどうすればよいですか?

エージェントを設定する際には、以下を確認してください。

  1. トリガーで次の情報を確認できます。

    • どのスケジュールが有効か。

    • どのNotionデータベースまたはページが監視されているか。

    • どのSlackチャンネルまたは他のアプリが接続されているか。

  2. アクセス/権限で次の情報を確認できます。

    • エージェントが使用できるページ、データベース、外部ソース。

  3. アクティビティで次の情報を確認できます。

    • エージェントがすでに実行されている場所とその内容。

公開後:

  • アクティビティタブとログを使用して、エージェントが期待される場所でのみ実行されていることを確認します。

  • レビューは定期的に実行され、ワークフローに合わせて動作を調整します。

さらにご質問がある場合は、サポートにメッセージを送信してください

フィードバックを送信

このコンテンツは役に立ちましたか?