指令編寫指南

指令是 Custom Agent 的「工作手冊」，直接決定了 Agent 的執行品質。一份清晰的指令能讓 Agent 穩定輸出你想要的結果，而含糊的指令只會讓它亂來。

指令的基本結構

一份好的 Agent 指令應該包含四個部分：

明確任務目標 — 告訴 Agent 要做什麼。不要籠統地說「幫我處理一下」，而是具體說明「讀取頁面內容，在摘要欄位寫入 3 句話的總結」。

定義輸入來源 — 從哪個資料庫、哪些欄位讀取資訊。Agent 不會自動知道該看哪裡，你需要明確指定。

規定輸出格式 — 結果寫到哪裡、用什麼格式。例如寫入哪個屬性、用列表還是段落、字數限制等。

設定執行規則 — 邊界條件和異常處理。例如某個欄位為空時怎麼辦、遇到不確定的情況是跳過還是標記。

範例

以任務跟進 Agent 為例：讀取頁面所有內容（標題、正文、狀態、排期、關聯筆記等），綜合評估後在「下一步做什麼」欄位寫入 3 條可執行的行動建議。

子頁面引用技巧

當指令變得很長、涉及多個場景時，可以用 @ 引用子頁面來組織內容。

這樣做的好處是：Agent 只在命中對應路由時才載入子頁面內容，不會每次都把所有指令塞進上下文。既省 Credits，也減少無關資訊的干擾，讓 Agent 更專注於當前任務。

記憶頁面模式

Agent 每次執行都是獨立的，預設不記得上一次做了什麼。如果你需要 Agent 具備「記憶力」，可以給它建立一個專用的記憶頁面。

具體做法：在指令中告訴 Agent，每次執行前先讀一遍記憶頁面的內容，執行完成後把關鍵資訊寫回這個頁面。這相當於拿 Notion 頁面充當 Agent 的外部記憶。

記憶頁面的內容不用好看，真實準確就行。它是給 Agent 看的，不是給人看的。

迭代優化原則

寫 Agent 指令不需要追求一步到位，迭代才是正確的方式：

先跑起來 — 第一版指令只寫最核心的步驟，讓 Agent 先動起來，看看它大方向對不對。

逐步修正 — 跑完看哪裡不對，針對性地補充邊界條件和細節要求。每次只改一個地方，方便判斷效果。

定期複盤 — 隔一段時間回頭看看 Agent 的執行結果，驗證它是否還在按預期工作。業務場景會變化，指令也需要跟著調整。

果斷刪除 — 如果一個 Agent 跑了一段時間後你覺得可有可無，果斷刪掉。不精準的推送只會製造噪音，反而增加你的資訊處理負擔。