Het pakket
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 | Bestand | Verplicht | Doel |
|---|---|---|
AGENT.md | ja | De persona: wie de medewerker is, hoe hij werkt en wat zijn regels zijn. Zie Persona en geheugen. |
agent.json | nee | Capabilities die hij nodig heeft, vragen voor de eigenaar, workflows, geheugeninstellingen en goedkeuringsplafonds. Zie de agent.json-referentie. |
skills/ | nee | Skills in het standaard SKILL.md-formaat. Alleen deze medewerker ziet ze. |
manifest.json | alleen apps | Identiteit met "type": "app". De marktplaats schrijft een eigen manifest wanneer hij een medewerker verpakt. |
ui/ | alleen apps | De pagina van de app. Zie Apps. |
Een pakket schrijven
Begin met de persona. De frontmatter geeft de medewerker een naam en een beschrijving van één regel; de body bevat instructies in gewone tekst.
--- 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.
Voeg agent.json toe als de functie een systeem nodig heeft, een instelling van de eigenaar, of werk dat hij doet zonder dat iemand erom vraagt. Dit voorbeeld vereist de capability mail, stelt bij het aannemen één vraag en beantwoordt elk nieuw bericht zodra het binnenkomt.
{
"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."
}
]
}
}
} De watch noemt de capability mail, niet een product. Tijdens het draaien wordt die omgezet naar de plug-in die de eigenaar voor mail heeft verbonden. Zie Workflows voor triggers en activiteiten.
Laden op een bot
Zet de map in <data>/user/agents/<name>/. Nebo houdt AGENT.md, agent.json en manifest.json in de gaten en laadt de medewerker ongeveer een seconde na een wijziging opnieuw. Als je de map verwijdert, wordt de medewerker gedeactiveerd, maar blijft zijn gegevensrecord bewaard.
Nebo laadt medewerkers uit drie bronnen, en latere bronnen winnen: medewerkers die in Nebo zijn ingebouwd, verzegelde marktplaatspakketten in <data>/nebo/agents/ en mappen in <data>/user/agents/. Een medewerker kan ook een pakket voor je aanmaken of wijzigen met zijn tools create_employee en update_employee, die dezelfde map schrijven.
Wat er gebeurt bij het aannemen
Als een eigenaar je medewerker aanneemt via de marktplaats of met een AGNT--code, doet Nebo het volgende:
- Leest wat het pakket nodig heeft zonder een model te raadplegen: elke capability in
requires.interfaces, elke plug-in inrequires.pluginsen elke capability of plug-in die een watch-trigger noemt. - Toont de eigenaar één toestemmingszin voor die behoeften en kent ze bij het aannemen als vaste machtigingen toe aan deze medewerker. Bewerkingen die goedkeuring nodig hebben, blijven dat nodig hebben. Zie Capabilities en goedkeuringen.
- Installeert afhankelijkheden: plug-ins in
requires.plugins, marktplaatsskills die inskillsen in activiteiten worden genoemd, en de afhankelijkheden die bij het publiceren van het pakket zijn gedeclareerd. - Stelt de eigenaar de
inputs-vragen en laat de eigenaar via Postvak IN weten welke capabilities nog geen verbinding hebben.
Een workflow waarvan de capability nog geen verbinding heeft, blijft bewaard en wordt gemarkeerd als beperkt, met de reden erbij. Hij begint te werken zodra de eigenaar een systeem verbindt.
Wat Nebo controleert
Nebo leest agent.json soepel. Onbekende sleutels worden genegeerd. Een workflow die niet aan het schema voldoet, wordt overgeslagen, en de eigenaar krijgt in Postvak IN een melding dat hij niet zal draaien; de rest van de medewerker wordt gewoon geladen. Door deze problemen wordt het hele bestand geweigerd:
- Een
event-trigger met een legesources-lijst. - Twee activiteiten met dezelfde
idin één workflow. - Een invoer met een andere
scopedancompanyofseat, of een geldvraag met een standaardwaarde. - Een
ceiling-waarde anders dan"approval". - Een belboom zonder precies één begroeting en minstens één benoemde intentie.
Sommige controles gebeuren pas wanneer een workflow start en niet wanneer hij laadt, zoals de parameters die elk activiteitstype vereist. Zie Activiteiten.
Schrijf verantwoordelijkheden, geen tools. Een medewerkerspakket noemt capabilities, zoals ledger of mail, en nooit een specifiek product, bedrijf of specifieke branche. De eigenaar bepaalt welk systeem elke capability invult, zodat één pakket werkt voor elk bedrijf dat hem aanneemt.
Volgende
- agent.json-referentie
- Persona en geheugen
- Publiceren: zet de medewerker op de marktplaats.