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, і ніколи не називає конкретний продукт, компанію чи галузь. Власник вирішує, яка система забезпечує кожну можливість, тож один пакет підходить кожній компанії, що його наймає.

Далі