Agent 做事手册

你把一件事设置好过一次，写成技能或自定义提示词：记到哪个 Base、填哪些字段、用什么语气。之后你期望每个智能体都按你的方式做这件事，而不是自己另想一套。Busabase 把这些保存下来的做法叫作做事手册（playbook）。智能体在每条指令开始时都会先找一份。本页写给编写做事手册的人。

什么算做事手册

技能是模板装进来的还是你自己写的，没有区别，都一样会被找到。

每种节点类型自带的内置场景（「设计表结构」「批量导入」等）不算做事手册。它们在同类节点上都一样，智能体本来就知道；算进来只会把你自己写的淹没。你的自定义场景排在内置场景后面，内置场景始终保留。

智能体什么时候找

智能体在每一条指令开始时都会先找做事手册，包括单纯的提问，然后才自己动脑筋。它搜索的是整个工作区，不只是你当前所在的文件夹。

它只看得到自己的 Key 有权读取的内容。放在它无权访问的节点上的做事手册，永远不会出现在它的结果里。

通过 MCP、CLI 或 REST API 连接的智能体都遵守这条规则，从 Dashboard 启动的智能体也一样。

智能体怎么挑

1. 它会把你的请求换几种说法。 Busabase 自己不理解语言。智能体会把你的请求改写成两到五种说法，用你的语言，也用英文。「帮我记一下今天去见了 Acme」会变成「记录客户拜访」「log customer visit」「visit record」。
2. Busabase 用这些说法去匹配每份做事手册的名称、描述和场景名称。被好几种说法同时命中的，排在只被一个零散词命中的前面。
3. 分数相同时，离得近的赢。 如果你在 Sales 文件夹里，而 Sales 和 Ops 都有一个「周报」技能，Sales 的排第一。
4. 智能体读取它，照着做。 没有合适的，就直接做事，不会卡住，也不会假装匹配上了。

你自己说的话永远优先。 如果做事手册写着「写到 Leads Base」，而你说「放到 Partners」，智能体听你的。

怎么写才能被智能体找到

智能体能不能找到你的做事手册，几乎完全取决于你怎么给它起名、怎么描述。

• 自定义提示词用大家平时的说法命名。 写「记录客户拜访」，不要写「在 Visits 里新建一条记录」。人们会说前者；后者只是操作本身，内置场景已经覆盖了。
• 技能的 description 要写清楚什么时候用。 「记录或回顾 Acme 客户拜访时使用」能被找到，「CRM 助手」找不到。
• 团队用几种语言，就用几种语言命名。 智能体会匹配每种语言的名称。Dashboard 编辑器保存的是你当前界面语言的名称。想一次给一个场景设置多种语言的名称，可以让智能体来设置：busabase-cli nodes set-agent-prompts 和 API 都接受 { "en": "Log a customer visit", "zh-CN": "记录客户拜访" }。
• 不同文件夹里有同名的做事手册没关系，只要是你有意为之。离使用者所在位置最近的那份胜出。
• 一个提示词对应一件反复要做的事，每个节点两到五个。 如果说不出有人会反复回来做的事，就别写。含糊的提示词只会让智能体误匹配。

在一处查看全部做事手册

点开左上角的空间菜单，选择 做事手册。这个页面按文件夹分组，列出空间里你能读到的全部技能和自定义提示词。可以用 全部、技能、提示词 筛选。提示词那一行会写明它位于哪个节点，以及它是只读（只读）还是会写入（会修改）。点 打开提示词 可以直接编辑该节点的提示词，不用离开页面。

想确认智能体能不能找到某份做事手册，就在 你会怎么跟智能体说？ 里输入你会对智能体说的话，再点 查找。结果和智能体实际搜索的排序一样，并标出每条命中的字段。这是按字面匹配的预览：智能体还会带上它自己换的说法（以及英文）一起找，所以实际可能比这里找到的更多。如果什么都没匹配到，就用你刚才输入的词重新给提示词命名，或改写技能的描述。

查看用了哪份

智能体按某份做事手册做事时，会在回复里说明并附上链接，例如：使用了做事手册：记录客户拜访（Visits）。如果回复里没提任何做事手册，说明它没找到合适的。

变更请求上也会记下来。审核变更时，变更请求页面和收件箱会显示一个 通过做事手册「记录客户拜访」 的标签，点一下就能打开那份做事手册。如果你读不到做事手册所在的节点，标签只显示 通过一份做事手册，不显示名称，也没有链接。

没有这个标签的变更请求，要么没用做事手册，要么智能体没说明用了哪份。一份做事手册如果从没出现在任何变更请求上，说明智能体找不到它。

智能体在每次写入时用 kind:nodeId[:key] 声明做事手册，例如自定义提示词写 prompt:<nodeId>:<key>，技能写 skill:<nodeId>：

• CLI：全局参数 --playbook，或环境变量 BUSABASE_PLAYBOOK
• MCP：写入类工具的 playbook 参数
• REST：请求头 x-busabase-playbook

Busabase 记录前会先检查：这份做事手册必须存在，而且智能体的 Key 读得到它。检查不通过时，写入照常完成，只是不带标签。名称由 Busabase 自己填，智能体没法在标签上写自己的文字。

智能体没用上时

1. 在指令里点名：「用 Visits 上的『记录客户拜访』提示词」。被点名的做事手册，智能体会直接去读。
2. 然后改名称或描述，让下次不用点名也能找到。就用你第一次输入、智能体没找到时的那些词。
3. 确认智能体读得到它。 放在它的 Key 读不到的节点上，它就看不见。

给开发者：调用方式

搜索接收 queries（最多八种说法），以及可选的 nearNodeId、inNodeId、kinds、limit。返回一个简短的排序列表，附带 total、truncated 和 coverage。不传说法时，列出离得最近的做事手册。如果结果是 truncated，或者 coverage 表示某类没有被搜索（服务器版本较旧），空列表并不代表没有做事手册。它和 grep、search 的区别，见全域搜索。

相关阅读

• 技能：技能是什么，怎么进入工作区
• 全域搜索：用 grep 精确查找
• MCP：连接智能体