ワーカーでカスタムコードを実行する（ベータ版）
Workersとは何か、そしてその用途について説明します。
よくあるご質問（FAQ）に移動Notion Workersは、Developer Platformの一部です。Notionのインフラストラクチャ上でカスタムコードを実行し、以下の機能を強化します。
データベース同期
カスタムエージェント用ツール
Webhookトリガー
技術的なセットアップについては、開発者向けドキュメントをご覧ください。
料金設定について詳しくは、こちらの記事をお読みください。
ワーカーは、ビジネスプランとエンタープライズプランで利用できます。
デフォルトでは、Workersはワークスペースに対してオンになっています（オーナーのみ）。
ワークスペースオーナーは以下の操作が可能です。
Workersの作成をオーナーのみに制限する。
特定のメンバーやグループにWorkersの作成を許可する。
ワークスペースのWorkersをオフにする。
Workersを導入または管理する場合、通常はdeveloper documentationに従い、Notion CLIを使用します。
開発者モードをオンにすると、NotionでWorkersを表示したり、ログを読み取ったり、Workersをオフにしたり削除したりできます。Workersを導入したり、コードや設定を変更したりするには、Notion CLIまたはチームのコーディングツールを使用してください。開発者モードについて詳しくはこちら →
ワーカーの料金設定について詳しくは、こちらの記事をお読みください。
同期データベース（Workersによる機能）は、外部ツールの情報をNotionデータベースに取り込み、自動的に最新の状態に保ちます。一度設定すれば、同期データベースは自動的に最新の状態に更新されるため、チームやエージェントはツール間でコピー＆ペーストを行うことなく、常に最新のデータを確認できます。
一般的な例をいくつかご紹介します。
Zendeskのサポートチケットをトリアージデータベースに同期する。
Salesforceアカウントをパイプライン管理ツールに同期する。
内部ツールまたはデータベースからデータを同期する。
一度公開されると、同期データベースはNotion内の他のデータベースと同様に動作します。アクセスは、Notionの標準的な共有権限によって管理されます。
エージェントツール（ワーカーを活用）は、Notionの組み込みアクションやMCPを超えて、カスタムエージェントが実行できることを拡張し、チームの働き方に合わせて機能をカスタマイズできます。
一般的な例をいくつかご紹介します。
データ倉庫に対してクエリを実行する。
Notionドキュメントからアセットを生成する。
ネイティブに対応されない、またはMCP経由で利用できない別のアプリでアクションを実行する。
Webhookトリガー（ワーカーを活用）を使用すると、別のツールでのイベントによって、Notionまたはその他の接続されているシステム内のワークフローを開始できます。
一般的な例をいくつかご紹介します。
プルリクエストがマージされたときにタスクを完了にする。
サブスクリプションの変更に合わせたCRMレコードを更新する。
内定承諾時のオンボーディングドキュメントを作成する。
一度設定すれば、イベントが発生するたびにワークフローが自動的に実行されるため、チームがツール間で手動で情報を移動する必要がなくなります。
開発者モードを使用すると、サイドバーの開発者セクションからWorkersを開くことができます。このビューは、簡単な確認や基本的なアクションを行う際に使用します。Notionでは、以下のアクションが可能です。
すべてのWorkersを1つのリストで確認する。
Workersを開き、Overview、Logs、Environment Variables、Settingsを表示する。
Workersのログを読み取る。
Workersをオフにする、または削除する。
Workersの導入や、コードや設定の変更を行うには、Notion CLIまたはチームのコーディングツールを使用してください。
デフォルトでは、Workersを作成した本人のみが、そのWorkersの編集や新しい接続としての追加を行えます。Workersをチームメイトと共有することで、カスタムエージェントに接続したり、管理をサポートしたりできるようになります。
次の手順を順番に試してみてください。
ワークスペースが利用資格を満たしていること、およびワークスペースオーナーがWorkersを有効にしていることを確認してください。Workersはビジネスプランおよびエンタープライズプランで利用可能であり、ワークスペース管理者が有効にする必要があります。
意図したセットアッププログラムを使用していることを確認してください。ほとんどのセットアップでは、Notion CLIと開発者向けドキュメントを使用します。
Workersのデプロイが失敗した場合は、次に権限／権限管理を確認してください。そのワークスペース内のページが閲覧可能でも、デプロイ権限がない可能性があります。
Workersは実行されているがNotion上で何も変更されない場合は、まず手動でアクションをテストしてください。Notion上で同じ変更を行えない場合は、通常、権限／権限管理またはワークスペース設定の問題です。
コストが予想より高い場合は、実行頻度を下げてください。実行頻度が高いWorkersほどコストがかかります。最初は遅いスケジュールで開始し、動作が安定していることを確認してから頻度を上げてください。
まだ解決しませんか？開発者向けドキュメントをフォローして、特定のエラーメッセージを確認してください。そこに最も正確な修正方法が記載されています。
よくあるご質問（FAQ）
ワーカーとカスタムエージェントの違いは何ですか？
ワーカーとカスタムエージェントの違いは何ですか？
ワーカーとカスタムエージェントは異なる問題を解決しますが、連携することもできます。
Workers: Notionのインフラストラクチャ上でカスタムコードを実行します。開発者は、自動化、スケジュールされた同期、カスタム統合などのためにWorkersを使用します。
カスタムエージェント: チームの反復的な作業を自動的に処理します。トリガーを設定すると、ワークスペースをコンテキストとしてバックグラウンドで実行されます。
一部の設定では、Workersがカスタムエージェントで使用できる独自のツールを強化できます。例えば、Workersが別のシステムからデータを取得し、エージェントがそのデータを使用して応答したりアクションを実行したりできます。
ワーカーはオートメーションと同じですか？
ワーカーはオートメーションと同じですか？
そうとは限りません。オートメーションはNotionに組み込まれており、誰でも設定できるように設計されています。Workersは、カスタムコードを実行したい開発者向けです。コードが不要な場合は、オートメーションから始めてください。
ワーカーは自分のサーバー上で実行されますか？
ワーカーは自分のサーバー上で実行されますか？
いいえ。ワーカーはNotionのサーバー上で実行されるため、インフラストラクチャを設定したり管理したりする必要はありません。
