AGENT.md
AGENT.md 是纯 Markdown 文件。开头用前置元数据为员工命名并给出一句话描述;市场和所有者的员工队伍都会用到这两项。然后用第二人称写人设:员工的职责、工作方式和规则。
--- name: Collections Specialist description: Follows up on every overdue invoice until it is paid, disputed, or handed to the owner. --- # Collections Specialist You keep receivables moving. Every overdue invoice gets a follow-up on schedule, in a tone that protects the customer relationship. ## How you work - Check the aging report before any follow-up so you never chase a paid invoice. - Escalate to the owner when a customer disputes an amount. ## Rules - Never threaten, and never mention collections agencies. - Never agree to a payment plan; propose it to the owner.
每次会话开始时,Nebo 会把人设交给员工,同时附上它的名称、描述、前置元数据中的任何触发词,以及所有者在 Nebo 中给它的设置:它的个性、规则和灵魂。人设是员工私有的;它永远不会被加入其他员工共享的提示词中。
写清楚这个岗位负责什么、如何做决定。不要写工具名称和产品名称:员工的工具来自它的能力和连接,而且同一份人设必须能在每一家聘用它的公司里使用。
记忆
每位员工都会读取所有者本人的事实,并且只写入自己的记忆。它通过 remember、recall 和 forget 工具使用记忆。用 agent.json 中的 memory.mode 选择它的对话和记忆如何保存。
| 模式 | 行为 | 适用场景 |
|---|---|---|
single | 一段持续的对话和一份记忆。默认选项。 | 大多数岗位。 |
separate | 多段对话共享员工的私有记忆。与所有者以外的人(例如来电者或访客)的对话,会保留各自密封的记忆。 | 需要和很多人交谈的岗位。 |
confidential | 每段对话都是一个密封的事务。在一段对话中学到的任何东西在另一段中都不可见,包括所有者的对话。 | 必须彼此隔离的客户事务。 |
"memory": {
"mode": "separate",
"topics": [
{ "slug": "account", "description": "A customer account: balance, promises to pay, contacts, disputes" }
],
"write_bar": ["web", "external-email"],
"share_with": []
} | 字段 | 含义 |
|---|---|
mode | single、separate 或 confidential。旧的 context_isolated: true 会被视为 separate。 |
topics | 最多 8 组 {slug, description},告诉员工要记住哪些类型的东西。slug 使用小写字母和连字符;description 为 1 到 120 个字符。保留的 slug:tacit、entity、daily、project、memory、style、artifact。 |
write_bar | 如果一次运行接收了来自以下任一来源的内容,就不能写入记忆:web、external-email、channel、document、phone、coworker。省略时,在 separate 和 confidential 模式下禁止 channel 和 phone。空列表会关闭此限制。 |
share_with | 在回复中允许接收这位员工记忆的员工 id,或 *。默认为空,即不共享任何内容。 |
公司层
公司层是每位员工共享的知识:公司的用语、与之往来的各方、它的规则、法规和标准,以及参考资料。它以知识包的形式存放在机器人上。一个知识包是一个文件夹,里面恰好有一个标记文件——INDUSTRY.md、FRANCHISE.md 或 COMPANY.md——旁边是各类分类文件夹。当各层之间有冲突时,公司层优先于加盟层,加盟层优先于行业层。
<data>/packs/example-co/ ├── COMPANY.md ├── vocabulary/ ├── parties/ ├── rules/ ├── laws/ │ └── refunds.md ├── standards/ ├── workflows/ └── reference/
文件夹中的每个文件都是 Markdown,可带前置元数据。前置元数据承载结构信息,例如规则的 always、标准的 id 和 value,或法规的 ceiling;正文承载文字内容。知识包只存放知识,从不存放流程,因此包含技能的知识包会被拒绝。
法规
法规的 ceiling 列出了任何员工都不得执行的操作。在公司层上,reserved_to: owner 会改变这一点:这些操作仍然可以执行,但必须由所有者本人批准,而且这种批准永远不能转授他人。
--- ceiling: [ledger.refund.create] reserved_to: owner --- Refunds are issued only by the owner. Employees may prepare a refund and send it to the owner for approval.
员工如何学习公司层
员工在工作时不会去查阅公司层。当某一层发生变化时,每位员工会读取一次变更内容,并重写自己的规则。所有者随时可以编辑 COMPANY.md 和每个公司文件夹;保存变更,就是所有者声明什么是事实的方式。