Пакет
support-coordinator/
├── AGENT.md # required: who the employee is and how it works
├── agent.json # optional: capabilities, inputs, workflows, memory
└── skills/ # optional: skills only this employee uses
└── reply-drafting/
└── SKILL.md | Файл | Обязательно | Назначение |
|---|---|---|
AGENT.md | да | Персона: кто такой сотрудник, как он работает и его правила. См. «Персона и память». |
agent.json | нет | Нужные возможности, вопросы владельцу, рабочие процессы, настройки памяти и пределы одобрения. См. «Справочник по agent.json». |
skills/ | нет | Навыки в стандартном формате SKILL.md. Их видит только этот сотрудник. |
manifest.json | только для приложений | Идентичность с "type": "app". Маркетплейс сам пишет манифест, когда упаковывает сотрудника. |
ui/ | только для приложений | Страница приложения. См. «Приложения». |
Как написать пакет
Начните с персоны. Фронтматтер называет сотрудника и даёт описание в одну строку; тело — это инструкции обычным текстом.
--- name: Support Coordinator description: Answers every customer message the day it arrives and escalates what it cannot settle. --- # Support Coordinator You answer customer email for the company. Reply within the configured window, in the company's voice, and keep every thread moving until the customer has an answer. ## How you work - Read the whole thread before you reply. - Use the reply-drafting skill for every customer reply. - When a message is about money, draft a proposal for the owner instead of promising anything. ## Rules - Never promise a refund, a discount or a date you cannot confirm.
Добавьте agent.json, если должности нужна система, настройка от владельца или работа, которую сотрудник делает без просьбы. Этот пример требует возможность mail, задаёт один вопрос при найме и отвечает на каждое новое письмо, как только оно приходит.
{
"requires": { "interfaces": ["mail"] },
"inputs": [
{
"key": "reply_window_hours",
"label": "Reply within (hours)",
"type": "number",
"id": "support.reply_window_hours",
"scope": "company",
"default": 24
}
],
"workflows": {
"new-mail": {
"trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
"description": "Handle each customer message as it arrives.",
"activities": [
{
"id": "reply",
"intent": "Read the message in _watch_payload, draft a reply within reply_window_hours, and escalate anything about money to the owner."
}
]
}
}
} Наблюдатель указывает возможность mail, а не продукт. Во время работы она сопоставляется с плагином, который владелец подключил для почты. Триггеры и действия описаны в разделе Рабочие процессы.
Загрузка на бота
Положите папку в <data>/user/agents/<name>/. Nebo отслеживает AGENT.md, agent.json и manifest.json и перезагружает сотрудника примерно через секунду после изменения. Если удалить папку, сотрудник станет неактивным, но его запись сохранится.
Nebo загружает сотрудников из трёх источников, и более поздние имеют приоритет: сотрудники, встроенные в Nebo, запечатанные пакеты маркетплейса в <data>/nebo/agents/ и папки в <data>/user/agents/. Сотрудник также может сам создать или изменить для вас пакет с помощью инструментов create_employee и update_employee, которые пишут в ту же папку.
Что происходит при найме
Когда владелец нанимает вашего сотрудника из маркетплейса или по коду AGNT-, Nebo:
- Определяет потребности пакета без обращения к модели: каждую возможность в
requires.interfaces, каждый плагин вrequires.pluginsи каждую возможность или плагин, которые указаны в триггере-наблюдателе. - Показывает владельцу одно предложение о согласии на эти потребности и при найме выдаёт их этому сотруднику как постоянные разрешения. Операции, требующие одобрения, по-прежнему его требуют. См. Возможности и одобрения.
- Устанавливает зависимости: плагины из
requires.plugins, навыки маркетплейса, указанные вskillsи в действиях, и зависимости, объявленные при публикации пакета. - Задаёт владельцу вопросы из
inputsи сообщает ему через «Входящие» о каждой возможности, для которой ещё нет подключения.
Рабочий процесс, для возможности которого нет подключения, сохраняется и помечается как работающий с ограничениями, с указанием причины. Он начнёт работать, как только владелец подключит систему.
Что проверяет Nebo
Nebo читает agent.json снисходительно. Неизвестные ключи игнорируются. Рабочий процесс, не соответствующий схеме, пропускается, а владелец получает во «Входящих» уведомление, что он не будет запускаться; остальная часть сотрудника всё равно загружается. Вот проблемы, из-за которых отклоняется весь файл:
- Триггер
eventс пустым спискомsources. - Два действия с одинаковым
idв одном рабочем процессе. - Входной вопрос с
scope, отличным отcompanyилиseat, или денежный вопрос со значением по умолчанию. - Значение
ceiling, отличное от"approval". - Дерево телефонного звонка, в котором не ровно одно приветствие или нет хотя бы одного именованного намерения.
Некоторые проверки выполняются при запуске рабочего процесса, а не при загрузке, например проверка параметров, которые требует каждый тип действия. См. Действия.
Описывайте обязанности, а не инструменты. Пакет сотрудника называет возможности, например ledger или mail, и никогда — конкретный продукт, компанию или отрасль. Владелец решает, какая система закрывает каждую возможность, поэтому один пакет подходит любой компании, которая нанимает этого сотрудника.
Далее
- Справочник по agent.json
- Персона и память
- Публикация: разместите сотрудника в маркетплейсе.