カスタムエージェントを作成して最適化するためのベストプラクティス

適切に設計されたカスタムエージェントは、消費クレジットを抑えつつ、より優れた結果をもたらします。以下に、実行ごとの効果を最大限に引き出すコツをご紹介します。

• カスタムエージェントを反復作業に使用する。一度きりの依頼であれば、お使いのプランにデフォルトで含まれているNotionエージェントをご利用ください。あなたがNotionを開いていなくても、カスタムエージェントは、バックグラウンドで自律的にタスクをこなし続けるため、実行にはNotionクレジットが消費されます。

• 具体的なトリガーを選択する。実行条件をすべてのメッセージやデータベースの更新に設定せず、特定の@メンションやプロパティの変更をトリガーにします。不必要な起動を減らし、無駄な実行を抑えます。

• 参照コンテキストの範囲を絞り込む。エージェントがアクセスする情報を必要なページやデータベースに限定します。そうすることで、必要な情報のみを読み取り、一回ごとの実行精度が高まります。

• 何をもって「完了」にするかを定義しておく。実行が完了した状態とはどのようなものか、エージェントに正確に伝えます。指示が明確であればあるほど、エージェントが結果を出すスピードも速くなります。

• 独立したタスクを一括処理する例えば、複数の情報源を一つずつではなく、一度にまとめて読み取るように指示します。

  • ✅ 「プロジェクトデータベースと#support Slackチャンネルの情報を読み取り、週次アップデートを作成してください。」

  • 🚫 「プロジェクトデータベースの情報を読み取り、週次アップデートを作成してください。その後に、#support Slackチャンネルの情報を読み取り、週次アップデートに追加してください。」

• モデルを「自動」モードに設定する。「自動」モードでは、品質とクレジット使用量のバランスを考慮した上で、タスクに最適なモデルが自動で選択されます。

カスタムエージェントは、明確なジョブ、適切なソース、そして「完了」の厳密な定義がある場合に最も信頼性が高くなります。このベストプラクティスの記事では、より良い指示を書く方法、適切なトリガーを選択する方法、そして時間の経過とともに結果を改善する方法について説明します。

何から手をつけてよいかわからない場合は、チームが頻繁に行う作業から始めましょう。カスタムエージェントは、ワークフローが予測可能で、レビューが簡単な場合に最も効果を発揮します。

次のようなワークフローを探します。

• レポートの作成、受信したリクエストのトリアージ、Slackでのよくある質問への回答など、反復可能なワークフロー

• 頻繁に、毎日または毎週発生するワークフロー

• 評価が簡単で、出力が正しいかどうかをすばやく判断できるワークフロー

ワークフローを選択したら、まずは最もシンプルなバージョンのエージェントを作成します。複雑な機能を追加する前に、まずは確実に動作するようにします。

プロセスが安定して予測可能になったら、トリガーやスケジュールを追加して完全に自動化できます。

カスタムエージェントに明確な指示を出すと、より一貫した信頼性の高い結果が得られます。具体的な成功のイメージに焦点を当て、それを実現するために必要なコンテキストを提供します。

望む結果から始める

• すべてのステップをリストアップするのではなく、最終的にどのような出力であるべきかを説明します

• エージェントに、そこに到達する方法を決定させます

• 例：「完了したタスク、ブロッカー、次のステップをまとめた週次ステータス更新を作成してください」

実際の例を共有する

• 以前のステータス更新、フォーマットされたレポート、またはトリアージ済みリクエストを貼り付ける

• 抽象的な説明ではなく、具体的な例を使う

フォーマットと送信先を明確にする

• 出力先を指定する（Slack、データベース、既存のページなど）

• どのプロパティやセクションに入力する必要があるかを明確にする

• 例：「#team-updatesに要約を投稿し、週次レポートデータベースに追加してください」

境界線を明確にする

• エージェントがすべきことと避けるべきことを明確にします

• 例：「新しい週次レポートページではなく、既存の週次レポートページを更新してください」「#supportでのみ返信してください」

エッジケースを明確にする

• データがない場合や報告すべき新しい情報がない場合の対処方法を説明します

• 例：「今週更新情報がない場合は、スキップせずに「更新情報なし」と投稿してください」

指示は短く、的を絞ったものにする

• 指示が短いほど、一貫性のある結果が得られます

• 設定が長くなる場合は、ワークフローを複数のエージェントに分割します

カスタムエージェントを設定する際は、作業をスケジュールに従って実行するか、アクションに応じて実行するか、またはその両方で実行するかを決定します。

予測可能な作業にスケジュールを使う

• アクティビティに関係なく、タスクを一定の頻度で実行する場合は、スケジュールを選択します

• 週次レポート、日次ブリーフィング、月次サマリーなどの定期的な作業に最適です

レスポンシブな作業にはトリガーを使う

• 何かが起こったときにタスクを実行する場合は、トリガーを選択します。

• 例としては、Slackで報告されたバグ、データベースに追加された新しいページ、特定の送信者からのメールなどがあります

必要に応じてスケジュールとトリガーを組み合わせる

• 一部のワークフローには2つのパターンがあります

• たとえば、トリガーベースのエージェントがバグの報告をトリアージし、別のスケジュールに基づくエージェントがトリアージされたバグの週次サマリーをまとめるといった具合です

頻度を低くして限定的な範囲から始める

• 毎日ではなく週単位のスケジュールから始める

• 5つのチャンネルではなく1つのチャンネルから始める

• 出力に一貫性があり信頼性が高いことを確認できたら、規模を拡大する

ワークフローを完全に有効化する前に、時間をかけて設定をテストし、調整します。

トリガーまたはスケジュールを有効にする前にテストする

• 実行をクリックし、エージェントを手動で実行します

• 出力を確認し、期待どおりに動作することを確かめます

• 結果が正しく表示されたら、トリガーまたはスケジュールをオンにします

少人数でテストする

• エージェントを数人のチームメイトと共有してフィードバックを収集します

• 早期のフィードバックを活用し、より広範囲に展開する前に問題を把握します

反復を想定する

• ほとんどのエージェントは、正しく動作させるために何度かテストを実行する必要があります

• 指示は意図した内容ではなく、実際に表示される出力に基づいて調整します

まずアクティビティログを確認する

• 時計アイコンをクリックし、実行のトリガーを確認します

• エージェントが行ったことと、どこで失敗した可能性があるかを確認します

• ログを使って問題を診断し、アクセスを展開する前にエージェントが期待どおりに動作していることを確認します

一般的な修正点を把握する

• 「出力が正しくありません」は通常、指示をより具体的にする必要があることを意味します

• 「データがありません」は多くの場合、エージェントが追加のページまたはデータベースにアクセスする必要があることを意味します

  ツールとアクセス

• 「実行に失敗」は通常、権限のギャップや指示が不明確であることを示しています

適切に設計されたエージェントは実行がより速くなり、不要な作業を回避します。効率に影響する3つの要因：

• エージェントの実行頻度

• 読み取るコンテンツの量

• タスクを完了するために必要なステップ数

デフォルトでは、エージェントのAIモデルは自動に設定されています。これにより、Notionは各タスクに最適なモデルを選択できます。この設定はほとんどのエージェントでうまく機能しますが、いつでも特定のモデルを選択できます。

パフォーマンスを向上させる最も簡単な方法は、不要な実行を制限することです。エージェントがアクションを取る可能性が高い場合にのみ実行されるようにトリガーを設計します。

小規模から始めて、徐々に拡大していく

• 毎日ではなく、週に1回の実行から始める

• 1つのチャンネルまたはワークフローを使ってから、さらに展開する

• 結果が信頼できるようになったら頻度を上げる

エージェントが必要なときだけ実行されるように、高信号トリガーを使う

• Slackの場合：すべてのメッセージではなく、@メンションや特定の絵文字リアクションをトリガーにする

• Notionの場合：すべてのデータベース更新ではなく、特定のプロパティ変更時にトリガーを実行する

• Notionメールの場合：すべてのメッセージではなく、フィルタリングされたメールセットでトリガーする

「アクション不要」の実行が発生する可能性がある

• これは、エージェントが何も対応することがないと判断した場合に発生します

• これは正常で効率的な動作です。エージェントは終了前にトリガーと指示のみを確認します

エージェントが読み取るコンテンツが多いほど、実行ごとに必要な作業が増えます。スコープを狭く設定しましょう。

• エージェントを可能な限り最小のスコープに向けます。理想的には、エージェントが必要なときにのみ読み込めるサブページにリンクする単一ページまたは数ページにまとめます。

• どのデータベースやページを信頼できる情報源として使うべきかがわかっている場合は、エージェントに広範囲の検索をさせることは避けましょう。

実行中にステップが追加されるたびに作業が増えます。特に、カスタムエージェントが複数の検索を実行する場合は顕著です。

• エージェントがより少ないステップで完了できるよう、「完了」の定義を明確にしてください。

• エージェントが複数のツールを同時に呼び出す方が効率的です。可能な限り、指示の中で並列ツールを使うよう促しましょう。

  • 同時実行が可能：「プロジェクトデータベース、エンジニアリングSlackチャンネル、最新のスプリントノートページを同時に読み取ってください」これら3つのソースは独立しているため、エージェントは1つずつではなく、すべてを同時に読み取ります。

  • 順番に実行する必要がある場合：「レポートデータベースにサマリーページを作成し、Slackの#team-updatesにリンクを投稿してください」エージェントはリンクを投稿する前にページのURLを取得する必要があるため、これらのステップは順番に実行されます。

エージェントが頻繁に複数のフォローアップの質問をしたり、同じアクションを再試行したり、同じページを再確認したり、予測可能な方法でエラーが発生したりする場合は、指示または設定を改善してください。

• 権限の問題（Slackでの返信権限がない、URLが信頼できないなど）によりエラーが頻発する場合は、ツールとアクセスでエージェントのアクセス権を調整するか、指示の中でエージェントにそれらのアクションを避けるよう伝えてください。