Logga inBoka en genomgång

Kapitel 2.18

Tilläggsmodellen

De sex sätten att utöka Nexus, från en inställning till ett domänpaket, gränserna för vart och ett samt hur förtroende- och isoleringsnivåer avgör var er kod körs. Läs detta innan ni öppnar programutvecklingspaketet (SDK).

Denna sida har översatts av AI från det engelska originalet. Om något är oklart är den engelska sidan referensen. Läs denna sida på engelska

16 minuters läsning

Det första jag byggde på Nexus hos Corrán Orbital var inte ett plugin. Vårt team för flygdynamik ville att assistenten skulle svara på ”vilka markstationspassager förlorar vi om Svalbard-antennen tas ur drift för underhåll?” på samma sätt varje gång, med passagetabellen först och kostnaden i kontaktminuter under. Jag ägnade en halv dag åt att läsa dokumentationen för software development kit (SDK) innan en kollega påpekade att det jag ville ha var en färdighet (skill): en mapp med en SKILL.md i sig, som laddades upp till Skills Engine och publicerades så snart testerna gick igenom och en granskare godkände den. Det tog fyrtio minuter.

Två plugins och ett domänpaket senare är det fortfarande det rådet jag ger först. Nexus har sex sätt att byggas ut, och de bildar en stege av arbetsinsats. De billiga stegpinnarna gör mer än man tror, och de dyra medför förpliktelser som är lätta att underskatta. Det här kapitlet går igenom stegen. Välj den lägsta stegpinnen som löser uppgiften. Kapitlen därefter går på djupet med var och en: kapitel 2.19, Reglerna som varje utbyggnad ärver; kapitel 2.20, Färdigheter; kapitel 2.21, Plugin-SDK:n; kapitel 2.22, Körtidsmiljön för plugins; och kapitel 2.23, Domänpaket.

De sex byggstenarna

Här är de i den ordning du bör överväga dem.

  1. Inställningar och policyer. Detta är värden som en administratör ställer in i konsolen för organisationen, en enhet eller en enskild person, inom ramen för vad licensen tillåter. Du skriver ingen kod alls.
  2. Skills Engine-färdigheter. Ett SKILL.md-paket som innehåller instruktioner och de verktyg som färdigheten får anropa, med valfria filer och skript bredvid. Assistenten, agenter, arbetsflöden och AI-knapparna (artificiell intelligens) på skärmarna kör alla samma färdigheter, och det gör även din IDE (integrerad utvecklingsmiljö).
  3. Plugins. Din egen kod, deklarerad av ett manifest och byggd med SDK:ns verktyg. Ett plugin finns i en av tre nivåer: skills-only, ui-only eller full-service.
  4. Domänpaket. En branschs linser och mallar, dess färdigheter och kunskapsmodell, dess anslutningar och dess mobilskärmar, licensierade som en enhet. Adverant levererar tio; du kan bygga dina egna.
  5. Linser. Vad en viss roll ser inuti ett paket eller en plattform. En lins begränsar en baslins och utvidgar den aldrig.
  6. MCP-anslutningar och kopplingar. De Model Context Protocol-verktyg (MCP) som ett plugin publicerar eller som ett AI-kodningsverktyg ansluter via, samt de skrivskyddade kopplingar som hämtar in poster från system som du redan kör.

Två begrepp används för flera saker, så låt mig reda ut dem nu. En Skills Engine-färdighet är ett SKILL.md-paket i biblioteket. En manifestfärdighet är en typad rad i ett plugins skills[]-array, som kompileras in i plattformens färdighetsregister och körs genom UNO, arbetsflödesmotorn. Båda kallas färdigheter (skills) på skärmen. De skrivs och styrs på olika sätt, och den här dokumentationen anger alltid vilken av dem som avses.

Starta något nytt
Starta något nytt
Starta något nytt erbjuder sex rekommenderade vägar (golden paths), en för varje typ av utbyggnad. Var och en skapar ett kodförråd från en versionshanterad mall med ett manifest som deklarerar vad den behöver, och sätter upp tester, en utvecklingsyta och datagrenar.

Vad var och en kan göra, och vad den inte kan

Tabellen är kortversionen. Jag har tagit med kolumnen ”Vad den inte kan göra” med flit: varje begränsning är en egenskap i designen, och var och en av dem har räddat mig från något.

Byggsten Vad den kan göra Vad den inte kan göra Vem som skapar den
Inställning eller policy Ändra hur en funktion beter sig på valfri nivå från organisationen ner till en enskild person; låsa ett värde; delegera det nedåt; kräva en andra person vid en ändring Lägga till en skärm eller en rutt, lagra en ny tabell eller starta en ny typ av arbete En administratör, i konsolen
Skills Engine-färdighet Ge assistenten och agenter, arbetsflöden och AI-knappar ett repeterbart sätt att utföra ett jobb, med egna instruktioner och testfall Innehålla en inloggningsuppgift; anropa ett verktyg utanför tillåtelselistan för den person som kör den (SKILL_CANNOT_WIDEN_TOOLS); tas i drift utan sina tester och godkännande Alla som har behörigheten, i skaparverktyget eller från sin IDE
Plugin, skills-only Publicera manifestfärdigheter som körs på plattformen: värd-callbacks, köat arbete, mappningar över en lista och, vid tillitsnivå core eller verified, modellbaserade färdigheter Leverera egna sidor En utvecklare, med SDK:n
Plugin, ui-only Lägga till en frontend-yta inuti skalet Lagra egen data eller köra beräkningar En utvecklare, med SDK:n
Plugin, full-service Egen backend och frontend, ett Postgres-schema, en ruttabell med rättigheter samt färdigheter och MCP-verktyg Anropa en modelleverantör; innehålla en modellnyckel; läsa en annan organisations rader utom genom ett registrerat tillstånd; köra beräkningar utanför UNO-dispatch En utvecklare, med SDK:n
Domänpaket Tillföra en branschs linser och mallar, dess färdigheter och arbetsflöden, en kunskapsmodell, en beviskarta och mobilskärmar till de enheter en administratör väljer Ändra skalet eller dess komponenter, eller skrivreglerna; köras utan att organisationens licens omfattar det Adverant, eller era egna utvecklare på Enterprise
Lins Välja vilka kort och fält en viss roll ser inuti ett paket eller en plattform, samt vilka åtgärder som erbjuds Visa något som dess baslins döljer (LENS_CANNOT_WIDEN); ändra vad en roll får göra En paketförfattare bygger den; en administratör tilldelar den per enhet
MCP-verktyg och kopplingar Exponera ett plugins verktyg för agenter och kodningsverktyg; läsa in poster från ett policysystem eller ett telemetriarkiv till kunskapsmodellen Skriva tillbaka till källsystemet genom en koppling; agera utöver den inloggade personens egna behörigheter En utvecklare deklarerar MCP-verktyg; en administratör konfigurerar kopplingar

Några av dessa rutor förtjänar ytterligare en mening.

Inställningar är ett ramverk, och varje plugin använder samma. Ett plugin som deklarerar ett settings-block i sitt manifest får nivåerna (plattform, organisation, paket, enhet, grupp, kodförråd, person), låsningar och delegering, en ändringslogg och godkännande av en andra person, helt utan att behöva skriva en inställningstabell. Det är därför den billigaste stegpinnen ofta räcker: om beteendet du vill ha redan finns och bara behöver ett annat värde för enheten i Rotterdam, är det en inställning.

En Skills Engine-färdighet körs som personen. Den innehåller aldrig en nyckel, och den kan bara nå verktyg inom tillåtelselistan för den som kör den och bara läsa det som den personen har behörighet att öppna. En färdighet som lägger till ett verktyg som skriver hålls kvar tills två personer godkänner den, och tas sedan i drift i skuggläge, därefter som kanariefågel (canary) och slutligen för alla.

Ett skills-only-plugin är den mittersta stegpinnen. Du behöver det när arbetet utgörs av kod du själv äger: en deterministisk beräkning, en köarbetare, en utgrenad körning (fan-out) över en lista. Plattformen anropar din kod; din kod anropar aldrig en modell.

Ett full-service-plugin är en liten produkt. Det äger ett Postgres-schema, en ruttabell med ett rättighetsregister, en frontend, en uppsättning databasroller och varje isoleringsförpliktelse i kapitel 2.19, Reglerna som varje utbyggnad ärver. Det är rätt svar oftare än man fruktar och fel svar oftare än man hoppas.

Vilken behöver jag?

Börja högst upp i den här tabellen och stanna vid den första raden som passar.

Du vill… Använd Varför inte något enklare
Ändra ett värde eller en gräns, eller vem som får göra något En inställning eller en policy Det finns inget enklare
Få assistenten att göra ett jobb på samma sätt varje gång En Skills Engine-färdighet En inställning kan inte innehålla instruktioner
Sätta en ”AI-knapp” på en skärm som kör det jobbet En Skills Engine-färdighet kopplad till knappen En knapp kör bara färdigheter; det finns inget att bygga
Låta ett AI-kodningsverktyg nå Nexus En MCP-anslutning via Workbench Inget att skriva; personen loggar in via sin webbläsare
Läsa in poster från ett befintligt system till kunskapsmodellen En skrivskyddad koppling En koppling skriver inget tillbaka, så den medför ingen skrivrisk
Köra deterministisk kod du äger enligt plattformens schema Ett skills-only-plugin med en host_callback- eller plugin_queue-färdighet En Skills Engine-färdighet kan inte köra din kod
Lägga till en skärm eller två inuti skalet Ett ui-only-plugin Endast plugins lägger till skärmar
Hålla dina egna poster bakom dina egna rutter och rättigheter Ett full-service-plugin Endast denna nivå äger ett schema
Ge en roll en mer avgränsad vy av en branschs skärmar En lins på ett befintligt paket En lins är data, inte kod
Tillföra en branschs kunskapsmodell och linser, med mobilskärmar, till flera enheter Ett domänpaket Ett enskilt plugin har inga linser eller licensspärrar

Hos Corrán Orbital förblev frågan om passageplanering en Skills Engine-färdighet. Banpropageringen den behöver blev ett skills-only-plugin med en host_callback-färdighet, eftersom det numeriska arbetet är vårt eget och måste ge samma svar två gånger. Vår granskningsnämnd för avvikelser blev ett full-service-plugin, eftersom det håller egna register över vem som tittade på vilken telemetriavvikelse och vad de beslutade. Paketet kom sist, när en andra enhet ville ha samma sak.

Hur delarna kombineras

Byggstenarna byggs på uppåt. Ett domänpaket är det tydligaste exemplet, eftersom det är ett paket av de andra plus en licensspärr:

  • en kunskapsmodell, de typer av saker branschen känner till och hur de hänger ihop, ofta byggd på en basmodell från ett annat paket;
  • linser, en per roll, där var och en begränsar en baslins;
  • mallar och arbetsflöden, samt de Skills Engine-färdigheter de anropar;
  • plugins där paketet behöver egen kod;
  • skrivskyddade kopplingar till de system som redan innehåller posterna;
  • ett mobillager som styr vilka kort och insamlingssteg som visas på telefoner;
  • och berättigandet: de funktionsgrupper licensen måste omfatta innan något av det slås på.
Rita en stapel av horisontella band. Längst ner, ”Nexus kärnfunktioner” (assistent, filer, minne, jobb) och bredvid det ”UNO-dispatch” och ”AI Provider Router”. Ovanför det, ett band ”Plugins” med två rutor, ”skills-only” och ”full-service”, samt ett band ”Skills Engine-färdigheter”. Ovanför dessa, en bred ruta ”Domänpaket” som innehåller fyra mindre rutor: ”Kunskapsmodell”, ”Linser”, ”Mallar och arbetsflöden”, ”Mobillager”. Till vänster om paketet, en ruta ”Skrivskyddade kopplingar” med en pil in i ”Kunskapsmodell”. Högst upp, tre enhetsrutor (”Rotterdam”, ”Felixstowe”, ”Huvudkontor”) med pilar ner från paketet märkta ”lins tilldelad per roll”. Ett hänglås på paketets kant är märkt ”licens: domain_packs”.
Hur ett domänpaket samlar de andra byggstenarna.

Inget av detta är applikationsspecifik infrastruktur. Paketet levererar ingen egen isoleringskod, ingen modellklient och ingen licenskontroll: det ärver plattformens. Det är ämnet för nästa kapitel, och det är anledningen till att en paketförfattare på en bank och en i en hamn skriver lika mycket säkerhetskod, vilket är ingen alls.

Branschpaket
Domänpaket
Sidan Domänpaket listar alla tio paketen med vad vart och ett behöver och var det körs. Ett paket som licensen inte omfattar förblir listat och utgråat, med information om vad det skulle kräva.

Förtroendenivåer

Varje plugin deklarerar en trust-nivå i sitt manifest. Tillit är inte en spärr som SDK:n kan prata sig förbi. Det är rådgivande metadata som plattformen läser för att avgöra hur isolerat ett plugins bidrag körs och den mest känsliga data dess färdigheter får röra. De skarpa spärrarna (klassificering och datalagringsplats, export och kostnad) ligger kvar exakt där de är.

Tillit Vem det är till för Isoleringsnivå Klassificeringstak
core Förstapartskod som levereras i plattformen none: samma ursprung (same-origin), ingen extra isolering restricted
verified En granskad tredje part, en verifierad utgivare same-origin-yta, förmedlade färdigheter restricted
community En ogranskad tredje part; standardvalet för ett nytt plugin sandboxed-yta, förmedlade färdigheter tenant
untrusted Allt från en okänd källa strict: yta i sandlåda, endast förmedlade färdigheter, ingen värdtillit public

Två regler följer av den tabellen, och create-nexus-plugin validate genomdriver båda innan något byggs.

För det första får en färdighets classification inte överstiga dess plugins tak. Klassificeringar rangordnas public, sedan tenant, sedan restricted. Ett community-plugin som deklarerar en restricted-färdighet misslyckas vid bygget.

För det andra får endast core- och verified-plugins deklarera färdigheter som når AI Provider Router. Det är nivåerna tool_using och llm_only. Ett community- eller untrusted-plugin förmedlar deterministiskt arbete (host_callback, plugin_queue och map över dessa) och ber plattformen att göra allt som kräver en modell. Mitt första plugin var community, och jag förlorade en eftermiddag på att försöka deklarera en llm_only-sammanfattningsfärdighet innan jag förstod att nekandet var själva poängen.

Om du utelämnar trust behandlar SDK:n pluginet som community. Ett utelämnat fält kan aldrig innebära en uppflyttning i behörighet.

Isoleringsnivåer 1 till 4

Separat från tillit anger manifestets runtime-block hur pluginet körs. isolationLevel är ett heltal från 1 till 4, och körningsläget följer av det. Du väljer inte de två oberoende av varandra: validatorn härleder den ena från den andra och nekar ett manifest vars par inte stämmer överens.

isolationLevel executionMode Vad det innebär
1 external_https Pluginet körs utanför installationen och nås över HTTPS
2 mcp_container En container som exponerar MCP-verktyg
3 hardened_docker En härdad container i pluginets egna poddar; mallens standardval
4 firecracker En microVM, den starkaste separeringen
"runtime": {
  "nodeVersion": "20",
  "executionMode": "hardened_docker",
  "isolationLevel": 3,
  "entrypoint": "dist/server.js",
  "healthCheck": "/health"
}

entrypoint är obligatoriskt. Startpunkter (entrypoints) är levererade artefakter och hämtas aldrig vid körning: SDK:n har ingen väg för dynamisk import eller fjärrinläsning överhuvudtaget, så tillit skrivs ner och kontrolleras en gång, fryses sedan och laddas aldrig ner.

Vad ni åtar er på varje steg

Varje stegpinne ovanför inställningar kostar något att underhålla. Här är vad var och en kostar dig.

  • En Skills Engine-färdighet behöver testfall, en granskare som inte är du själv och en versionshistorik som du kommer att få frågor om när den beter sig felaktigt. Samma byte publiceras aldrig två gånger (CONTENT_HASH_ALREADY_PUBLISHED), så att ”bara ladda upp den igen” är inte en lösning.
  • Ett plugin behöver ett manifest vars ruttabell matchar de rutter din kod registrerar, i båda riktningarna. En rutt som finns men inte är deklarerad är ett efterlevnadsfel, och detsamma gäller en deklarerad rutt som koden aldrig registrerar.
  • Ett full-service-plugin äger ett schema med fem databasroller, säkerhet på radnivå (row-level security) påtvingad på varje tabell, och en uppstart som vägrar att lyssna förrän databasen bevisar att gränsskyddet håller. Det upprepar också de tre plattformslagarna i sitt manifest, ord för ord.
  • Ett domänpaket är licensierat. Det slås på för en enhet i taget, genom en pilot, och organisationens licens måste omfatta det. Du kan inte själv bestämma att en kund har det.
  • En lins kan bara ta bort. Om en roll behöver se mer måste baslinsen ändras, vilket kräver en dialog med den som äger den basen.

Ingen av dessa kostnader kan förhandlas bort per app, vilket är själva avvägningen. Du ger upp lite frihet på det första pluginet och får tillbaka den på varje plugin därefter.

Installera ett tredjepartsplugin
Installera ett tredjepartsplugin
Att installera ett tredjepartsplugin fungerar som appbehörigheter. Varje omfattning (scope) som dess manifest deklarerar beviljas eller nekas per enhet, och ett anrop för något det inte har deklarerat nekas med CONNECTION_SCOPE_EXCEEDED.

MCP-verktyg och anslutningar

MCP dyker upp på tre ställen, och de är lätta att blanda ihop.

Ett plugin kan publicera MCP-verktyg genom att deklarera dem i mcpTools[]: ett name, en description och ett inputSchema. Den enda regeln som validatorn lägger till är att ett inputSchema inte får använda oneOf, allOf eller anyOf på toppnivå, eftersom en kombinator högst upp i schemat får varje MCP-klient som importerar verktyget att misslyckas med felkod 400. Ett plugin på isolationLevel 2 körs som en mcp_container.

Skills Engines bibliotek kan nås över MCP. Claude Code och agenter använder tretton MCP-verktyg för att hitta och matcha färdigheter, köra dem och registrera körningen, samt skapa, importera eller synkronisera dem, och varje anrop körs som den person som startade det, inom dennes tillåtelselista.

Och ett AI-kodningsverktyg ansluter via Workbench: en adress per installation, en inloggning via personens webbläsare, ett entimmespass i stället för en lagrad nyckel, och endast de verktyg som personen kryssar för. Kapitel 2.26, Bygga med AI-kodningsverktyg, går igenom detta.

Kopplingar är den tystare grannen. Ett domänpakets kunskapsmodell matas av skrivskyddade kopplingar till system såsom försäkringsadministration eller ett skadesystem, var och en med ett schema och en testknapp. Ingenting skrivs tillbaka till källan.

Plugins och MCP-synkronisering
Plugins och MCP-synkronisering
Plugins och MCP-synkronisering visar vilka plugins som tillför färdigheter, vilka synkroniseringar som nekades i sin helhet, samt de tretton MCP-verktyg som Claude Code och agenter använder för att nå biblioteket.

Från er gren till användarnas skärmar

Oavsett vilken stegpinne du befinner dig på är vägen till produktion densamma. Varje version flyttas från din utvecklingsyta till staging, sedan till en pilotenhet och därefter till alla enheter, och varje steg har spärrar: tester, ett manifest som inte har utvidgats, en provkörning på en maskerad kopia samt namngivna granskare som inte är författaren. En uppflyttning som försöker hoppa över ett steg nekas med GATE_CANNOT_BE_SKIPPED. Varje miljö behåller den föregående versionen i 30 dagar, och att rulla tillbaka en enhet är en granskad ändring som tar ungefär en minut.

Själva driftsättningen går uteslutande genom installationens lanseringskanaler. Enheter väljer sin kanal, och deras administratör godkänner varje förflyttning. Du ser antal och felfrekvenser per enhet på sidan Kanaler och installationer, aldrig vad någon har gjort med din utbyggnad. Kapitel 2.28, Lansera din utbyggnad, täcker lanseringssidan från början till slut.

En notering om utgåvor

Det mesta av den här stegen finns i båda utgåvorna. Community får inställningar och Skills Engine-färdigheter, plugins på alla nivåer och samma rekommenderade vägar (golden paths) på en server med kod i din egen Git-värd. Enterprise lägger till uppflyttningen från utvecklingsyta via staging till en pilotenhet med dess spärrar, plus utgivarkluster och maskerade kopior av skarp data. Det lägger också till din egen privata katalog samt domänpaket. Kapitel 2.25, Bygga för respektive utgåva, innehåller detaljerna.

Nästa kapitel är det du bör läsa innan du skriver någon kod. Det har få valmöjligheter och många regler, och reglerna är desamma för den första utbyggnaden som för den tusende.