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ájl | Kötelező | Cél |
|---|---|---|
AGENT.md | igen | A személyiség: ki a munkatárs, hogyan dolgozik, és mik a szabályai. Lásd: Személyiség és memória. |
agent.json | nem | A 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/ | nem | Készségek a szabványos SKILL.md formátumban. Csak ez a munkatárs látja őket. |
manifest.json | csak alkalmazásoknál | Identitás "type": "app" értékkel. A piactér saját manifestet ír, amikor becsomagol egy munkatársat. |
ui/ | csak alkalmazásoknál | Az 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:
- Modell megkérdezése nélkül beolvassa a csomag igényeit: minden képességet a
requires.interfaceslistából, minden bővítményt arequires.pluginslistából, és minden képességet vagy bővítményt, amelyet egy figyelőindító megnevez. - 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.
- Telepíti a függőségeket: a
requires.pluginsbővítményeit, askillsmező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. - Felteszi a tulajdonosnak az
inputské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
eventindító üressourceslistával. - Két azonos
idazonosítójú tevékenység egy munkafolyamatban. - Egy bemenet, amelynek
scopeértéke nemcompanyvagyseat, 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
- agent.json referencia
- Személyiség és memória
- Közzététel: tegye a munkatársat a piactérre.