指令编写指南

指令是 Custom Agent 的「工作手册」，直接决定了 Agent 的执行质量。一份清晰的指令能让 Agent 稳定输出你想要的结果，而含糊的指令只会让它乱来。

指令的基本结构

一份好的 Agent 指令应该包含四个部分：

明确任务目标 — 告诉 Agent 要做什么。不要笼统地说「帮我处理一下」，而是具体说明「读取页面内容，在摘要字段写入 3 句话的总结」。

定义输入来源 — 从哪个数据库、哪些字段读取信息。Agent 不会自动知道该看哪里，你需要明确指定。

规定输出格式 — 结果写到哪里、用什么格式。比如写入哪个属性、用列表还是段落、字数限制等。

设定执行规则 — 边界条件和异常处理。比如某个字段为空时怎么办、遇到不确定的情况是跳过还是标记。

示例

以任务跟进 Agent 为例：读取页面所有内容（标题、正文、状态、排期、关联笔记等），综合评估后在「下一步做什么」字段写入 3 条可执行的行动建议。

子页面引用技巧

当指令变得很长、涉及多个场景时，可以用 @ 引用子页面来组织内容。

这样做的好处是：Agent 只在命中对应路由时才加载子页面内容，不会每次都把所有指令塞进上下文。既省 Credits，也减少无关信息的干扰，让 Agent 更专注于当前任务。

记忆页面模式

Agent 每次执行都是独立的，默认不记得上一次做了什么。如果你需要 Agent 具备「记忆力」，可以给它创建一个专用的记忆页面。

具体做法：在指令中告诉 Agent，每次执行前先读一遍记忆页面的内容，执行完成后把关键信息写回这个页面。这相当于拿 Notion 页面充当 Agent 的外部记忆。

记忆页面的内容不用好看，真实准确就行。它是给 Agent 看的，不是给人看的。

迭代优化原则

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

先跑起来 — 第一版指令只写最核心的步骤，让 Agent 先动起来，看看它大方向对不对。

逐步修正 — 跑完看哪里不对，针对性地补充边界条件和细节要求。每次只改一个地方，方便判断效果。

定期复盘 — 隔一段时间回头看看 Agent 的执行结果，验证它是否还在按预期工作。业务场景会变化，指令也需要跟着调整。

果断删除 — 如果一个 Agent 跑了一段时间后你觉得可有可无，果断删掉。不精准的推送只会制造噪音，反而增加你的信息处理负担。