NeboAI
NeboAI
Kezdés

Munkatárscsomagok

A munkatárscsomag egy olyan szerepkört ír le, amelyre egy cég munkatársat vehet fel: miért felel a munkatárs, hogyan dolgozik, milyen rendszerekre van szüksége, és mit csinál önállóan. Egy mappaként írja meg, egy AGENT.md fájllal, és ha a szerepkörhöz a csevegésnél több kell, egy agent.json fájllal.

A csomag

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
FájlKötelezőCél
AGENT.mdigenA személyiség: ki a munkatárs, hogyan dolgozik, és mik a szabályai. Lásd: Személyiség és memória.
agent.jsonnemA szükséges képességek, a tulajdonosnak szóló kérdések, munkafolyamatok, memóriabeállítások és jóváhagyási plafonok. Lásd: agent.json referencia.
skills/nemKészségek a szabványos SKILL.md formátumban. Csak ez a munkatárs látja őket.
manifest.jsoncsak alkalmazásoknálIdentitás "type": "app" értékkel. A piactér saját manifestet ír, amikor becsomagol egy munkatársat.
ui/csak alkalmazásoknálAz alkalmazás oldala. Lásd: Alkalmazások.

Csomag írása

Kezdje a személyiséggel. A fejléc megnevezi a munkatársat, és egysoros leírást ad; a törzs egyszerű prózában írt utasításokat tartalmaz.

---
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.

Adja hozzá az agent.json fájlt, ha a szerepkörnek rendszerre, a tulajdonostól kapott beállításra vagy kérés nélkül végzett munkára van szüksége. Ez itt a mail képességet igényli, felvételkor egy kérdést tesz fel, és minden új üzenetre válaszol, amint megérkezik.

{
  "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."
        }
      ]
    }
  }
}

A figyelő a mail képességet nevezi meg, nem egy terméket. Futáskor arra a bővítményre oldódik fel, amelyet a tulajdonos a levelezéshez csatlakoztatott. Az indítókat és a tevékenységeket lásd itt: Munkafolyamatok.

Betöltés egy botra

Tegye a mappát ide: <data>/user/agents/<name>/. A Nebo figyeli az AGENT.md, az agent.json és a manifest.json fájlt, és egy változás után nagyjából egy másodperccel újratölti a munkatársat. A mappa eltávolítása deaktiválja a munkatársat, de megtartja a nyilvántartását.

A Nebo három forrásból tölti be a munkatársakat, és a későbbi forrás nyer: a Nebóba beépített munkatársak, a lezárt piactéri csomagok a <data>/nebo/agents/ helyen, és a mappák a <data>/user/agents/ helyen. Egy munkatárs a create_employee és update_employee eszközeivel Ön helyett is létrehozhat vagy módosíthat csomagot; ezek ugyanazt a mappát írják.

Mi történik felvételkor

Amikor egy tulajdonos felveszi a munkatársát a piactérről vagy egy AGNT- kóddal, a Nebo:

  1. Modell megkérdezése nélkül beolvassa a csomag igényeit: minden képességet a requires.interfaces listából, minden bővítményt a requires.plugins listából, és minden képességet vagy bővítményt, amelyet egy figyelőindító megnevez.
  2. Egyetlen hozzájáruló mondatot mutat a tulajdonosnak ezekről az igényekről, és felvételkor állandó engedélyként megadja őket ennek a munkatársnak. A jóváhagyást igénylő műveletek továbbra is jóváhagyást igényelnek. Lásd: Képességek és jóváhagyások.
  3. Telepíti a függőségeket: a requires.plugins bővítményeit, a skills mezőben és a tevékenységekben megnevezett piactéri készségeket, valamint a csomag közzétételekor deklarált függőségeket.
  4. Felteszi a tulajdonosnak az inputs kérdéseket, és a Beérkezett mappán keresztül értesíti minden olyan képességről, amelyhez még nincs kapcsolat.

Az a munkafolyamat, amelynek képességéhez nincs kapcsolat, megmarad, és csökkentett állapotúként jelölődik, az okkal együtt. Amint a tulajdonos csatlakoztat egy rendszert, működni kezd.

Mit ellenőriz a Nebo

A Nebo engedékenyen olvassa az agent.json fájlt. Az ismeretlen kulcsokat figyelmen kívül hagyja. A sémának meg nem felelő munkafolyamatot kihagyja, a tulajdonos pedig értesítést kap a Beérkezett mappába, hogy az nem fog futni; a munkatárs többi része így is betöltődik. Ezek a problémák az egész fájlt elutasíttatják:

  • Egy event indító üres sources listával.
  • Két azonos id azonosítójú tevékenység egy munkafolyamatban.
  • Egy bemenet, amelynek scope értéke nem company vagy seat, vagy egy pénzösszegre vonatkozó kérdés alapértelmezett értékkel.
  • Egy "approval" értéktől eltérő ceiling érték.
  • Egy telefonos hívásfa, amelyben nincs pontosan egy üdvözlés és legalább egy elnevezett szándék.

Egyes ellenőrzések nem a betöltéskor, hanem a munkafolyamat indulásakor futnak, például az egyes tevékenységtípusok által megkövetelt paraméterek ellenőrzése. Lásd: Tevékenységek.

Felelősségi köröket írjon, ne eszközöket. A munkatárscsomag képességeket nevez meg, például ledger vagy mail, és soha nem konkrét terméket, céget vagy iparágat. A tulajdonos dönti el, melyik rendszer tölti be az egyes képességeket, így egy csomag minden cégnek megfelel, amely felveszi.

Tovább