Das Modell
- Eine Fähigkeit ist eine typisierte Schnittstelle, nie ein Produkt.
mailhat die Operationenmail.inbox.read,mail.inbox.searchundmail.message.send. - Ein Mitarbeiterpaket listet die Fähigkeiten, die seine Rolle braucht, in
requires.interfacesauf. - Ein Plugin stellt eine Fähigkeit bereit, indem es ihre Operationen in
interfaceBindingsan seine eigenen Befehle bindet. - Eine Verbindung ist das Plugin, das der Inhaber für diese Fähigkeit verbunden hat. Ein Watch-Trigger, der eine Fähigkeit nennt, läuft darüber.
Festlegen, was eine Rolle braucht
{
"requires": { "interfaces": ["mail", "ledger"] },
"ceiling": { "ledger.bill.create": "approval" }
} Nenne Fähigkeiten, keine Plugins. Ein Mitarbeiterpaket, das ledger verlangt, funktioniert für jedes Unternehmen, egal welches Buchhaltungssystem es nutzt. Verwende requires.plugins nur, wenn eine Rolle wirklich von einem bestimmten Plugin abhängt.
Eine Fähigkeit bereitstellen
"interfaceBindings": {
"mail.inbox.read": "messages list --folder inbox",
"mail.inbox.search": "messages search --query {query}",
"mail.message.send": "messages send"
} Ein Plugin, das irgendeine mail.*-Operation bindet, stellt mail bereit. Jede Bindung wird außerdem zu einem typisierten Tool für Mitarbeiter, etwa mail_message_send. Die Vorlagensyntax steht in der plugin.json-Referenz.
Wenn ein Workflow eine Fähigkeit beobachtet, wählt Nebo das installierte Plugin, das sie bereitstellt, und bevorzugt eines, bei dem dieser Mitarbeiter ein Konto hat, danach gilt die alphabetische Reihenfolge. Gibt es keines, bleibt der Workflow erhalten, wird als eingeschränkt markiert, und der Inhaber erfährt, was er verbinden muss.
Der Katalog
Nebo liefert einen Katalog von Fähigkeiten und ihren Operationen mit, darunter ledger, mail, sms, telephony, calendar, drive, helpdesk, kb, deals, esign, timebilling, projects, cms, social, ads, reviews, email-marketing, repo, ci, deploy, monitoring und incidents. Der Katalog ist gemeinsames Vokabular, kein Zaun. Nutze seine Begriffe, wo immer einer passt, damit Mitarbeiter und Plugins verschiedener Anbieter zusammenfinden; ein neuer Begriff ist eine Frage der Konvention, kein Fehler.
Jede Operation trägt eine von drei Kennzeichnungen.
| Kennzeichnung | Bedeutung |
|---|---|
| Ohne Freigabe | Ein Lesezugriff oder eine schützende Maßnahme, die umkehrbar ist und ihren Wert verliert, wenn sie wartet, etwa Pausieren, Abbrechen oder Zurückrollen. Läuft ohne Nachfrage. |
| Freigabepflichtig | Bewegt Geld, kontaktiert jemanden außerhalb des Unternehmens oder lässt sich nicht rückgängig machen. Nebo fragt, bevor das gebundene Tool läuft. |
| Kritisch | Geldbewegungen, Vertragsabschlüsse, die eigenen Unterlagen des Unternehmens oder eine dauerhafte Befugnis, unbeaufsichtigt zu handeln. Immer freigabepflichtig; der Inhaber erteilt jede einzeln pro Mitarbeiter und pro Operation, und keine mitarbeiterweite Einstellung lockert das. |
Zustimmung beim Einstellen
Wenn ein Inhaber einen Mitarbeiter einstellt, liest Nebo dessen Bedarf aus dem Paket: die Fähigkeiten in requires.interfaces, die Plugins in requires.plugins und jede Fähigkeit oder jedes Plugin, das ein Watch-Trigger nennt. Der Inhaber sieht einen einzigen Satz, der diesen Bedarf benennt. Das Einstellen erteilt ihn diesem Mitarbeiter als dauerhafte Berechtigungen. Freigabepflichtige Operationen bleiben Freigabe-Einträge.
Das Installieren eines Plugins, eines MCP-Servers, einer App oder eines Skills ist selbst schon die Erlaubnis, es zu nutzen; diese werden nicht einzeln eingeschaltet. Nebos eigene integrierte Fähigkeiten sind gruppiert als chat, file, shell, web, contacts, desktop, media und system.
Obergrenzen und Gesetze
| Festgelegt in | Wirkung |
|---|---|
ceiling in agent.json | Die aufgeführten Operationen fragen bei diesem Mitarbeiter immer den Inhaber. Der einzige Wert ist "approval". |
Das ceiling eines Gesetzes in der Unternehmensebene | Die aufgeführten Operationen sind für jeden Mitarbeiter gesperrt. |
Ein Unternehmensgesetz mit reserved_to: owner | Die aufgeführten Operationen brauchen die eigene Freigabe des Inhabers, und diese Freigabe kann nie an einen Mitarbeiter übertragen werden. |
Berechtigungsmodi
Jeder Mitarbeiter hat einen Berechtigungsmodus. Er entscheidet über die Aufrufe, die keine Regel klärt, und der Inhaber kann ihn für einen einzelnen Lauf überschreiben.
| Modus | Verhalten |
|---|---|
automatic | Der Standard. Der Mitarbeiter handelt im Rahmen seiner Aufgabe und fragt nur bei freigabepflichtigen Operationen und den Nachfrageregeln des Inhabers. |
ask | Jeder Aufruf, der etwas ändert, fragt nach, sofern keine Erlaubnisregel ihn abdeckt. |
plan | Nur lesen und planen. Ein Aufruf, der etwas ändert, läuft nicht. |
full_access | Nichts fragt nach. Verbotsregeln und harte Grenzen gelten weiterhin. |
Nebo prüft jede Aktion in derselben Reihenfolge: zuerst harte Grenzen, dann Obergrenzen und Gesetze, dann die Regeln des Inhabers, dann den Modus. Harte Grenzen, etwa der Schutz von Zugangsdaten vor dem Abfließen, werden nie aufgehoben, nicht einmal in full_access.