Balík
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 | Súbor | Povinné | Účel |
|---|---|---|
AGENT.md | áno | Persona: kto zamestnanec je, ako pracuje a jeho pravidlá. Pozri Persona a pamäť. |
agent.json | nie | Schopnosti, ktoré vyžaduje, otázky pre vlastníka, pracovné postupy, nastavenia pamäte a stropy schvaľovania. Pozri Referencia agent.json. |
skills/ | nie | Zručnosti v štandardnom formáte SKILL.md. Vidí ich len tento zamestnanec. |
manifest.json | len aplikácie | Identita s "type": "app". Obchod pri balení zamestnanca zapíše vlastný manifest. |
ui/ | len aplikácie | Stránka aplikácie. Pozri Aplikácie. |
Napísanie balíka
Začnite personou. Frontmatter pomenuje zamestnanca a dá mu jednoriadkový popis; telo tvoria pokyny v obyčajnej próze.
--- 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.
Pridajte agent.json, keď rola potrebuje systém, nastavenie od vlastníka alebo prácu, ktorú robí bez požiadania. Tento vyžaduje schopnosť mail, pri prijatí položí jednu otázku a odpovedá na každú novú správu hneď, ako príde.
{
"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."
}
]
}
}
} Sledovanie pomenúva schopnosť mail, nie produkt. Za behu sa preloží na doplnok, ktorý vlastník pripojil pre poštu. Spúšťače a aktivity nájdete v časti Pracovné postupy.
Načítanie na bota
Vložte priečinok do <data>/user/agents/<name>/. Nebo sleduje AGENT.md, agent.json a manifest.json a približne sekundu po zmene zamestnanca znova načíta. Odstránením priečinka sa zamestnanec deaktivuje, ale jeho záznam zostane.
Nebo načítava zamestnancov z troch zdrojov a neskoršie zdroje majú prednosť: zamestnanci vstavaní v Nebo, zapečatené balíky z obchodu v <data>/nebo/agents/ a priečinky v <data>/user/agents/. Zamestnanec môže pre vás balík aj vytvoriť alebo zmeniť pomocou svojich nástrojov create_employee a update_employee, ktoré zapisujú do toho istého priečinka.
Čo sa deje pri prijatí
Keď vlastník prijme vášho zamestnanca z obchodu alebo kódom AGNT-, Nebo:
- Prečíta potreby balíka bez pýtania sa modelu: každú schopnosť v
requires.interfaces, každý doplnok vrequires.pluginsa každú schopnosť alebo doplnok, ktoré pomenúva sledovací spúšťač. - Ukáže vlastníkovi jednu vetu so súhlasom s týmito potrebami a pri prijatí ich tomuto zamestnancovi udelí ako trvalé oprávnenia. Operácie, ktoré vyžadujú schválenie, ho vyžadujú aj naďalej. Pozri Schopnosti a schválenia.
- Nainštaluje závislosti: doplnky v
requires.plugins, zručnosti z obchodu uvedené vskillsa v aktivitách a závislosti deklarované pri publikovaní balíka. - Položí vlastníkovi otázky z
inputsa cez Doručené mu oznámi každú schopnosť, ktorá ešte nemá pripojenie.
Pracovný postup, ktorého schopnosť nemá pripojenie, sa zachová a označí ako obmedzený aj s dôvodom. Začne fungovať hneď, ako vlastník pripojí systém.
Čo Nebo kontroluje
Nebo číta agent.json zhovievavo. Neznáme kľúče sa ignorujú. Pracovný postup, ktorý nezodpovedá schéme, sa preskočí a vlastník dostane v Doručených upozornenie, že nepobeží; zvyšok zamestnanca sa aj tak načíta. Tieto problémy odmietnu celý súbor:
- Spúšťač
events prázdnym zoznamomsources. - Dve aktivity s rovnakým
idv jednom pracovnom postupe. - Vstup so
scopeiným akocompanyaleboseat, alebo finančná otázka s predvolenou hodnotou. - Hodnota
ceilinginá ako"approval". - Strom telefonického hovoru bez práve jedného pozdravu a aspoň jedného pomenovaného zámeru.
Niektoré kontroly prebiehajú až pri spustení pracovného postupu, nie pri jeho načítaní, napríklad parametre, ktoré vyžaduje každý typ aktivity. Pozri Aktivity.
Píšte zodpovednosti, nie nástroje. Balík zamestnanca pomenúva schopnosti, napríklad ledger alebo mail, a nikdy nie konkrétny produkt, firmu ani odvetvie. O tom, ktorý systém naplní ktorú schopnosť, rozhoduje vlastník, takže jeden balík slúži každej firme, ktorá ho prijme.
Ďalej
- Referencia agent.json
- Persona a pamäť
- Publikovanie: umiestnite zamestnanca do obchodu.