Das Paket
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 | Datei | Erforderlich | Zweck |
|---|---|---|
AGENT.md | ja | Die Persona: wer der Mitarbeiter ist, wie er arbeitet und welche Regeln er hat. Siehe Persona und Gedächtnis. |
agent.json | nein | Benötigte Fähigkeiten, Fragen an den Inhaber, Workflows, Gedächtniseinstellungen und Freigabegrenzen. Siehe agent.json-Referenz. |
skills/ | nein | Skills im Standardformat SKILL.md. Nur dieser Mitarbeiter sieht sie. |
manifest.json | nur Apps | Identität mit "type": "app". Der Marktplatz schreibt sein eigenes Manifest, wenn er einen Mitarbeiter paketiert. |
ui/ | nur Apps | Die Seite der App. Siehe Apps. |
Ein Paket schreiben
Beginne mit der Persona. Das Frontmatter benennt den Mitarbeiter und gibt eine einzeilige Beschreibung; der Hauptteil besteht aus Anweisungen in einfacher Prosa.
--- 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.
Füge agent.json hinzu, wenn die Rolle ein System, eine Einstellung vom Inhaber oder Arbeit braucht, die sie unaufgefordert erledigt. Diese hier verlangt die Fähigkeit mail, stellt beim Einstellen eine Frage und beantwortet jede neue Nachricht, sobald sie eintrifft.
{
"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."
}
]
}
}
} Der Watch-Trigger nennt die Fähigkeit mail, kein Produkt. Zur Laufzeit wird sie zu dem Plugin aufgelöst, das der Inhaber für E-Mail verbunden hat. Trigger und Aktivitäten findest du unter Workflows.
Auf einem Bot laden
Lege den Ordner in <data>/user/agents/<name>/ ab. Nebo überwacht AGENT.md, agent.json und manifest.json und lädt den Mitarbeiter etwa eine Sekunde nach einer Änderung neu. Wenn du den Ordner entfernst, wird der Mitarbeiter deaktiviert, sein Datensatz bleibt aber erhalten.
Nebo lädt Mitarbeiter aus drei Quellen, und spätere Quellen haben Vorrang: in Nebo integrierte Mitarbeiter, versiegelte Marktplatz-Pakete in <data>/nebo/agents/ und Ordner in <data>/user/agents/. Ein Mitarbeiter kann auch mit seinen Tools create_employee und update_employee ein Paket für dich erstellen oder ändern; sie schreiben in denselben Ordner.
Was beim Einstellen passiert
Wenn ein Inhaber deinen Mitarbeiter aus dem Marktplatz oder mit einem AGNT--Code einstellt, geht Nebo so vor:
- Liest den Bedarf des Pakets, ohne ein Modell zu fragen: jede Fähigkeit in
requires.interfaces, jedes Plugin inrequires.pluginsund jede Fähigkeit oder jedes Plugin, das ein Watch-Trigger nennt. - Zeigt dem Inhaber einen einzigen Zustimmungssatz für diesen Bedarf und erteilt ihn beim Einstellen diesem Mitarbeiter als dauerhafte Berechtigungen. Operationen, die eine Freigabe brauchen, bleiben freigabepflichtig. Siehe Fähigkeiten und Freigaben.
- Installiert Abhängigkeiten: Plugins aus
requires.plugins, Marktplatz-Skills, die inskillsund in Aktivitäten genannt sind, und die Abhängigkeiten, die bei der Veröffentlichung des Pakets angegeben wurden. - Stellt dem Inhaber die Fragen aus
inputsund teilt ihm über den Posteingang jede Fähigkeit mit, für die noch keine Verbindung besteht.
Ein Workflow, dessen Fähigkeit keine Verbindung hat, bleibt erhalten und wird mit Begründung als eingeschränkt markiert. Er beginnt zu arbeiten, sobald der Inhaber ein System verbindet.
Was Nebo prüft
Nebo liest agent.json nachsichtig. Unbekannte Schlüssel werden ignoriert. Ein Workflow, der nicht zum Schema passt, wird übersprungen, und der Inhaber bekommt im Posteingang einen Hinweis, dass er nicht laufen wird; der Rest des Mitarbeiters wird trotzdem geladen. Diese Probleme führen zur Ablehnung der ganzen Datei:
- Ein
event-Trigger mit leerersources-Liste. - Zwei Aktivitäten mit derselben
idin einem Workflow. - Eine Eingabe mit einem anderen
scopealscompanyoderseat, oder eine Geldfrage mit Standardwert. - Ein
ceiling-Wert, der nicht"approval"ist. - Ein Anrufbaum für Telefonate ohne genau eine Begrüßung und mindestens eine benannte Absicht.
Manche Prüfungen laufen erst, wenn ein Workflow startet, nicht schon beim Laden, etwa die Parameter, die jeder Aktivitätstyp verlangt. Siehe Aktivitäten.
Beschreibe Zuständigkeiten, keine Tools. Ein Mitarbeiterpaket nennt Fähigkeiten wie ledger oder mail und nie ein bestimmtes Produkt, Unternehmen oder eine Branche. Der Inhaber entscheidet, welches System jede Fähigkeit abdeckt, sodass ein Paket jedem Unternehmen dient, das es einstellt.
Weiter
- agent.json-Referenz
- Persona und Gedächtnis
- Veröffentlichen: Bring den Mitarbeiter in den Marktplatz.