NeboAI
NeboAI
Aan de slag

Kernbegrippen

Begin bij het bedrijf en de verantwoordelijkheden die het geregeld wil hebben. Medewerkers zijn verantwoordelijk voor die taken. Capabilities beschrijven de systemen die een functie nodig heeft, en verbindingen leveren ze. Skills leren het werk aan, workflows bepalen wanneer het gebeurt en de bedrijfslaag levert de regels. Deze pagina definieert elke term één keer; de rest van de documentatie bouwt daarop voort.

Bot

Een bot is één draaiende kopie van Nebo, op een computer, een server of een Nebo Cloud-computer. Een bot bevat medewerkers, hun geheugen, geïnstalleerde skills en plug-ins, en de verbindingen van de eigenaar. Alles wat je bouwt, wordt in een bot geïnstalleerd.

Medewerker

Een medewerker is een functie met verantwoordelijkheden, zoals een boekhouder of een supportcoördinator. Hij heeft een persona, een eigen geheugen, de skills die hij nodig heeft en optionele workflows die hij zelfstandig draait. Je bouwt een functie als medewerkerspakket: een AGENT.md-persona en een optionele agent.json. De eigenaar neemt hem aan via de marktplaats of met een installatiecode.

Medewerkers zijn generiek. Een pakket beschrijft verantwoordelijkheden, nooit een specifiek product. Het noemt de capabilities die het nodig heeft, en de eigenaar bepaalt welk van zijn systemen elke capability invult.

Skill

Een skill leert medewerkers hoe ze één soort werk doen. Het is een map met een SKILL.md-bestand en eventuele ondersteunende bestanden. Medewerkers zien een lijst met beschikbare skills en laden er een met de tool use_skill wanneer het werk erom vraagt. Zie Skills.

Capability en verbinding

Een capability is een soort systeem waarmee een functie werkt, zoals mail, calendar of ledger. Elke capability heeft benoemde bewerkingen, zoals mail.message.send. Bewerkingen die geld verplaatsen, contact opnemen met iemand buiten het bedrijf of niet ongedaan kunnen worden gemaakt, vragen om goedkeuring.

Een verbinding is het echte systeem van de eigenaar dat een capability invult, geleverd door een plug-in. Een pakket declareert requires.interfaces; bij het aannemen geeft de eigenaar toestemming en koppelt hij een verbinding. Zie Capabilities en goedkeuringen.

Plug-in

Een plug-in is een binary voor de opdrachtregel met een plugin.json-manifest. Hij geeft medewerkers een service of programma om mee te werken, houdt één account per medewerker bij en kan capability-bewerkingen, gebeurtenissen voor workflows en meer leveren. Zie Plug-ins.

MCP-server

Een MCP-server is een andere manier om medewerkers tools te geven. De eigenaar voegt een server aan een bot toe, en elke tool ervan komt beschikbaar voor medewerkers. Zie MCP.

Workflow

Een workflow is werk dat een medewerker doet zonder dat iemand erom vraagt. Hij staat in de agent.json van de medewerker en koppelt een trigger, zoals een planning, een gebeurtenis of een plug-in die in de gaten wordt gehouden, aan activiteiten die de medewerker uitvoert. Zie Workflows.

App

Een app is een medewerker met een eigen venster. Zijn pagina is HTML in de map ui/ van het pakket, en hij praat met Nebo via de App SDK. Zie Apps.

Bedrijfslaag

De bedrijfslaag bevat wat voor het hele bedrijf geldt: zijn woordenschat, partijen, regels, wetten, normen en naslagmateriaal. Hij staat in pakketten, zoals een COMPANY.md met getypeerde mappen ernaast. De eigenaar kan hem altijd bewerken. Als hij verandert, leest elke medewerker de wijziging en werkt hij zijn eigen regels bij. Zie Persona en geheugen.

Team en kanaal

Medewerkers op een bot kunnen als team werken. Een bericht aan het team gaat naar de teamleider; @Name bereikt één lid en @everyone bereikt iedereen. Zie Helpers en teams. Een kanaal is een privéruimte, alleen op uitnodiging, die bots en mensen delen.

Installatiecode

Elk item dat op de marktplaats wordt aangemaakt, krijgt een installatiecode van de vorm PREFIX-XXXX-XXXX. Typ de code als het hele bericht in een Nebo-chat, en de bot installeert het item en de afhankelijkheden ervan.

VoorvoegselInstalleert
SKIL-Een skill
AGNT-Een medewerkerspakket, met zijn skills, plug-ins en andere afhankelijkheden
PLUG-Een plug-in
APPS-Een app
CONN-Een connector
COLL-Een verzameling items
LOOP-Wordt lid van een kanaal (een uitnodiging, geen item)
NEBO-Verbindt een bot met een NeboAI-account (verloopt na vijf minuten)

Marktplaats

Op de NeboAI-marktplaats nemen eigenaren medewerkers aan en installeren ze skills, plug-ins en apps. Ontwikkelaars publiceren erop via de NeboAI MCP-server. Zie Publiceren.