Version 1.0.0-alpha.1seneste
Kapitel 2.18
Udvidelsesmodellen
De seks måder at udvide Nexus på, fra en indstilling til en domænepakke, grænserne for hver enkelt, og hvordan tillids- og isolationsniveauer afgør, hvor Deres kode kører. Læs dette, før De åbner softwareudviklingssættet (SDK).
Denne side er oversat af AI fra den engelske original. Hvis noget er uklart, er den engelske side gældende. Læs denne side på engelsk

Det første, jeg byggede på Nexus hos Corrán Orbital, var ikke et plugin. Vores team for flyvedynamik ønskede, at assistenten skulle besvare spørgsmålet "hvilke jordstationspassager mister vi, hvis Svalbard-antennen tages ned til vedligeholdelse?" i samme format hver gang, med passagetabellen først og omkostningen i kontaktminutter nedenunder. Jeg brugte en halv dag på at læse dokumentationen til softwareudviklingssættet (SDK), før en kollega påpegede, at det, jeg havde brug for, var en færdighed (skill): en mappe med en SKILL.md i, uploadet til Skills Engine og udgivet, så snart dens tests gik igennem, og en kontrollant godkendte den. Det tog fyrre minutter.
To plugins og én domænepakke senere er det stadig det råd, jeg giver først. Nexus kan udvides på seks måder, og de befinder sig på en stige sorteret efter indsats. De billige trin kan mere, end folk forventer, og de dyre medfører forpligtelser, som er lette at undervurdere. Dette kapitel gennemgår stigen. Vælg det laveste trin, der kan løse opgaven. De efterfølgende kapitler går i dybden med hvert trin: kapitel 2.19, Reglerne, som enhver udvidelse arver; kapitel 2.20, Færdigheder; kapitel 2.21, Plugin-SDK'et; kapitel 2.22, Plugin-afviklingsmiljøet; og kapitel 2.23, Domænepakker.
De seks byggesten
Her er de i den rækkefølge, De bør overveje dem.
- Indstillinger og politikker. Dette er værdier, som en administrator angiver i konsollen for organisationen, en enhed eller én person, inden for hvad licensen tillader. De skriver slet ingen kode.
- Skills Engine-færdigheder. En
SKILL.md-pakke, der indeholder instruktioner og de værktøjer, færdigheden må kalde, med valgfrie filer og scripts ved siden af. Assistenten, agenter, arbejdsgange og AI-knapperne (kunstig intelligens) på skærmbillederne kører alle de samme færdigheder, og det samme gør Deres IDE (integrerede udviklingsmiljø). - Plugins. Deres egen kode, deklareret af et manifest og bygget med SDK'ets værktøjer. Et plugin findes på et af tre niveauer:
skills-only,ui-onlyellerfull-service. - Domænepakker. Én branches linser og skabeloner, dens færdigheder og vidensmodel, dens connectors og dens telefonskærmbilleder, licenseret som en samlet enhed. Adverant leverer ti; De kan bygge Deres egne.
- Linser. Hvad én rolle ser inde i en pakke eller en platform. En linse indsnævrer en basislinse og udvider den aldrig.
- MCP-forbindelser og connectors. De Model Context Protocol-værktøjer (MCP), som et plugin udgiver, eller som et AI-kodningsværktøj forbinder igennem, samt de skrivebeskyttede connectors, der henter poster ind fra systemer, De allerede kører.
To begreber bruges ofte i flæng, så lad mig fastlægge dem nu. En Skills Engine-færdighed er en SKILL.md-pakke i biblioteket. En manifestfærdighed er en typet række i et plugins skills[]-array, som kompileres ind i platformens færdighedsregister og køres gennem UNO, arbejdsgangsmotoren. Begge kaldes færdigheder (skills) på skærmen. De skrives og styres forskelligt, og denne dokumentation angiver altid, hvilken af dem der menes.
Hvad hver enkelt kan, og hvad den ikke kan
Tabellen er den korte udgave. Jeg har med vilje tilføjet kolonnen "Hvad den ikke kan": Hver begrænsning er en egenskab ved designet, og hver eneste af dem har reddet mig fra noget.
| Byggesten | Hvad den kan | Hvad den ikke kan | Hvem der laver den |
|---|---|---|---|
| Indstilling eller politik | Ændre, hvordan en funktion opfører sig på ethvert niveau fra organisationen ned til én person; låse en værdi; delegere den nedad; kræve en ekstra godkender ved en ændring | Tilføje et skærmbillede eller en rute, gemme en ny tabel eller starte en ny type arbejde | En administrator, i konsollen |
| Skills Engine-færdighed | Give assistenten og agenter, arbejdsgange og AI-knapper en gentagelig måde at udføre én opgave på, med egne instruktioner og testcases | Opbevare legitimationsoplysninger; kalde et værktøj uden for tilladelseslisten for den person, der kører den (SKILL_CANNOT_WIDEN_TOOLS); gå i luften uden sine tests og godkendelse |
Enhver med rettigheden, i oprettelsesværktøjet eller fra eget IDE |
Plugin, skills-only |
Udgive manifestfærdigheder, der kører på platformen: vært-callbacks, arbejde i kø, afbildninger over en liste og, ved tillidsniveau core eller verified, modelbaserede færdigheder |
Servere sine egne sider | En udvikler, med SDK'et |
Plugin, ui-only |
Tilføje en frontend-flade inde i skallen | Gemme sine egne data eller køre beregninger | En udvikler, med SDK'et |
Plugin, full-service |
Sin egen backend og frontend, et Postgres-skema, en rutetabel med rettigheder samt færdigheder og MCP-værktøjer | Kalde en modeludbyder; opbevare en modelnøgle; læse en anden organisations rækker undtagen gennem en registreret tilladelse; køre beregninger uden om UNO-afvikling | En udvikler, med SDK'et |
| Domænepakke | Levere en branches linser og skabeloner, dens færdigheder og arbejdsgange, en vidensmodel, et evidenskort og telefonskærmbilleder til de enheder, en administrator vælger | Ændre skallen eller dens komponenter eller skrivereglerne; køre uden at organisationens licens dækker den | Adverant, eller Deres egne udviklere på Enterprise |
| Linse | Vælge de kort og felter, én rolle ser inde i en pakke eller platform, og de handlinger, den tilbyder | Vise noget, som dens basislinse skjuler (LENS_CANNOT_WIDEN); ændre, hvad en rolle må gøre |
En pakkeforfatter bygger den; en administrator tildeler den pr. enhed |
| MCP-værktøjer og connectors | Eksponere et plugins værktøjer for agenter og kodningsværktøjer; læse poster fra et policesystem eller et telemetriarkiv ind i vidensmodellen | Skrive tilbage til kildesystemet gennem en connector; handle ud over den indloggede persons egne tilladelser | En udvikler deklarerer MCP-værktøjer; en administrator opsætter connectors |
Enkelte af disse felter fortjener en sætning mere.
Indstillinger er et framework, og hvert plugin bruger det samme. Et plugin, der deklarerer en settings-blok i sit manifest, får niveauerne (platform, organisation, pakke, enhed, gruppe, repository, person), låse og delegering, en ændringslog og godkendelse fra en anden person – alt sammen uden at skrive en indstillingstabel. Det er derfor, det billigste trin ofte er nok: Hvis den adfærd, De ønsker, allerede findes og blot behøver en anden værdi for Rotterdam-enheden, er det en indstilling.
En Skills Engine-færdighed kører som personen. Den opbevarer aldrig en nøgle, og den kan kun tilgå værktøjer inden for tilladelseslisten for den, der kører den, og kun læse det, som den pågældende person må åbne. En færdighed, der tilføjer et værktøj, som skriver, tilbageholdes, indtil to personer godkender den, hvorefter den går i luften i skyggetilstand, derefter som kanarieudrulning og til sidst for alle.
Et skills-only-plugin er det mellemste trin. De har brug for det, når arbejdet er kode, De selv ejer: en deterministisk beregning, en kø-worker, en forgrening (fan-out) over en liste. Platformen kalder Deres kode; Deres kode kalder aldrig en model.
Et full-service-plugin er et lille produkt. Det ejer et Postgres-skema, en rutetabel med et rettighedsregister, en frontend, et sæt databaseroller og enhver isoleringsforpligtelse i kapitel 2.19, Reglerne, som enhver udvidelse arver. Det er det rigtige svar oftere, end folk frygter, og det forkerte svar oftere, end folk håber.
Hvilken har jeg brug for?
Start øverst i denne tabel, og stop ved den første række, der passer.
| De vil gerne… | Brug | Hvorfor ikke noget lettere |
|---|---|---|
| Ændre en værdi eller en grænse, eller hvem der må gøre noget | En indstilling eller en politik | Der findes intet lettere |
| Få assistenten til at udføre én opgave på samme måde hver gang | En Skills Engine-færdighed | En indstilling kan ikke indeholde instruktioner |
| Sætte en "AI-knap" på et skærmbillede, der kører den pågældende opgave | En Skills Engine-færdighed bundet til knappen | En knap kører kun færdigheder; der er intet at bygge |
| Lade et AI-kodningsværktøj tilgå Nexus | En MCP-forbindelse gennem Workbench | Intet at skrive; personen logger ind gennem sin browser |
| Læse poster fra et eksisterende system ind i vidensmodellen | En skrivebeskyttet connector | En connector skriver intet tilbage, så den indebærer ingen skriverisiko |
| Køre deterministisk kode, De selv ejer, efter platformens tidsplan | Et skills-only-plugin med en host_callback- eller plugin_queue-færdighed |
En Skills Engine-færdighed kan ikke køre Deres kode |
| Tilføje et skærmbillede eller to inde i skallen | Et ui-only-plugin |
Kun plugins tilføjer skærmbilleder |
| Opbevare Deres egne poster bag Deres egne ruter og rettigheder | Et full-service-plugin |
Kun dette niveau ejer et skema |
| Give én rolle en mere indsnævret visning af en branches skærmbilleder | En linse på en eksisterende pakke | En linse er data, ikke kode |
| Levere en branches vidensmodel og linser, med telefonskærmbilleder, til flere enheder | En domænepakke | Et plugin alene har hverken linser eller licensspærring |
Hos Corrán Orbital forblev spørgsmålet om passageplanlægning en Skills Engine-færdighed. Den banepropagering, den behøver, blev til et skills-only-plugin med én host_callback-færdighed, fordi det numeriske arbejde er vores eget og skal give det samme svar to gange. Vores udvalg til gennemgang af anomalier blev til et full-service-plugin, fordi det fører sine egne optegnelser over, hvem der kiggede på hvilket telemetriudsving, og hvad de besluttede. Pakken kom til sidst, da en anden enhed ønskede det samme.
Hvordan delene kombineres
Byggestenene sammensættes opad. En domænepakke er det tydeligste eksempel, fordi den er en samling af de øvrige plus en licensspærring:
- en vidensmodel, de typer elementer branchen kender, og hvordan de er forbundet, ofte bygget oven på en basismodel fra en anden pakke;
- linser, én pr. rolle, der hver især indsnævrer en basislinse;
- skabeloner og arbejdsgange samt de Skills Engine-færdigheder, de kalder;
- plugins, hvor pakken behøver sin egen kode;
- skrivebeskyttede connectors til de systemer, der allerede indeholder posterne;
- et mobil-overlay, der bestemmer, hvilke kort og registreringstrin der vises på telefoner;
- og rettigheden (entitlement): de funktionsgrupper, licensen skal indeholde, før noget af det aktiveres.
Intet af dette er underliggende infrastruktur, der skal bygges pr. app. Pakken leverer ingen egen isoleringskode, ingen modelklient og intet licenstjek: Den arver platformens. Det er emnet for næste kapitel, og det er grunden til, at en pakkeforfatter i en bank og en i en havn skriver den samme mængde sikkerhedskode – nemlig ingen.
Tillidsniveauer
Hvert plugin deklarerer et trust-niveau i sit manifest. Tillid (trust) er ikke en spærring, som SDK'et kan tale sig uden om. Det er vejledende metadata, som platformen læser for at afgøre, hvor isoleret et plugins bidrag skal køre, og hvilke mest følsomme data dets færdigheder må berøre. De aktive spærringer (klassificering og dataplacering, eksport og forbrug) bliver præcis, hvor de er.
| Tillidsniveau | Hvem det er til | Isoleringsprofil | Klassificeringsloft |
|---|---|---|---|
core |
Førstepartskode, der leveres med platformen | none: same-origin, ingen ekstra isolering |
restricted |
verified |
En gennemgået tredjepart, en verificeret udgiver | same-origin-flade, formidlede færdigheder |
restricted |
community |
En ikke-gennemgået tredjepart; standarden for et nyt plugin | sandboxed-flade, formidlede færdigheder |
tenant |
untrusted |
Alt fra en ukendt kilde | strict: sandboxed flade, kun formidlede færdigheder, ingen værtstillid |
public |
To regler følger af denne tabel, og create-nexus-plugin validate håndhæver begge, før noget bygges.
For det første må en færdigheds classification ikke overstige dens plugins loft. Klassificeringer rangerer public, derefter tenant, derefter restricted. Et community-plugin, der deklarerer en restricted-færdighed, fejler under bygningen.
For det andet må kun core- og verified-plugins deklarere færdigheder, der tilgår AI Provider Router. Det er niveauerne tool_using og llm_only. Et community- eller untrusted-plugin formidler deterministisk arbejde (host_callback, plugin_queue og map over disse) og beder platformen om at udføre alt, der kræver en model. Mit første plugin var community, og jeg spildte en eftermiddag på at forsøge at deklarere en llm_only-opsummeringsfærdighed, før jeg forstod, at afvisningen var hele pointen.
Hvis De udelader trust, behandler SDK'et pluginet som community. Et udeladt felt kan aldrig føre til en opgradering af tillidsniveauet.
Isolationsniveauer 1 til 4
Uafhængigt af tillidsniveauet angiver manifestets runtime-blok, hvordan pluginet kører. isolationLevel er et heltal fra 1 til 4, og afviklingstilstanden følger heraf. De vælger ikke de to uafhængigt af hinanden: Validatoren udleder den ene fra den anden og afviser et manifest, hvor parret ikke stemmer overens.
isolationLevel |
executionMode |
Hvad det betyder |
|---|---|---|
| 1 | external_https |
Pluginet kører uden for installationen og tilgås over HTTPS |
| 2 | mcp_container |
En container, der eksponerer MCP-værktøjer |
| 3 | hardened_docker |
En hærdet container i pluginets egne pods; skabelonens standard |
| 4 | firecracker |
En microVM, den stærkeste adskillelse |
"runtime": {
"nodeVersion": "20",
"executionMode": "hardened_docker",
"isolationLevel": 3,
"entrypoint": "dist/server.js",
"healthCheck": "/health"
}entrypoint er påkrævet. Entrypoints er leverede artefakter og hentes aldrig ved kørselstid: SDK'et har slet ingen sti til dynamisk import eller fjernindlæsning, så tillidsniveauet nedskrives og kontrolleres én gang, hvorefter det fastfryses og aldrig downloades.
Hvad De forpligter Dem til på hvert trin
Hvert trin over indstillinger koster noget at vedligeholde. Her er, hvad hvert enkelt koster Dem.
- En Skills Engine-færdighed kræver testcases, en kontrollant, som ikke er Dem selv, og en versionshistorik, De vil blive spurgt ind til, når den opfører sig forkert. De samme bytes udgives aldrig to gange (
CONTENT_HASH_ALREADY_PUBLISHED), så "bare upload den igen" er ikke en løsning. - Et plugin kræver et manifest, hvis rutetabel matcher de ruter, Deres kode registrerer, i begge retninger. En rute, der findes, men ikke er deklareret, er en overensstemmelsesfejl, og det samme er en deklareret rute, som koden aldrig registrerer.
- Et
full-service-plugin ejer et skema med fem databaseroller, sikkerhed på rækkeniveau (row-level security) gennemtvunget på hver tabel og en opstartsproces, der nægter at lytte, indtil databasen beviser, at afgrænsningen holder. Det gentager også de tre platformslove i sit manifest, ord for ord. - En domænepakke er licenseret. Den aktiveres for én enhed ad gangen gennem et pilotprojekt, og organisationens licens skal dække den. De bestemmer ikke selv, om en kunde har den.
- En linse kan kun fjerne elementer. Hvis en rolle har brug for at se mere, skal basislinsen ændres, hvilket kræver en dialog med den, der ejer den pågældende basislinse.
Ingen af disse omkostninger er til forhandling pr. app, og det er byttehandlen. De giver afkald på noget frihed ved det første plugin og får den igen ved hvert eneste efterfølgende.
CONNECTION_SCOPE_EXCEEDED.MCP-værktøjer og -forbindelser
MCP optræder tre steder, og de er lette at forveksle.
Et plugin kan udgive MCP-værktøjer ved at deklarere dem i mcpTools[]: et name, en description og et inputSchema. Den ene regel, validatoren tilføjer, er, at et inputSchema ikke må bruge et oneOf, allOf eller anyOf på øverste niveau, fordi en kombinator øverst i skemaet får enhver MCP-klient, der importerer værktøjet, til at fejle med en 400-fejl. Et plugin på isolationLevel 2 kører som en mcp_container.
Skills Engines bibliotek kan tilgås over MCP. Claude Code og agenter bruger tretten MCP-værktøjer til at finde og matche færdigheder, køre dem og registrere kørslen samt oprette, importere eller synkronisere dem, og hvert kald kører som den person, der startede det, inden for vedkommendes tilladelsesliste.
Og et AI-kodningsværktøj forbinder gennem Workbench: én adresse pr. installation, et login gennem personens browser, et adgangspas på én time i stedet for en gemt nøgle og kun de værktøjer, personen krydser af. Kapitel 2.26, Udvikling med AI-kodningsværktøjer, gennemgår dette.
Connectors er den mere stille nabo. En domænepakkes vidensmodel fødes af skrivebeskyttede connectors til systemer såsom policeadministration eller et skadesystem, hver med en tidsplan og en testknap. Intet skrives tilbage til kilden.
Fra Deres branch til brugernes skærme
Uanset hvilket trin De befinder Dem på, er vejen til produktion den samme. Hver udgivelse flyttes fra Deres udviklingsområde til staging, derefter til en pilotenhed og til sidst til alle enheder, og hvert trin har spærringer: tests, et manifest der ikke er blevet udvidet, en prøvekørsel på en maskeret kopi og navngivne kontrollanter, som ikke er forfatteren. En promovering, der forsøger at springe et trin over, afvises med GATE_CANNOT_BE_SKIPPED. Hvert miljø beholder den forrige version i 30 dage, og at rulle én enhed tilbage er en kontrolleret ændring, der tager omkring et minut.
Selve udrulningen foregår udelukkende gennem installationens udgivelseskanaler. Enheder vælger deres kanal, og deres administrator godkender hver flytning. De ser antal og fejlrater pr. enhed på siden Kanaler og installationer, aldrig hvad nogen har brugt Deres udvidelse til. Kapitel 2.28, Udgivelse af Deres udvidelse, dækker udgivelsessiden fra ende til anden.
En bemærkning om udgaver
Det meste af denne stige findes på begge udgaver. Community får indstillinger og Skills Engine-færdigheder, plugins på alle niveauer og de samme anbefalede hovedveje (golden paths) på én server med kode hos Deres egen Git-udbyder. Enterprise tilføjer promoveringen fra udviklingsområde gennem staging til en pilotenhed med tilhørende spærringer samt udgiverklynger og maskerede kopier af produktionsdata. Den tilføjer også Deres eget private katalog og domænepakker. Kapitel 2.25, Udvikling til hver udgave, indeholder detaljerne.
Det næste kapitel er det, De bør læse, før De skriver nogen form for kode. Det har få valgmuligheder og mange regler, og reglerne er de samme for den første udvidelse og for nummer tusind.



