Notion’s Developer Platform

Notion’s Developer Platform 是什麼？

Notion’s Developer Platform 是一組開發者功能，用於以 Notion 作為共享工作空間進行建置—將外部資料同步到 Notion、建立 Notion Agents 可使用的自訂工具，以及編排多步驟代理工作流程。

其核心目的是讓您將外部系統連接到 Notion（例如，從其他來源保持 Notion Database 更新），並以專屬動作和工具介面擴展 Notion Agents。

使用 Workers 持續將外部記錄 upsert 到 Notion Database，採用宣告式結構描述和持久游標，讓更新可在多次執行間繼續進行。
外部資料集的排程同步 到 Notion（例如，在範例中定義如 5m 的同步排程）。
Notion Agents 的自訂代理工具，可產生輸出（例如資產）並與外部 API 或即時資料互動。
結構化工具介面，定義工具的輸入結構描述（例如，用於建立簡報的 pageId 字串，或執行資料倉儲查詢的 SQL query 字串）。
Webhook 驅動的工作流程編排，監聽來自其他應用程式的輸入 webhook，並使用 Notion Agents、頁面、資料庫及外部 API 呼叫觸發 Notion 工作流程。

建立或選定 Notion Database，並定義該資料庫與外部資料欄位之間的結構描述對應。
建置 Worker 來同步資料：設定受控資料庫連線、提供初始結構描述/主鍵，並撰寫同步函式來傳回記錄變更（例如，將來源欄位對應到 Notion 屬性）。
設定同步排程 和穩定識別碼（主鍵），以便記錄進行 upsert 而非重複。
選擇性新增自訂工具 給您的 Notion Agents，透過註冊工具名稱、描述、輸入結構描述及執行處理常式（例如，從 Notion 頁面產生 .pptx 資產並上傳回頁面）。
若需事件驅動自動化，則設定 webhook 監聽器來觸發使用代理呼叫外部 API 的 Notion 工作流程。

將支援票據匯入 Notion：使用 Worker 持續將外部客服系統的票據同步到 Notion Database，按票據 ID upsert，並對應主旨、CSAT 和標籤等欄位。
從 Notion 內容自動產生資產：建立自訂工具（例如 createPresentation），將 Notion 頁面讀取為 markdown，將標題轉換為投影片，上傳產生的 .pptx 並附加到頁面。
代理工具查詢資料倉儲：定義工具（例如 queryRevenue），接受 SQL 查詢字串，對資料倉儲表格執行查詢，並將結果傳回代理工作流程。
外部事件觸發的動作工作流程：建置 webhook 驅動的工作流程，監聽任何應用程式的イベント，然後使用 Notion Agents 搭配頁面/資料庫及外部 API 呼叫執行 Notion 工作流程。
代理工具控制的瀏覽器應用程式動作：實作代理工具，使用瀏覽器自動化提供者執行外部應用程式的多步驟任務（範例情境：列出儲存餐點、確認訂單並檢查配送狀態）。

是。範例描述使用持久游標的 Workers，持續將外部記錄 upsert 到 Notion Database，以支援更新繼續進行。

提供的範例包括從 Notion 頁面內容產生 PowerPoint（.pptx）並上傳回頁面。

是。一個範例工具對 deals 資料倉儲表格執行 SQL 查詢，另一個範例描述透過瀏覽器自動化使用外部應用程式動作。

頁面描述監聽來自任何應用程式的輸入 webhook，然後執行使用 Notion Agents、頁面、資料庫及外部 API 呼叫的 Notion 工作流程。

在範例中，您定義具結構描述和主鍵屬性的受控資料庫連線，然後提供將外部記錄對應到 Notion 屬性作為 upsert 的同步函式。

通用 ETL/ELT 工具（僅限資料同步）：如果您的主要目標是將資料移入並轉換至資料庫，ETL 工具可處理定期擷取，而 Notion Developer Platform 也涵蓋代理工具和工作流程編排。
工作流程自動化平台（用於觸發與編排）：此類工具可協調跨應用程式的 webhook 和動作，但可能無法提供與 Notion Agents 在 Notion 頁面和資料庫上運作相同的緊密整合。
具外部整合的代理工具框架（用於自訂工具呼叫）：如果您已在建置代理系統，可使用工具框架呼叫 API 並產生資產；Notion 的平台特別針對 Notion 工作區周邊的代理互動和資料同步。