ワーカーでカスタムコードを実行する（ベータ版）

NotionワーカーはNotionの開発者プラットフォームの一部です。ワーカーはNotionのインフラストラクチャ上でカスタムコードを実行し、以下を実現します。

• データベース同期

• カスタムエージェント用ツール

• Webhookトリガー

• ワーカーは、ビジネスプランとエンタープライズプランで利用できます。

• ワークスペースオーナーが、ワークスペースでワーカーを有効にする必要があります。

• ワーカーを導入または管理する場合、通常は開発者向けドキュメントに従い、Notion CLIを使用します。

ワーカーの料金設定について詳しくは、こちらの記事をお読みください。

データベース同期機能（ワーカーを活用）は、外部ツールからの情報をNotionデータベースに取り込み、自動で最新の状態に保ちます。一度設定すれば、同期データベースは自動で最新の状態を維持するため、チームやエージェントは、ツール間でコピーや貼り付けを行うことなく、常に最新のデータを確認できます。

一般的な例をいくつかご紹介します。

• Zendeskのサポートチケットをトリアージデータベースに同期する。

• Salesforceアカウントをパイプライン管理ツールに同期する。

• 内部ツールまたはデータベースからデータを同期する。

一度有効にすると、同期データベースはNotionの他のデータベースと同じように機能します。アクセスは、標準のNotion共有権限によって管理されます。

エージェントツール（ワーカーを活用）は、Notionの組み込みアクションやMCPを超えて、カスタムエージェントが実行できることを拡張し、チームの働き方に合わせて機能をカスタマイズできます。

一般的な例をいくつかご紹介します。

• データ倉庫に対してクエリを実行する。

• Notionドキュメントからアセットを生成する。

• ネイティブに対応されない、またはMCP経由で利用できない別のアプリでアクションを実行する。

Webhookトリガー（ワーカーを活用）を使用すると、別のツールでのイベントによって、Notionまたはその他の接続されているシステム内のワークフローを開始できます。

一般的な例をいくつかご紹介します。

• プルリクエストがマージされたときにタスクを完了にする。

• サブスクリプションの変更に合わせたCRMレコードを更新する。

• 内定承諾時のオンボーディングドキュメントを作成する。

一度設定すれば、イベントが発生するたびにワークフローが自動的に実行されるため、チームがツール間で手動で情報を移動する必要がなくなります。

次の手順を順番に試してみてください。

1. ご利用のワークスペースが対象であり、ワークスペースオーナーがワーカーを有効にしていることを確認します。ワーカーは、ビジネスプランとエンタープライズプランで利用でき、ワークスペースの管理者による有効化が必要です。

2. 意図したセットアップ手順を使用していることを確認します。ほとんどの設定では、Notion CLIと開発者向けドキュメントを使用します。

3. ワーカーを導入できない場合は、次に権限を確認します。そのワークスペース内のページを表示できる場合でも、そのワークスペースに導入するためのアクセス権がない可能性があります。

4. ワーカーが実行されてもNotion内で何も変更されない場合は、まず手動でアクションをテストします。Notionで同じ変更を加えることができない場合は、通常、権限またはワークスペースの設定に問題があります。

5. コストが予想を上回っているように見える場合は、実行頻度を下げてください。実行頻度が高いワーカーのコストは高くなります。まずは実行頻度の低いスケジュールから始めて、正常に機能していることを確認した後に頻度を上げるようにしてください。

6. 問題が解決しない場合具体的なエラーメッセージについては、開発者向けドキュメントに従ってください。最も正確な修正方法が記載されています。

ワーカーとカスタムエージェントの違いは何ですか？

ワーカーとカスタムエージェントは異なる問題を解決しますが、連携することもできます。

• ワーカー：Notionのインフラストラクチャ上でカスタムコードを実行します。開発者は、オートメーション、スケジュールされた同期、カスタムインテグレーションなどの作業にワーカーを使用します。

• カスタムエージェント：チームの反復作業を自動的に処理します。トリガーを設定すれば、ワークスペースをコンテキストとして活用しながら、バックグラウンドで実行されます。

一部の設定では、ワーカーがカスタムエージェントが使用できる独自のツールを提供できる場合があります。たとえば、ワーカーが別のシステムからデータを取得し、エージェントがそのデータを使用して応答したり、アクションを実行したりできます。

ワーカーはオートメーションと同じですか？

厳密には違います。オートメーションはNotionに組み込まれており、誰でも設定できるように設計されています。ワーカーは、カスタムコードを実行したい開発者向けです。コードが不要な場合は、まずオートメーションを使用してください。