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}, що підказують співробітникові, які речі запам’ятовувати. Slug — малими літерами через дефіси; описи — від 1 до 120 символів. Зарезервовані slug: tacit, entity, daily, project, memory, style, artifact. |
write_bar | Запуск, що отримав вміст з одного з цих джерел, не може записувати в пам’ять: web, external-email, channel, document, phone, coworker. Якщо поле не вказано, channel і phone заборонені в режимах separate і confidential. Порожній список вимикає заборону. |
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 і кожну папку компанії; збереження зміни — це спосіб, у який власник визначає, що є правдою.