自訂代理程式

在此說明文件中

透過自訂代理程式,您可以建立已共享的工作流程,為您的團隊自動化重複性工作 — 完全依您的需求,在幕後執行。

跳至常見問題

自訂代理程式可為您的整個團隊自動化重複性的手動工作流程。它們會根據設定的觸發條件,使用您現有的文件與資料庫作為背景資訊,在背景自動執行。

設定一次 — 為每週報告或分類回饋等重複性任務建立工作流程 — 它就會成為整個團隊依賴的共享資源。

什麼是自訂代理程式?

自訂代理程式存在於 Notion 內部,並根據您的指令執行。一旦設定完成,它們可以:

  • 讀取 Notion 頁面、資料庫以及特定已連結應用程式的內容。

  • 根據重複性觸發條件與工作區事件執行。

  • 採取動作,例如發佈報告、回報錯誤、更新記錄或傳送訊息。

與 Notion Agent 不同,自訂代理程式旨在根據觸發條件與排程在背景自動執行。

取得個人化的導覽

透過個人化且互動式的導覽,引導您完成每個步驟,建立您的第一個自訂代理程式。

使用您現有的文件與資料庫作為背景資訊

自訂代理程式直接內建於 Notion 中。代理程式會使用您現有的文件與資料庫作為背景資訊,並連結 Slack,進而提升生產力。透過自訂代理程式,您可以:

  • 在 Notion 頁面、資料庫屬性與留言中 @提及 代理程式。

  • 將它們附加至資料庫事件(例如,當頁面建立或更新時)。

  • 讓它們根據您設定的觸發條件,監控您的工作區與已連結的工具。

透過觸發條件自動處理重複性工作

使用自訂代理程式的觸發條件,無需每次手動啟動即可執行。設定一次觸發條件,工作就會在幕後持續進行。

  • 按排程執行(每日、每週、每月等)。

  • 對 Notion 與 Slack 中的事件做出反應。

  • 發佈後持續在幕後執行。

這能解鎖自動化工作流程,例如定期報告、分類佇列和知識維護,協助您節省時間。

設計上安全且透明

代理程式僅會在您明確授予存取權的頁面、資料庫和外部應用程式上執行動作。預設情況下,它們絕不會擁有完整的工作區存取權,從而降低風險。

  • 控制誰可以編輯、執行或與每個代理程式互動。

  • 檢視活動記錄以查看代理程式執行了什麼動作以及執行時間。

  • 使用版本記錄來檢閱或還原過去的設定。

  • 保持執行過程可檢閱且可還原,以便您安全地進行迭代。

稽核記錄檔可見性 (企業版)

自訂代理程式的關鍵設定和存取權變更(例如指示更新、權限變更和整合新增)都會記錄在Notion 稽核記錄檔中。這有助於企業版管理員追蹤代理程式的變更,以進行安全性和合規性評論。

  • 您必須使用 Notion 的商業版或企業版方案。進一步了解自訂代理程式的定價

  • 使用桌面版或網頁版來建立、編輯、查看或與自訂代理程式互動。

您可以從多個位置建立自訂代理程式。主要入口點是側邊欄中的代理程式區段。

  1. 前往側邊欄中的代理程式區段,並選取+以建立新的自訂代理程式。

2. 選取您要如何開始:

  • 使用 AI 對話建立

    • 在對話中,使用自然語言描述您希望代理程式執行的工作。

    • 檢閱 Notion AI 產生的草稿指示、觸發條件和存取權限,並進行迭代。

    • 儲存。

  • 從範本建立

    • 選取範本。

    • 檢閱 Notion AI 產生的草稿指令、觸發條件和存取權限,並進行迭代。

    • 儲存。

  • 從頭建立

    • 選取 建立空白

    • 從空白的指示欄位開始,或與您進行對話。

    • 手動撰寫您的指示,並遵循清晰、具體指示的最佳實踐。定義代理程式應該做什麼、應該如何表現,以及應該處理什麼工作。

    • 設定觸發條件、存取權限以及您的 AI 模型,直到符合您的工作流程為止。

    • 儲存。

若要為您的代理程式建立清晰的指示,請從您想要的工作與成果開始。接著新增具體的步驟、輸入與輸出。若有範例,請務必使用。

提示:使用我們的 自訂代理程式範本 作為起點。

觸發條件決定了您的代理程式何時執行。您可以為單一代理程式組合多種觸發條件類型。您也可以使用篩選器,協助您的代理程式僅針對您關心的頁面或訊息執行,或僅在符合您設定的特定條件(例如:特定狀態或關鍵字)時執行。

使用週期性、基於時間的排程來自動化工作流程

使用週期性排程來按節奏執行代理程式。

  1. 開啟您自訂代理程式的 設定

  2. 前往 觸發條件 區段。

  3. 新增 週期性 觸發條件。

  4. 選擇您希望代理程式執行的時間:

    • 選取頻率(每天、每週、每月或每年)。

    • 設定特定時間,包含時區(例如:「每天午夜 PST」)。

  5. 檢閱下一次排程執行時間,以確認排程正確無誤。

  6. 儲存您的觸發條件。

使用 Notion 觸發條件

Notion 觸發條件會根據您工作空間中的事件來執行您的代理程式。您可以在下列情況觸發代理程式:

  • 在此位置的頁面有新留言時。

  • 頁面已新增至資料庫。

  • 資料庫中的屬性已更新。

  • 頁面已從資料庫移除。

部分 Notion 觸發條件允許您新增篩選條件,例如比對特定屬性值,或將執行限制在特定資料庫瀏覽模式中的頁面。

若要新增 Notion 觸發條件:

  1. 開啟自訂代理程式的 設定 並選取 觸發條件

  2. 選擇 Notion 觸發條件類型。

  3. 指定:

    • 要監控的頁面或資料庫。

    • 事件(例如「在資料庫中建立頁面」)。

    • 選用的篩選條件或條件(例如特定的狀態值或資料庫瀏覽模式)。

  4. 儲存。

使用 Slack 觸發條件

Slack 觸發條件讓代理程式可以監控公開與私人 Slack 頻道中的事件。

設定需求

在設定 Slack 觸發條件之前,Slack 工作區管理員必須先 將 Slack 連線至 Notion 工作區。這會授予對所有公開頻道的存取權,並決定 Notion AI 是否能存取私人頻道。若要使用私人頻道,您還必須授權您的 Slack 帳號。

自訂代理程式可以監控:

  • 發佈至頻道的訊息。

  • 表情符號回應已新增至訊息。

  • 訊息中提及自訂代理程式。

注意:若要透過在 Slack 中使用 @提及來觸發代理程式,您的 Slack 工作區管理員必須先允許所有成員建立使用者群組。啟用此設定後,任何人只要在相關的 Slack 頻道中提及代理程式名稱,即可觸發該代理程式。

設定上述任何觸發條件時,您可以選擇包含對話串回覆,讓代理程式回應對話串內的訊息,而不僅僅是頂層訊息。

您可以透過指定要觸發的關鍵字或片語,來減少高流量頻道中的雜訊。

若要新增 Slack 觸發條件:

  1. 如果尚未連線,請在設定期間將 Slack 連線至您的代理程式。

  2. 觸發條件 中,新增 Slack 觸發條件。

  3. 選取:

    • 事件類型。

    • 要監控的頻道。

    • 選用篩選器(例如,僅在訊息包含特定關鍵字或片語時才觸發)。

  4. 儲存。

每當自訂代理程式在 Slack 中被觸發時,它可以顯示輸入指示器(「Working on it…」)以示正在處理請求,但這不代表代理程式一定會回覆。您可以隨時前往觸發設定將其關閉。

若要關閉輸入指示器:

  1. 前往您的自訂代理程式。

  2. 觸發條件 中,選取 Slack 觸發條件。

  3. 選取更多設定,然後取消勾選 在 Slack 中顯示輸入指示器

注意:

  • 如果您想在 Slack 中以名稱 @提及自訂代理程式,您的 Slack 工作空間擁有者必須允許成員建立群組。這是 Slack 的要求(而非 Notion 設定)。

  • 不支援 Slack 中儲存或「稍後閱讀」的訊息。

自訂代理程式僅會使用您明確授權存取的內容來執行工作。您可以在每個代理程式的存取設定中進行配置。

授權自訂代理程式存取您工作區中的內容

若要控制代理程式在 Notion 中可見的內容:

  1. 開啟自訂代理程式的 設定

  2. 前往 工具與存取權 區段。

  3. 新增 Agent 應作為背景脈絡使用的特定頁面或資料庫:

    • 為目標工作流程新增重點頁面與資料庫(例如:「客戶服務單」、「錯誤」、「事件」)。

    • 若您希望涵蓋範圍廣泛,包含整個工作區的內容,請授予 與 Notion 中所有人共用的頁面 的存取權。

  4. 若您希望範圍較窄,請將存取權限制為「」或一小組頁面。

指示 中連結至 Notion 頁面並不會將其新增至已連接的 工具與存取權限

允許或封鎖網路存取權

代理程式可在需要時選擇性地瀏覽網路。當您的工作流程依賴外部資訊時,請使用網路存取權限。若工作流程僅限內部使用,或您希望對來源進行更嚴格的控管,請將其關閉。若要控制網路存取權限:

  1. 開啟代理程式的 設定

  2. 找到 網路存取權切換。

  3. 將網路存取權 開啟,讓代理程式能從網際網路擷取資訊。

  4. 將網路存取權 關閉,將代理程式限制為僅能存取 Notion 和已設定的應用程式。

授予自訂代理程式 Slack 存取權。

自訂代理程式可透過專屬整合讀取 Slack 並寫入內容。

在將 Slack 連線至自訂代理程式前,管理員必須先透過 Slack AI 連接器 將 Slack 工作空間連線至您的 Notion 工作空間。

連線後,自訂代理程式可以:

  • 讀取選取的公開與私人 Slack 頻道。

  • 僅在您選取的特定頻道中發布訊息、回覆與更新。

  • 對對話串做出反應,並將 Slack 中的資訊作為背景脈絡使用。

若要授予自訂代理程式 Slack 存取權:

  • 設定自訂代理程式時,請依照(文字)指令連線 Slack。

  • 請確保 Slack 帳號使用的電子郵件(地址)與您的 Notion 帳號相同。

  • 在 Slack 的授權流程中核准要求的範圍。

  • 選擇代理程式可以存取的頻道。

如果您的組織使用 Slack Enterprise Grid,您也可以連線至自訂代理程式。

自訂代理程式可以在不同的大型語言模型上執行。這讓您能夠平衡速度、成本與品質。如果您的工作流程有所變更,或發現有不同的效能需求,您可以隨時調整模型。

支援的模型包括 Claude Fable 5(僅限商業版與企業版)、Claude Sonnet 5、最新的 GPT 模型、Gemini 與 Grok。自動是建議的預設。

Claude Fable 5 最適合用於深入研究、複雜寫作以及涉及多個步驟的任務。在工作空間中的任何人使用之前,管理員必須先將其開啟。這是因為 Anthropic 處理此模型資料的方式與其他模型略有不同(請參閱下方)。如果您需要存取權限,請要求您的管理員在 設定Notion AI 中將其開啟。

關於資料處理的注意事項: 當您使用 Claude Fable 5 時,Anthropic 可能會儲存您的(文字)指令與回應一段時間,以確保模型安全且運作良好。Notion 中提供的其他 AI 模型並非以此方式運作。這就是為什麼您的管理員需要先審核並開啟它的原因。

了解如何在 Notion 額度儀表板 中追蹤使用量。

若要選擇模型:

  1. 開啟您代理程式的 設定

  2. 前往 模型 區段。

  3. 若您希望行為保持一致,請選取特定模型;或選擇「自動」,讓 Notion 針對每次請求選擇最佳模型。

  4. 儲存。

若要為您的工作空間啟用 Claude Fable 5(僅限管理員):

  1. 前往 設定Notion AI

  2. 找到 Claude Fable 5 並將其開啟。

Claude Fable 5 僅適用於商業版與企業版方案。一旦啟用,工作空間中的任何人皆可從 Notion 代理程式或自訂代理程式設定中的模型選擇器中選取它。

自訂代理程式在與工作空間中的其他人共用時,其運作方式與 Notion 頁面類似,但有一些差異。

與您的團隊分享代理程式

分享後,代理程式會出現在側邊欄的「代理程式」區段、搜尋結果中,以及任何列出或參照代理程式的工作空間中。

若要分享代理程式:

  1. 開啟自訂代理程式。

  2. 按一下分享

  3. 新增人員、群組或整個工作空間。

權限級別

代理程式使用簡化的權限級別:

  • 全部權限擁有代理程式全部權限的使用者可以設定指示、觸發條件、存取權限與模型,瀏覽並管理活動記錄檔,以及執行或與代理程式互動。

  • 可以編輯擁有代理程式可以編輯權限的使用者可以修改指示與設定,並評論活動。

  • 可以查看與互動擁有代理程式可以查看與互動權限的使用者可以執行代理程式、與其對話,並以唯讀模式瀏覽「設定」頁面(觸發條件、指示、工具與存取權限)。他們無法編輯或分享該代理程式。

即使沒有存取權限的使用者,仍可能觸發或與設定為回應 Slack 頻道中活動的代理程式互動。

自訂代理程式建立完成後,它會出現在側邊欄中。每個自訂代理程式頁面都有三個核心分頁。請搭配使用這些分頁來設計、測試並長期維護代理程式。

  1. 對話 該特定代理程式的私人或共享一對一對話區域。

    • 適用於測試新指示、要求代理程式執行一次性任務,以及反覆調整其行為。

  2. 活動 擁有全部權限的使用者可檢視的每次代理程式執行記錄檔。

    • 記錄檔包含觸發執行的原因、採取的動作,以及任何錯誤或失敗。

  3. 設定 代理程式的控制中心。

    • 「設定」窗格包含代理程式指示觸發條件、存取權限以及模型選取。

將設定視為一場對話。使用自訂代理程式 對話 來測試、偵錯並反覆調整您的指示。請代理程式執行一次性任務、提供錯誤相關背景資訊,並測試不同情境。

使用「設定」分頁來編輯代理程式

  1. 開啟代理程式頁面。

  2. 前往 設定 分頁。

  3. 更新 指示觸發條件、頁面存取權限、資料庫、外部工具或模型選取。

  4. 儲存並發布您的變更。

  5. 使用 對話 頁籤和 活動 頁籤,確認代理程式在編輯後能如預期般運作。

使用版本紀錄還原變更

若要還原自訂代理程式的先前版本:

  1. 開啟代理程式頁面。

  2. 存取 版本紀錄

  3. 檢閱過去的版本以查看:

    • 是誰進行了變更。

    • 變更的時間。

    • 每個版本變更的內容。

  4. 選取您想要還原的版本。

  5. 確認將代理程式還原至該版本。

建立副本自訂代理程式可讓您複製現有的代理程式,並針對類似的工作流程進行調整,無需從頭開始建立。

若要建立副本自訂代理程式:

  1. 打開您想要建立副本的自訂代理程式。

  2. 選取 ••• 並選擇 建立副本

副本的代理程式會以私人代理程式的形式開啟。您可以在共用或發布之前,先檢閱並更新其設定。

建立副本代理程式的必要條件

  • 擁有瀏覽模式及與原始代理程式互動的權限。

  • 在您的工作空間管理員控制項下建立自訂代理程式的權限。如果不確定,請諮詢您的工作空間管理員。

會轉移的內容

  • 名稱: 副本命名為 {Original agent name} (1)。您可以隨時重新命名。

  • AI 模型: 副本使用與原始代理程式相同的 AI 模型。

  • 說明: 已複製到新頁面。如果說明中的任何連結指向您無法存取的頁面,這些連結將顯示為無存取權標籤,且不會新增至副本的資源中。

  • 頁面與資料庫: 原始代理程式使用且您也有存取權的任何 Notion 內容都會轉移。您無法存取的內容將不會包含在內。

  • 觸發條件: 使用您有存取權之資源的觸發條件將會轉移。如果觸發條件依賴於您無法存取的項目(例如您未加入的 Slack 頻道),該觸發條件將不會包含在複本中。

複製後您需要設定的內容

  • 已連接的工具(例如 Slack): 複本不會繼承任何工具連接。您需要在新複本上重新連接 Slack 等工具。

  • Workers: 如果原始代理程式已設定 Workers,您需要重新設定。它們不會自動轉移。

  • 執行紀錄: 複製的代理程式將從零開始,不會包含原始代理程式先前的執行紀錄或活動。

  • 額度限制: 原始代理程式設定的任何額度限制都不會套用到複製的代理程式。

預設隱私設定

複製的代理程式預設為私人,僅您本人可見。準備好後,請從 共用 選單進行共用。

如果您擁有自訂代理程式的全部權限,您可以將其洞察對話和對話串匯出為 CSV 檔案,以便在 Notion 之外進行分析或報告。

若要匯出:

  1. 開啟自訂代理程式並前往 洞察 分頁。

  2. 選擇您要匯出的時間範圍。

  3. 將滑鼠游標懸停在匯出按鈕上 → 選擇 匯出為 CSV

CSV export

CSV 與 所有對話 頁面上的欄相符。匯出僅限於所選期間最多 300 則對話。

  • CSV 匯出功能僅適用於商業版和企業版。

  • 需要多個代理程式資料的工作空間管理員,必須在匯出前將自己個別新增至每個代理程式。


常見問題

這與右下角的 Notion 代理程式有何不同?

Notion Agent 可協助您:

  • 草擬、編輯及摘要內容。

  • 回答關於頁面與資料庫的問題。

  • 在您工作時執行一次性任務。

自訂代理程式:

  • 它們會遵循您定義的精確指示。

  • 它們可以透過觸發條件與排程在背景中自動執行。

  • 它們僅在您明確授權的頁面、資料庫與外部工具上運作。

Notion Agent 是隨需使用的,而自訂代理程式則是 自主的.

如果執行失敗,該如何進行偵錯?

若要對執行進行偵錯:

  1. 開啟代理程式頁面。

  2. 前往代理程式 設定 中的 活動 分頁,或從代理程式聊天檢視畫面前往。

  3. 在清單中找到失敗的執行項目。

  4. 開啟它以查看:

    • 是什麼觸發了該執行?

    • 代理程式在每個步驟的「思考」過程與執行動作。

    • 任何錯誤訊息或說明。

如果代理程式的行為不正確:

  • 調整其指示或觸發條件。

  • 使用更新後的設定重新執行。

  • 如果看起來有誤或有可疑之處,請點選「倒讚」並提供詳細說明(若有),以便團隊改進系統。

我需要連接哪個 Slack 應用程式?

若要將 Slack 與自訂代理程式搭配使用:

  1. 請確保 Slack 連接的電子郵件地址與您用於 Notion 的 相同電子郵件地址

  2. 在設定代理程式時,若系統提示,請連接 Slack 應用程式,即使您已在 Notion 的其他地方使用 Slack。

  3. 核准存取權限,並設定代理程式可以讀取或寫入的頻道。

代理程式在 Slack 中顯示「處理中...」,但從未回覆。為什麼?

「處理中...」的輸入指示器會在自訂代理程式觸發時立即出現。有時代理程式會決定不回覆(根據指示),或者在傳送訊息前逾時。如果發生這種情況,輸入指示器會自動消失。

如果您想避免這種情況,隨時可以在 Slack 觸發器的設定中關閉輸入指示器,或更新代理程式的指示,使其更有可能針對您關心的情況做出回應。

誰可以建立並查看自訂代理程式?

  • 自訂代理程式預設開放給 工作空間中的所有人 使用。

    • 企業版 方案管理員可以前往 設定 > Notion AI > 來限制存取權。

      代理程式 > 管理可以建立代理程式的人員

  • 針對每個代理程式:

    • 創作者可決定誰能存取它以及存取層級為何(全部權限可以編輯可互動)。

    • 在 Slack 中,頻道內的任何人都能看到該頻道代理程式所發佈的訊息。

    • 任何有權存取該代理程式的人都能看到其輸出內容,即使他們無法存取底層的 Slack 私人頻道亦然。

進一步了解自訂代理程式 共用與權限請點此 →

我該如何知道此代理程式將在哪裡執行?

設定代理程式時,請檢查:

  1. 觸發條件以查看:

    • 哪些排程為啟用狀態。

    • 監控了哪些 Notion 資料庫或頁面。

    • 連接了哪些 Slack 頻道或其他應用程式。

  2. 存取權 / 權限以查看:

    • 代理程式可以使用哪些頁面、資料庫和外部來源。

  3. 活動以查看:

    • 代理程式已在何處執行及其執行內容。

發佈後:

  • 使用 活動 頁籤和記錄來確認代理程式僅在預期的位置執行。

  • 定期執行審查,以確保行為符合您的工作流程。

為什麼我無法再存取某些模型(例如:Claude Fable 5)?

您的工作空間已達到公平使用限制。部分 AI 模型暫時無法用於 Notion Agent、自訂代理程式、圖片生成和頁面翻譯等功能。存取權限將在六小時後重置。

I embedded a Custom Agent in a page. Why can't my teammates chat with it?

Being able to see the page doesn't mean someone can use the agent on it. To chat with an embedded Custom Agent, a person needs access to the agent itself. Open the agent, select Share, and add them.

If you also want the agent to answer questions about the page it lives on, add that page under the agent's Tools and access settings.

還有其他問題嗎?歡迎傳送訊息詢問我們

給予回饋

這項資源有用嗎?