除錯與優化
學習如何除錯和持續優化 Notion Custom Agent,包括迭代開發流程、記憶頁面模式和常見問題排查。
除錯與優化
建立一個 Agent 可能十分鐘就搞定了,但真正費勁的是後面的養成期。這個過程很像帶一個新員工 — 入職第一天不能指望它什麼都做好。
迭代開發流程
- 先跑起來 — 第一版指令只寫最核心的步驟,不追求完美
- 觀察結果 — 看 Agent 的執行結果,記錄哪裡不符合預期
- 修正邊界 — 你總會漏掉一些沒想到的邊界情況,逐步補充
- 定期複盤 — 經常性地驗證 Agent 的執行結果,評估它的必要性
- 果斷清理 — 如果覺得某個 Agent 可有可無,就刪掉它。否則時間一長,推送通知太多,有用資訊和噪音就分不清了
記憶頁面模式
給 Agent 建立一個專用的記憶頁面:
- Agent 每次執行前先讀一遍,了解歷史上下文
- 執行完後把關鍵資訊寫回去
- 相當於用 Notion 頁面充當 Agent 的外部記憶
- 內容不用寫得好看,真實準確就行
透過一次次小調整,逐步把一個粗糙的 Agent 磨成真正靠譜的虛擬員工。

常見問題排查
Agent 沒有按預期觸發
- 檢查觸發器設定是否正確
- 確認頁面存取權限沒有遺失(權限偶爾會靜默失效)
- 查看 Agent 的執行日誌
Agent 執行結果不理想
- 檢查指令是否足夠清晰和具體
- 確認 Agent 能存取到所需的資料庫和頁面
- 考慮換用更高階的模型
- 檢查知識庫內容是否涵蓋了相關場景
Credits 消耗異常
- 查看是否有 Agent 被頻繁誤觸發
- 檢查指令是否載入了不必要的上下文
- 考慮使用路由模式減少無效觸發
權限靜默失效
- 表面上 Agent 正常掛著,實際已停擺
- 沒有錯誤提示,需要主動檢查執行日誌
- 解決方法:重新授權相關頁面的存取權限
最後更新於
Notion AI Hub