使用 Workers 執行自訂程式碼（測試版）

Notion Workers 是我們 開發人員平台 的一部分。它們在 Notion 的基礎架構上執行自訂程式碼，以支援：

• 資料庫同步

• 自訂代理程式工具

• Webhook 觸發條件

• Workers 僅適用於商業版和企業版。

• 預設情況下，Workers 已為工作空間啟用（僅限工作空間擁有者）。

• 工作空間擁有者可以：

  • 僅限工作空間擁有者建立 Worker。

  • 允許特定成員或群組建立 Workers。

  • 為工作空間關閉 Workers。

• 如果您嘗試部署或管理 Worker，通常會遵循我們的 開發人員文件 並使用 Notion CLI。

• 您可以開啟開發人員模式以在 Notion 中檢視 Workers、讀取記錄，以及關閉或刪除 Workers。若要部署 Worker 或變更其程式碼或設定，請使用 Notion CLI 或您團隊的程式設計工具。深入了解 開發人員模式 →

若要深入了解 Workers 的價格，請參閱 這篇文章。

同步資料庫（由 Workers 驅動）可將外部工具的資訊帶入 Notion 資料庫，並自動保持更新。設定完成後，同步資料庫會自行保持最新狀態，因此您的團隊和代理程式無需任何人手動在工具之間複製貼上，即可隨時查看最新資料。

常見範例：

• 將 Zendesk 支援票證同步至分類資料庫。

• 將 Salesforce 帳號同步至銷售管道追蹤器。

• 從內部工具或資料庫同步資料。

一旦上線，同步資料庫就會像 Notion 中的任何其他資料庫一樣運作。存取權限由您的標準 Notion 共用權限控管。

代理程式工具（由 Workers 驅動）能擴充自訂代理程式的功能，使其超越 Notion 內建動作與 MCP 的限制，並具備針對您團隊工作方式量身打造的能力。

常見範例：

• 查詢資料倉儲。

• 從 Notion 文件產生資產。

• 在其他未原生支援或無法透過 MCP 使用的應用程式中採取行動。

Webhook 觸發條件（由 Workers 驅動）讓其他工具中的事件能啟動 Notion 或任何其他連接系統中的工作流程。

常見範例：

• 在合併提取要求時關閉任務。

• 在訂閱變更時更新 CRM 記錄。

• 在簽署報價時建立入職文件。

一旦設定完成，工作流程會在每次事件發生時自動執行，因此您的團隊不必手動在工具之間移動資訊。

透過 開發者模式，您可以從側邊欄的開發者區段開啟 Workers。使用此瀏覽模式進行快速檢查與基本動作。在 Notion 中，您可以：

• 在一個清單中查看所有 Workers。

• 開啟 Worker 並查看「概覽」、「日誌」、「環境變數」和「設定」。

• 讀取 Worker 日誌。

• 關閉或刪除 Worker。

若要部署 Worker 或變更其程式碼或設定，請使用 Notion CLI 或您團隊的程式碼編寫工具。

預設情況下，只有建立 Worker 的人員可以修改它或將其新增為新連接。與團隊成員分享 Worker，讓他們能將其連接到自訂代理程式或協助管理。

深入了解如何分享 Worker →

請依序嘗試下列步驟：

1. 確保您的工作空間符合資格，且工作空間擁有者已啟用 Workers。Workers 適用於商業版與企業版，且需要由工作空間管理員啟用。

2. 確認您使用的是預期的設定路徑。對於大多數設定，您將會使用 Notion CLI 加上 開發者文件。

3. 如果您的 Worker 部署失敗，請接著檢查權限。即使您可以查看該工作空間中的頁面，您可能仍沒有部署到該工作空間的存取權限。

4. 如果您的 Worker 有執行但未在 Notion 中進行任何變更，請先手動測試該動作。如果您無法在 Notion 中進行相同的變更，通常是權限或工作空間設定的問題。

5. 如果成本看起來比預期高，請降低執行頻率。執行次數較多的 Workers 成本會較高。請從較慢的排程開始，確認運作正常後再增加頻率。

6. 還是卡住了嗎？請依照 開發人員文件中針對該特定錯誤訊息的說明操作。那裡會有最準確的修正方式。