NeboAI
NeboAI
Loslegen

Mitarbeiterpakete

Ein Mitarbeiterpaket beschreibt eine Rolle, die ein Unternehmen einstellen kann: wofür der Mitarbeiter zuständig ist, wie er arbeitet, welche Arten von Systemen er braucht und was er von sich aus erledigt. Du schreibst es als Ordner mit einer AGENT.md und, wenn die Rolle mehr als Chat braucht, einer agent.json.

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
DateiErforderlichZweck
AGENT.mdjaDie Persona: wer der Mitarbeiter ist, wie er arbeitet und welche Regeln er hat. Siehe Persona und Gedächtnis.
agent.jsonneinBenötigte Fähigkeiten, Fragen an den Inhaber, Workflows, Gedächtniseinstellungen und Freigabegrenzen. Siehe agent.json-Referenz.
skills/neinSkills im Standardformat SKILL.md. Nur dieser Mitarbeiter sieht sie.
manifest.jsonnur AppsIdentität mit "type": "app". Der Marktplatz schreibt sein eigenes Manifest, wenn er einen Mitarbeiter paketiert.
ui/nur AppsDie 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:

  1. Liest den Bedarf des Pakets, ohne ein Modell zu fragen: jede Fähigkeit in requires.interfaces, jedes Plugin in requires.plugins und jede Fähigkeit oder jedes Plugin, das ein Watch-Trigger nennt.
  2. 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.
  3. Installiert Abhängigkeiten: Plugins aus requires.plugins, Marktplatz-Skills, die in skills und in Aktivitäten genannt sind, und die Abhängigkeiten, die bei der Veröffentlichung des Pakets angegeben wurden.
  4. Stellt dem Inhaber die Fragen aus inputs und 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 leerer sources-Liste.
  • Zwei Aktivitäten mit derselben id in einem Workflow.
  • Eine Eingabe mit einem anderen scope als company oder seat, 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