建立你的第一個 Agent

本篇帶你從零開始建立一個 Notion Custom Agent，了解四大核心設定項，讓你的第一個 Agent 快速跑起來。

前提條件

使用 Custom Agent 功能需要訂閱 Notion 商業版（Business）會員。如果你目前使用的是免費版或個人版（Plus），需要先升級到商業版才能看到 Agent 建立入口。

建立步驟

進入 Notion 後，點擊左上角的「新建代理」按鈕，即可打開 Agent 設定介面。

點擊後會彈出一個設定面板，裡面包含了 Agent 的四大核心設定項。

四大設定項

觸發器（Trigger）

觸發器決定 Agent 什麼時候啟動工作，相當於它的「上班時間」。

你可以設定 Agent 在特定條件下自動運行，比如當資料庫中新增了一筆記錄、某個屬性發生變化，或者按照固定的時間間隔定時執行。

如果不設定觸發器，Agent 只能手動運行。

指令（Instruction）

指令是 Agent 的「工作內容手冊」，定義了它要做什麼、怎麼做。

一份好的指令應該包含：你希望 Agent 完成什麼任務、處理資料的規則和標準、輸出的格式要求等。指令寫得越清晰具體，Agent 的表現就越穩定可靠。

模型（Model）

模型是 Agent 的「腦子」，決定了它的理解能力和推理水準。

Notion 提供了多種模型可選。一般來說，越強大的模型處理複雜任務的效果越好，但每次運行消耗的 Token 也更多，意味著成本更高。對於簡單的分類、整理任務，用基礎模型就夠了；涉及複雜判斷和內容生成的任務，建議選擇更強的模型。

工具與權限（Tools & Access）

工具與權限相當於給 Agent 配備的「電腦和門禁卡」，決定了它能操作哪些資源、使用哪些能力。

你可以授權 Agent 讀寫特定的資料庫和頁面，也可以為它開啟網頁搜尋、發送郵件等內建工具。權限設定遵循最小權限原則：只給 Agent 完成任務所必需的權限，避免過度授權帶來的風險。

活動範圍

Custom Agent 的能力不限於 Notion 內部。透過 MCP 協定和 Worker，Agent 可以連接外部服務、呼叫第三方 API，實現跨平台的自動化工作流。

比如，你可以讓 Agent 自動將 Notion 資料庫中的內容同步到其他平台，或者從外部資料來源拉取資訊並寫入 Notion。

Quick Tips

第一版指令別追求完美。先用簡單的指令讓 Agent 跑起來，觀察它的實際表現，然後根據結果逐步調整和優化。迭代比一步到位更高效，也更容易發現問題。