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. Как хранятся его разговоры и память, выбирается в memory.mode в agent.json.
| Режим | Поведение | Для чего подходит |
|---|---|---|
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}, которые говорят сотруднику, что именно запоминать. Слаги пишутся строчными буквами через дефис; описания — от 1 до 120 символов. Зарезервированные слаги: 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 и любую папку компании; сохраняя изменение, владелец заявляет, что верно.