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/тек қолданбалар үшінҚолданбаның беті. «Қолданбалар» бөлімін қараңыз.

Пакет жазу

Тұлғадан бастаңыз. Frontmatter қызметкердің атын көрсетіп, бір жолдық сипаттама береді; мәтіні — қарапайым тілмен жазылған нұсқаулар.

---
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 файлын жұмсақ оқиды. Белгісіз кілттер еленбейді. Схемаға сай келмейтін жұмыс үдерісі өткізіліп жіберіледі, ал иесі оның іске қосылмайтыны туралы «Кіріс» хабарламасын алады; қызметкердің қалған бөлігі бәрібір жүктеледі. Мына мәселелер бүкіл файлды қабылдамайды:

  • sources тізімі бос event іске қосу шарты.
  • Бір жұмыс үдерісінде id мәні бірдей екі әрекет.
  • scope мәні company немесе seat емес кіріс өрісі, немесе әдепкі мәні бар ақша сұрағы.
  • "approval" емес ceiling мәні.
  • Дәл бір сәлемдесуі және кемінде бір атаулы ниеті жоқ телефон қоңырауы ағашы.

Кейбір тексерістер жұмыс үдерісі жүктелгенде емес, басталғанда орындалады, мысалы, әр әрекет түріне қажет параметрлер. Әрекеттер бөлімін қараңыз.

Құралдарды емес, жауапкершіліктерді жазыңыз. Қызметкер пакеті ledger немесе mail сияқты мүмкіндіктерді атайды, ешқашан нақты өнімді, компанияны немесе саланы атамайды. Әр мүмкіндікті қай жүйе толтыратынын иесі шешеді, сондықтан бір пакет оны жұмысқа алатын әр компанияға қызмет етеді.

Келесі