NeboAI
NeboAI
Начать

Пакеты сотрудников

Пакет сотрудника описывает должность, на которую компания может нанять сотрудника: за что он отвечает, как работает, какие системы ему нужны и что он делает сам. Вы оформляете его как папку с AGENT.md и, если должности нужно больше, чем чат, с agent.json.

Пакет

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:

  1. Определяет потребности пакета без обращения к модели: каждую возможность в requires.interfaces, каждый плагин в requires.plugins и каждую возможность или плагин, которые указаны в триггере-наблюдателе.
  2. Показывает владельцу одно предложение о согласии на эти потребности и при найме выдаёт их этому сотруднику как постоянные разрешения. Операции, требующие одобрения, по-прежнему его требуют. См. Возможности и одобрения.
  3. Устанавливает зависимости: плагины из requires.plugins, навыки маркетплейса, указанные в skills и в действиях, и зависимости, объявленные при публикации пакета.
  4. Задаёт владельцу вопросы из inputs и сообщает ему через «Входящие» о каждой возможности, для которой ещё нет подключения.

Рабочий процесс, для возможности которого нет подключения, сохраняется и помечается как работающий с ограничениями, с указанием причины. Он начнёт работать, как только владелец подключит систему.

Что проверяет Nebo

Nebo читает agent.json снисходительно. Неизвестные ключи игнорируются. Рабочий процесс, не соответствующий схеме, пропускается, а владелец получает во «Входящих» уведомление, что он не будет запускаться; остальная часть сотрудника всё равно загружается. Вот проблемы, из-за которых отклоняется весь файл:

  • Триггер event с пустым списком sources.
  • Два действия с одинаковым id в одном рабочем процессе.
  • Входной вопрос с scope, отличным от company или seat, или денежный вопрос со значением по умолчанию.
  • Значение ceiling, отличное от "approval".
  • Дерево телефонного звонка, в котором не ровно одно приветствие или нет хотя бы одного именованного намерения.

Некоторые проверки выполняются при запуске рабочего процесса, а не при загрузке, например проверка параметров, которые требует каждый тип действия. См. Действия.

Описывайте обязанности, а не инструменты. Пакет сотрудника называет возможности, например ledger или mail, и никогда — конкретный продукт, компанию или отрасль. Владелец решает, какая система закрывает каждую возможность, поэтому один пакет подходит любой компании, которая нанимает этого сотрудника.

Далее