AnmeldenBriefing buchen

Kapitel 2.27

Build-Szenarien

Ein Kochbuch mit dreizehn Builds, von einem einzelnen Skill bis zur Air-Gapped-Auslieferung. Jedes Rezept nennt das Ziel, die Bausteine, die Schritte und Befehle, das Gate, das den Erfolg beweist, und was sich je nach Edition und Auslieferungsform ändert.

Diese Seite wurde mithilfe von KI aus dem englischen Original übersetzt. Bei Unklarheiten gilt die englische Seite als Referenz. Diese Seite auf Englisch lesen

25 Minuten Lesezeit

Dies sind die Rezepte, auf die ich zurückgreife, wenn jemand bei Corrán Orbital oder bei einem Kunden sagt: „Wir möchten, dass Nexus X erledigt.“ Jedes ist bewusst kurz gehalten. Die Begründung hinter den Schritten finden Sie in den vorangehenden Kapiteln: Kapitel 2.20, Skills, und Kapitel 2.21, The Plugin SDK, das das Software Development Kit behandelt, dann Kapitel 2.23, Domain Packs, sowie die drei darauffolgenden Kapitel zum Erstellen. Hier erhalten Sie das Ziel, die zu verwendenden Bausteine, die Schritte, die Befehle, das Gate, das Ihnen zeigt, dass es funktioniert hat, sowie die Hinweise zu Edition und Auslieferung.

Das Gate ist am wichtigsten. Ein Rezept ist fertig, wenn sein Gate grün ist. Jedes Gate in diesem Kapitel ist etwas, das Sie ausführen können oder das die Plattform für Sie ausführt, und jedes endet mit einem Exit-Code ungleich null oder lehnt mit einem Code ab, wenn es nicht erfüllt ist.

Szenario Hauptbaustein Das Gate, das es belegt Edition
Ein neuer Skills-Engine-Skill SKILL.md-Paket skill:validate mit null Fehlern Community und Enterprise
Ein Manifest-Skill mit host_callback Plugin-Manifest skills[] create-nexus-plugin validate und nexus-gates Community und Enterprise
Ein bestehendes Pack erweitern pack.json mit inherits Lens-Richtlinienprüfung am Pilot-Gate Enterprise und eine Pack-Lizenz
Ein neues Pack von Grund auf Golden Path für Domain Packs Staging- und Pilot-Gates Enterprise
Ein Datenkonnektor plugin_queue-Skill validate, nexus-gates, Ablehnung ausgehender Verbindungen Community und Enterprise
Ein MCP-Tool (Model Context Protocol) Manifest mcpTools[] validate (keine Kombinatoren auf oberster Ebene) Community und Enterprise
Eine White-Label-Storefront Manifest domains und branding Öffentliche Regel von scope-adherence Enterprise und das Storefront-Add-on
Ein Edge-Mission-Pack Mission Pack Testfälle an Bord, zwei von drei Signaturen Enterprise und das Add-on Nexus Edge
Eine Air-Gap-Auslieferung Versiegeltes Bundle nexus-airgap verify Enterprise
Ein reines Enterprise-Modul @adverant/nexus-spi Lizenzgrenzen-Gate, Editions-Builds Enterprise
Den Open Core forken oder erweitern Der Community-Quellcode Tests, Lint und Typprüfung Community
Eine Cloud-App für die Team-Edition Publisher-Cluster Signiertes Release, Review, Freigabe für den Kunden Team
Eine bestehende interne App einbinden /plugin-create migrate, validate, nexus-gates Community und Enterprise
Ein Entscheidungsbaum, von oben nach unten gelesen. Die erste Raute fragt „Muss ständig Code laufen?“. „Nein“ führt zu einer Raute „Sind es Anweisungen für einen Assistenten?“, deren „Ja“ bei „Skills-Engine-Skill“ endet und deren „Nein“ bei „Linse auf ein bestehendes Paket“ endet. „Ja“ führt zu einer Raute „Ist es die Sicht einer Branche auf die Plattform?“, deren „Ja“ bei „Domänenpaket (mit seinem Plugin)“ endet und deren „Nein“ zu einer letzten Raute „Muss es geschlossen und lizenziert bleiben?“ führt, die bei „Ja“ in „Enterprise-Modul“ und bei „Nein“ in „Plugin“ endet.
Von welchem Baustein Sie ausgehen sollten.

1. Ein neuer Skills-Engine-Skill

Das Ziel ist eine wiederverwendbare Anweisung, die der Assistent, Agenten, Workflows und Entwicklerwerkzeuge gleichermaßen ausführen können, etwa die Prüfung einer Zollanmeldung anhand ihrer Regeln. Ihre Bausteine sind ein SKILL.md-Paket in einem nach dem Skill benannten Ordner, eine optionale skill.yaml für Trigger und Tags sowie ein optionaler, mitgelieferter scripts/-Ordner.

  1. Legen Sie skills/<slug>/ an und schreiben Sie SKILL.md mit Frontmatter: name (Kebab-Case, identisch mit dem Ordnernamen), description (bis zu 500 Zeichen), allowed-tools und optional triggers, capabilities und version.
  2. Schreiben Sie den Hauptteil für das Modell: wann der Skill zu verwenden ist, seine Schritte, Beispiele und was er niemals tun darf.
  3. Fügen Sie Testfälle hinzu. Nehmen Sie einen auf, bei dem in der Eingabe eine Anweisung platziert ist, der der Skill nicht folgen darf.
  4. Validieren Sie, prüfen Sie den Upload-Plan und laden Sie dann hoch.
  5. Veröffentlichen Sie. Ein Skill, der ein schreibendes Tool hinzufügt, wird zurückgehalten, bis zwei namentlich benannte Personen ihn mit Passkeys genehmigen; wer die Änderung vorschlägt, kann sie nicht selbst genehmigen.
npm run skill:validate skills/check-a-customs-filing
npm run skill:upload skills/check-a-customs-filing --dry-run
npm run skill:upload skills/check-a-customs-filing

Das Gate ist skill:validate, das null Fehler melden muss, bevor etwas veröffentlicht werden kann. Die blockierenden Fehler sind ein fehlender Name oder eine fehlende Beschreibung sowie ein doppelter Slug oder Job-Typ. Das Hochladen bereits veröffentlichter Inhalte gibt die vorhandene Version zurück (CONTENT_HASH_ALREADY_PUBLISHED), sodass der Upload gefahrlos wiederholt werden kann.

Community erhält den vollständigen Creator, die Bibliothek, Versionen, das Zurückwechseln, den Import und Tests. Bei Enterprise durchläuft die Veröffentlichung zusätzlich Shadow und Canary: Die genehmigte Version läuft zunächst im Shadow-Modus, dann für eine Einheit hinter benannten Gates, dann für alle, und sie stoppt sich selbst, wenn ein Gate nicht erfüllt ist. Für Kunden mit Air-Gap gelangen Skills vorsigniert im versiegelten Bundle zu ihnen (Szenario 9).

2. Ein Manifest-Skill mit host_callback

Das Ziel ist deterministische Berechnung in Ihrem eigenen Plugin, die die Plattform auslösen kann, etwa das Anlegen eines Abweichungsdatensatzes aus einem Messwert. Sie verwenden eine Zeile im skills[] des Manifests mit der Stufe host_callback sowie eine /internal-Route in Ihrem Backend, die durch den Service-Guard des SDK geschützt ist.

  1. Deklarieren Sie den Skill: id in lower_snake, tier: "host_callback", ein classification auf oder unterhalb der Vertrauensobergrenze Ihres Plugins, inputSchema, outputSchema und ein timeoutMs zwischen 1 Sekunde und 6 Stunden.
  2. Füllen Sie hostCallback aus: Ihren eigenen Service-Namen, seinen Port, einen relativen Pfad wie /internal/skills/excursion_open, beide Byte-Obergrenzen (maxRequestBytes und maxResponseBytes) sowie tenantHeader: "X-Organization-ID".
  3. Deklarieren Sie die Route in api.endpoints[] mit auth: "service-key" oder auth: "internal" und schützen Sie sie mit requireService oder serviceMiddleware, niemals mit dem Guard für den Benutzer-Scope.
  4. Validieren Sie, führen Sie die Gates aus und lassen Sie das Onboarding die Skills über compileRegistry mit der Registry synchronisieren. Registry-SQL schreiben Sie nie von Hand.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-test

validate wendet die eigenen Regeln der Registry-Synchronisierung an, bevor etwas synchronisiert wird; jeder Verstoß wird mit dem Code des Empfängers abgelehnt. Ein Pfad mit einem Schema, // oder einem Backslash wird als Cross-Origin abgelehnt. Eine fehlende Byte-Obergrenze ergibt ENDPOINT_BYTE_CAP_REQUIRED, ein Feld aus einer anderen Stufe FIELD_NOT_FOR_TIER und ein Timeout außerhalb des Bereichs TIMEOUT_OUT_OF_BOUNDS. Anschließend prüft nexus-gates, dass die /internal-Route den Service-Guard trägt und als internal oder service-key deklariert ist. Dieses Gate-Paar ist der Nachweis.

Die Synchronisierung ist deklarativ. Senden Sie jedes Mal den vollständigen Skill-Satz, da ein ausgelassener Skill deaktiviert wird, und lassen Sie Ihren Deploy-Schritt bei jedem Status außer 200 fehlschlagen. Bei Enterprise wird eine Plugin-Synchronisierung als Ganzes geprüft: Verstößt ein Skill gegen eine Regel, wird nichts aus dieser Synchronisierung übernommen (PLUGIN_SYNC_ALL_OR_NOTHING), und die vorherige Version läuft weiter. Ein Plugin mit Community-Vertrauensstufe kann die Stufen, die ein Modell erreichen, tool_using und llm_only, nicht verwenden; diese erfordern die Vertrauensstufe core oder verified.

Plugins und MCP-Synchronisierung
Plugins und MCP-Synchronisierung
Plugins, die Skills mitbringen, und worauf jede Synchronisierung geprüft wurde. Beachten Sie das Plugin, dessen Synchronisierung als Ganzes abgelehnt wurde, weil einer seiner fünf Skills eine Stufe nutzte, die nur die Plattform hosten darf, während seine vorherige Version weiterlief.

3. Ein bestehendes Pack erweitern

Das Ziel ist eine neue Branche oder Teilbranche, die den Großteil eines bestehenden Packs wiederverwendet, etwa Kreditvergabe und Kartenstreitfälle auf Basis der Struktur des Insurance-Packs. Der Baustein ist ein pack.json, das sein übergeordnetes Pack in inherits benennt und nur seine eigenen Lens-Cluster und Begriffe hinzufügt.

  1. Beginnen Sie das Pack mit dem Golden Path für Domain Packs und setzen Sie dann inherits auf die ID des übergeordneten Packs.
  2. Fügen Sie Ihre eigenen lens-Cluster hinzu, jeweils mit ihren Plätzen, ihrem Zweck und ihrem Lexikonverweis.
  3. Fügen Sie Ihre Begriffe dem Lexikon hinzu, jeweils mit einer einfachen Erläuterung. Kennzeichnen Sie einen Begriff als exact, wenn er exakt wie geschrieben angezeigt werden muss.
  4. Verwenden Sie gemeinsame Lenses wieder, statt eigene zu entwerfen: Ein Regelwerk, das mehrere Packs benötigen, etwa ein Register ausgelagerter Technologie, ist eine gemeinsame Lens.
  5. Prüfen Sie die Lizenzkette. Ihr Pack erbt die Add-on-Anforderungen seines übergeordneten Packs.
  6. Zeigen Sie jede Lens in der Vorschau als eine Person auf einem synthetischen Branch an.
{ "id": "fintech", "name": "Banking and payments", "version": "0.1", "inherits": "insurance" }

Der Nachweis ist die Richtlinienprüfung am Pilot-Gate, die bestätigt, dass jede Lens ihre Basis nur einschränkt und personenbezogene Felder standardmäßig ausgeblendet lässt. Eine Lens, die anzuzeigen versucht, was ihre Basis verbirgt, wird mit LENS_CANNOT_WIDEN abgelehnt. Auf der Lizenzseite verweigert die Konsole die Ausstellung einer Lizenz für Ihr Pack ohne die Add-ons, die sein übergeordnetes Pack benötigt; das Insurance-Pack benötigt Decision Rooms und versiegelte Datensätze.

Domain Packs sind Enterprise und werden pro Pack lizenziert. Die Smartphone-Bildschirme eines Packs benötigen zusätzlich das Add-on Mobile Apps. Ein untergeordnetes Pack kann weder die Shell noch die Komponenten oder die Schreibregeln ändern.

4. Ein neues Pack von Grund auf

Das Ziel ist die Sicht einer Branche auf Nexus: ihr Wissensmodell, die Lenses für jede Rolle, die Nachweise, die ihre Regeln verlangen, und das Plugin, das ihre Daten aktuell hält. Kapitel 2.24, Building a custom vertical end to end, führt vollständig durch diesen Aufbau; hier folgt die Kurzfassung.

  1. Durchlaufen Sie den Golden Path für Domain Packs und beschreiben Sie das Pack: Zweck, Einheiten, das Basismodell und die Regeln, die es abbildet.
  2. Bauen Sie das Wissensmodell auf einem Basismodell auf und klassifizieren Sie jede Eigenschaft, sobald Sie sie hinzufügen.
  3. Lesen Sie den Plan, bestätigen Sie seinen Fingerprint mit Ihrem Passkey und erstellen Sie ihn.
  4. Gestalten Sie die Lenses im Lens Builder, wobei jede eine Basis-Lens einschränkt.
  5. Schreiben Sie das Plugin und alle Skills-Engine-Skills, die das Pack benötigt.
  6. Erzeugen Sie geseedete synthetische Daten mit den Sonderfällen, die Ihnen wichtig sind, und zeigen Sie jede Lens in der Vorschau als eine Person an.
  7. Stufen Sie vom Dev-Space nach Staging hoch, dann in eine Piloteinheit und anschließend in alle Einheiten.

Der Nachweis sind die Promotion-Gates: alle Tests auf den synthetischen Branches bestanden für Staging, dann zwei Reviewer, die nicht der Autor sind, dann 14 Tage im Pilotbetrieb mit Fehlern unter 1 zu 1.000. Kein Schritt kann übersprungen werden (GATE_CANNOT_BE_SKIPPED). Packs sind Enterprise. Bei Community wird der Golden Path für Domain Packs nicht angeboten.

5. Ein Datenkonnektor

Das Ziel sind Daten aus einem externen System, die nach Zeitplan in die eigenen Tabellen Ihres Plugins fließen, etwa Gate-Ereignisse aus einem Terminal-Betriebssystem. Die Bausteine sind ein plugin_queue-Skill, ein Worker, der Ihre Queue abarbeitet, eine Migration für die Zieltabelle und eine im Manifest deklarierte ausgehende Adresse.

  1. Deklarieren Sie einen plugin_queue-Skill mit queueName in der Schreibweise <plugin name>.<name>. Ein Doppelpunkt ist nicht zulässig, und der Name muss im Manifest stehen, da der Orchestrator direkt in diese Queue einreiht.
  2. Schreiben Sie den Worker, der die Queue abarbeitet und das externe System aufruft.
  3. Deklarieren Sie die Adresse des externen Systems als ausgehende Adresse. Alles, was nicht aufgeführt ist, wird blockiert.
  4. Speichern Sie eingehende Daten in Ihrem eigenen Schema, mit organization_id, owner_user_id und business_unit_id in jeder Zeile.
  5. Lesen Sie die Zugangsdaten des externen Systems namentlich aus der Umgebung und führen Sie die Variable in scripts/ci/required-env auf.
  6. Lösen Sie die Abrufe über UNO, die Workflow-Engine, aus, niemals mit einem Timer, der Engines direkt aufruft.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --only no-credentials --only no-direct-compute --only migrations-are-scoped
node scripts/ci/required-env

validate prüft den Queue-Namen und das Timeout anhand der Regeln der Registry-Synchronisierung. Die drei Gates belegen, dass keine Modell-Zugangsdaten, keine direkte Berechnung und eine korrekt eingegrenzte Tabelle vorliegen. Führen Sie vor dem Push den vollständigen nexus-gates aus, da --only den Lauf eingrenzt und dies in seiner Zusammenfassung angibt. Zur Laufzeit wird ein Aufruf an eine Adresse, die das Manifest nicht deklariert hat, am Edge mit EGRESS_NOT_DECLARED gestoppt.

Die eigenen Konnektoren der Plattform zu Laufwerken, Wikis, Mail-Speichern und Altsystemen, mit Change Capture und Lineage, sind im Add-on Data Connectors enthalten. Ein selbst erstellter Konnektor ist ein Plugin und funktioniert in jeder Edition. Das Hinzufügen einer ausgehenden Adresse in einem späteren Release ist eine Erweiterung und wird zurückgehalten, bis zwei Reviewer sie akzeptieren.

6. Ein MCP-Tool

Das Ziel ist ein Tool, das Claude Code, Agenten und andere MCP-Clients (Model Context Protocol) aufrufen können, etwa zum Abrufen der Inspektionshistorie eines Schiffs. Der Baustein ist ein Eintrag im mcpTools[] des Manifests mit einem name, einem description und einem inputSchema.

  1. Benennen Sie das Tool und beschreiben Sie es klar. Die Beschreibung ist das, was ein Modell liest, um zu entscheiden, ob es das Tool aufruft.
  2. Schreiben Sie das inputSchema als ein einziges Objektschema. Setzen Sie oneOf, allOf oder anyOf nicht auf dessen oberste Ebene.
  3. Halten Sie die Route, die das Tool bereitstellt, wie jede andere /api-Route hinter dem Scope-Guard, sodass die Mandantenzuordnung aus dem Token des Aufrufers stammt.
  4. Validieren Sie das Manifest.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json

Der Nachweis ist validate: Ein Kombinator auf oberster Ebene wird bereits beim Erstellen abgelehnt, da er zur Laufzeit das Tool für jeden MCP-Subagenten, der es importiert, scheitern ließe und das Tool zwar existieren würde, aber niemand es aufrufen könnte.

Bei Enterprise wird jedes Tool, das eine IDE (integrierte Entwicklungsumgebung) aufrufen kann, im Workbench-Toolkatalog aufgeführt, mit seiner Stufe, der Angabe, ob es Änderungen vornimmt, einem fixierten Fingerprint und den Rollen, die es verwenden dürfen. Ändert sich die Beschreibung Ihres Tools in einem neuen Release, hält der Katalog das Tool zurück, bis eine Person die Änderung prüft. Das ist beabsichtigt: Eine geänderte Beschreibung ist der Weg, auf dem ein Tool beginnen kann, ein Modell um etwas zu bitten, was es nicht sollte. Ein Aufruf von etwas außerhalb der Berechtigung des Aufrufers wird mit CONNECTION_SCOPE_EXCEEDED abgelehnt.

7. Eine White-Label-Storefront

Das Ziel ist eine App, die die Kunden Ihres Kunden nutzen, auf der Domain des Kunden und in seinem Branding, ohne jede Spur von Adverant. Die Bausteine sind die Blöcke domains und branding des Manifests, die Anmelde-Hilfsfunktionen des SDK und das Add-on Storefront / White-Label des Kunden.

  1. Tragen Sie die Domain des Kunden in domains[] als primary ein, mit etwaigen aliases.
  2. Füllen Sie branding aus: appName, tagline, primaryColor, accentColor, ein passkeyRpId identisch mit der Domain, und oauthClientRef.
  3. Melden Sie Personen über die Anmelde-Hilfsfunktionen des SDK an und deklarieren Sie deren zwei öffentliche Routen exakt, mit auth: "public" und allowAnonymous: true.
  4. Leiten Sie jeden Frontend-Aufruf über den Allow-List-Proxy des Backend for Frontend. Tragen Sie niemals eine Service-Adresse in den Client ein.
  5. Überlassen Sie Zahlungen dem Administrator des Kunden, der Gateways anbindet und den gebrandeten Checkout einrichtet.
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --only scope-adherence --only api-contract

Der Nachweis ist scope-adherence. Es lässt eine ungeschützte /api-Route nur zu, wenn das Manifest genau diese Methode und diesen Pfad als öffentlich deklariert und der Pfad eine der Anmelderouten ist; jede andere öffentliche Deklaration schlägt fehl und nennt die beiden zulässigen Pfade. api-contract gleicht anschließend die deklarierten Routen in beide Richtungen mit den tatsächlichen ab. definePlugin lehnt außerdem ein frontend.basePath ab, das kein relativer Pfad mit gleichem Ursprung ist.

White-Label ist das Add-on Storefront / White-Label in Enterprise, das auch Zahlungen lizenziert. Kartendaten berühren Nexus nie. Die Marke gehört dem Administrator des Kunden, und die Plattform ermittelt sie aus der Organisation statt aus Ihrem Code.

8. Ein Edge Mission Pack

Ziel ist eine neue oder aktualisierte Mission für einen Satelliten oder eine Drohne mit Nexus Edge, etwa das Hinzufügen eines Schiffsfinder-Adapters zu einer maritimen Überwachungsmission. Der Baustein ist ein Missionspaket, das am Boden erstellt und signiert wird.

  1. Beginnen Sie mit dem aktuellen Paket auf der Seite „Missionspaket erstellen“, die die neue Version aus der alten entwirft und jede Änderung kennzeichnet.
  2. Ändern Sie nur, was die Mission benötigt. Halten Sie die großen Teile, das Sprachmodell und die Ontologie, nach Möglichkeit stabil.
  3. Prüfen Sie die Platzierungstabelle bei jeder Degradationsstufe, damit jede Platine weiterhin zu dem passt, was sie ausführt.
  4. Führen Sie die On-Board-Testfälle des Pakets auf einem Prüfstand mit denselben Platinen aus.
  5. Senden Sie es zur Signierung: Zwei von drei Signaturen sind erforderlich.
  6. Geben Sie es für eine Plattform frei. Es wird in den freien Slot geladen und erst aktiviert, nachdem seine Testfälle an Bord bestanden sind.
  7. Rollen Sie es nach einer fehlerfreien Woche auf die nächste Plattform aus.
Missionspakete
Missionspakete
Die Bibliothek der Missionspakete, mit dem Inhalt jedes Pakets und den Plattformen, auf denen es läuft. Beachten Sie die ältere Version, die für eine Rückkehr an Bord vorgehalten wird, und die Anzahl der Testfälle, die jedes Paket auf seiner Hardware bestehen muss.

Dieses Rezept enthält keine Befehle; es wird auf den Nexus-Edge-Seiten der Konsole umgesetzt. Der Nachweis sind die On-Board-Testfälle, die alle bestanden sein müssen, bevor das Paket aktiviert wird, sowie die beiden Signaturen. Schlägt ein Test an Bord fehl, bleibt die Plattform bei ihrem vorherigen Paket, und der Fehler wird beim nächsten Überflug übertragen. Die Installation eines Pakets auf Hardware, für die es nicht geprüft wurde, wird mit PACK_NOT_CHECKED_FOR_HARDWARE abgelehnt.

Nexus Edge ist ein Add-on, lizenziert pro Plattform oder pro Flotte. Pakete bleiben gültig, solange eine Plattform keinen Kontakt hat. Die Uplink-Verbindung ist schmal, planen Sie die Größen daher entsprechend: Unser Release 1.5 umfasste 412 MB, gegenüber 9.8 GB für ein Paket mit einem neuen Sprachmodell.

9. Eine Air-Gapped-Auslieferung an einen Kunden

Ziel ist Ihr Plugin oder Paket, installiert an einem Kundenstandort ohne Netzwerk. Die Bausteine sind ein versiegeltes Bundle aus @adverant/nexus-sovereign, Ihr Release-Signaturschlüssel und die eigenen Release-Kanäle des Kunden.

  1. Erstellen Sie das Plugin und seine Images genau wie für einen verbundenen Kunden, mit allen Gates auf Grün.
  2. Erstellen Sie ein versiegeltes Bundle mit dem Profil airgap, das die Images, Migrationen, vorsignierten Skills und eine SBOM (Software-Stückliste) mit den Lizenzen enthält.
  3. Signieren Sie es mit Ihrem Ed25519-Release-Schlüssel.
  4. Verifizieren Sie es selbst auf einem sauberen Rechner.
  5. Senden Sie das Bundle auf einem Datenträger, und senden Sie Ihren öffentlichen Schlüssel und den SHA-256 des Bundles auf einem separaten Weg.
  6. Der Betreiber des Kunden verifiziert das Bundle mit Ihrem Schlüssel und bringt das Release dann über seine eigenen Release-Kanäle ein.
nexus-airgap bundle
nexus-airgap verify --bundle cold-chain-0.4.0.tar.gz --trusted-key corran-release.pub.pem --profile airgap

nexus-airgap bundle erstellt das Bundle aus Ihrer Bundle-Konfiguration. Der Nachweis ist nexus-airgap verify auf Kundenseite. Es berechnet für jede Datei den Hash neu, weist jede Datei zurück, die das Manifest nicht aufführt, verlangt einen vertrauenswürdigen Signierer und lehnt ein Bundle ab, dessen Netzwerk-Allowlist nicht leer ist. Eine veränderte Datei schlägt mit BUNDLE_INTEGRITY_VIOLATION fehl. Niemand sollte jemals die strikte Prüfung abschalten, um dies zu umgehen.

Air-Gapped-Installationen sind Enterprise. Nichts im Bundle darf bei der Installation etwas abrufen, und ein Modell, das das Plugin benötigt, stammt vom eigenen Modellserver des Kunden über den KI-Provider-Router (künstliche Intelligenz).

10. Ein reines Enterprise-Modul

Ziel ist eine geschlossene, lizenzierte Funktion, die an den offenen Kern andockt, etwa ein Audit-Trail mit langer Aufbewahrung, der nur an Enterprise-Kunden verkauft wird. Der Baustein ist das Schnittstellenpaket @adverant/nexus-spi und nichts anderes aus Community.

  1. Führen Sie eine bytegenau fixierte Kopie des erstellten Schnittstellenpakets in Ihrem Repository als lokales file:-Paket mit seinem SHA256SUMS-Pin mit.
  2. Schreiben Sie dagegen ein RouteModule (oder ein ScreenModule für Konsolenansichten), mit der Funktionsgruppe, der es dient.
  3. Führen Sie jede Route hinter ctx.requireScope aus, und prüfen Sie vor der Antwort die eigene Berechtigung des Moduls.
  4. Lehnen Sie mit LICENCE_LOCKED ab, wenn die Organisation nicht berechtigt ist, und zeigen Sie die Vorschau der Funktion an, niemals ihre Daten.
  5. Halten Sie das Repository an der Lizenzgrenze, und erstellen Sie dann den zusammengesetzten Baum jeder Edition.
npm ci
npm test
npm run build

Der Nachweis ist die Lizenzgrenzen-Regel: kein Import aus einem Community-Scope außer dem Schnittstellenpaket, kein relativer Import aus dem Repository heraus und keine Abhängigkeit von file:, link: oder workspace: außerhalb davon. Anschließend müssen die drei obigen Befehle in jedem zusammengesetzten Editionsbaum bestehen, nicht nur in Ihrem Arbeitsbaum. Kapitel 2.25, Erstellen für jede Edition, enthält das Modulgerüst.

Ein Modul wird beim Start in einen Community-Dienst geladen, auf Installationen, deren Lizenz seine Funktionsgruppe enthält. Ohne diese Berechtigung verweigert es den Dienst, sodass derselbe Build überall ausgeliefert wird und dort, wo er nicht lizenziert ist, nichts tut.

11. Den Open Core forken oder erweitern

Ziel ist eine Änderung an Community selbst, die in Ihrem Fork verbleibt oder zurückgegeben wird. Der Baustein ist der Community-Quellcode unter der Apache License, Version 2.0.

  1. Forken Sie das Repository und verzweigen Sie von main.
  2. Bevorzugen Sie ein Plugin oder einen Skill, wenn sich Ihr Vorhaben so umsetzen lässt. Eine Änderung am Kern müssen Sie bei jedem Release selbst pflegen.
  3. Nehmen Sie die Änderung mit Tests vor, die ohne sie fehlschlagen.
  4. Führen Sie die Prüfungen des Projekts aus, bevor Sie etwas vorschlagen.
  5. Behalten Sie die NOTICE-Datei bei, und verwenden Sie die Namen oder Marken von Adverant nur, um anzugeben, woher die Arbeit stammt.
git checkout -b feature/your-change
npm test
npm run lint
npm run typecheck

Der Nachweis besteht darin, dass diese drei Prüfungen bestehen, sowie im Beleg, dass jeder neue Test vor Ihrer Änderung fehlschlug. Bewahren Sie in Ihrem Fork eine Eigenschaft des offenen Kerns: Community führt einen Agenten vollständig auf einem lokalen Modell aus, ohne Schlüssel und ohne Netzwerk. Eine Änderung, die das bricht, bricht das, was Community eigenständig nutzbar macht.

Dies gilt nur für Community. Alles, was geschlossen bleiben muss, gehört stattdessen in ein Enterprise-Modul (Szenario 10), damit die Lizenzgrenze an einer Stelle bleibt, auf die jeder zeigen kann.

12. Eine Cloud-App der Team-Edition

Ziel ist eine App, die Team-Kunden installieren können. Team läuft nur in der Adverant-Cloud, daher erreicht die App sie nur über den Katalog. Die Bausteine sind ein Plugin und ein Publisher-Cluster: Ihr eigener virtueller Cluster in der Adverant-Cloud mit Beispieldaten.

  1. Erstellen und testen Sie auf dem Publisher-Cluster, ausschließlich mit Beispieldaten.
  2. Deklarieren Sie im Manifest alles, was die App benötigt, und nichts darüber hinaus.
  3. Geben Sie sie signiert frei, zur Prüfung durch Adverant und für einen Katalogeintrag.
  4. Jeder Kunde installiert sie und erteilt jeden deklarierten Scope Einheit für Einheit.

Der Nachweis besteht aus zwei Teilen. Das signierte, geprüfte Release bringt Sie in den Katalog. Danach entscheidet die Berechtigung des Kunden, was die App an seinem Standort erreichen kann, und jeder nicht deklarierte Aufruf wird mit CONNECTION_SCOPE_EXCEEDED abgelehnt. Einen fehlenden Scope können Sie nur in einem neuen Release hinzufügen, das der Kunde prüft.

Ein Drittanbieter-Plugin installieren
Ein Drittanbieter-Plugin installieren
Ein Administrator installiert ein Drittanbieter-Plugin, erteilt jeden deklarierten Scope pro Einheit und lässt einen aus. Die Tafel zeigt einen Aufruf, den das Plugin nie deklariert hat, abgelehnt.

Ein Publisher-Cluster hat keine Verbindung zu einem Kunden, und eine Anfrage nach Kundendaten wird dort mit TENANT_BOUNDARY abgelehnt. Kunden können Testergebnisse mit Ihnen teilen, niemals ihre Daten. Team umfasst die Funktion für Workflow-Betrieb, sodass Team-Kunden Workflows, die Ihre App mitliefert, selbst zwischen Umgebungen übertragen können.

13. Eine bestehende interne App als Plugin einbinden

Ziel ist eine App, die Ihr Unternehmen bereits betreibt, in Nexus übernommen, damit sie Anmeldung, Isolation und Governance erbt. Die Bausteine sind der Skill /plugin-create für den ersten Entwurf sowie die Manifest-Werkzeuge und Gates des SDK für die Fertigstellung.

  1. Führen Sie /plugin-create mit dem Repository aus. Es analysiert den Code, wählt eine Wrapping-Strategie und generiert dann Backend, Migrationen, Benutzeroberfläche (UI), Manifest und Tests.
  2. Heben Sie das Manifest auf den v2-Vertrag an. migrate fügt die drei Gesetzessätze hinzu und verschiebt domain nach domains[], und es weigert sich, einen Einstiegspunkt zu erfinden.
  3. Ersetzen Sie jeden Mandantenwert, den der Wrapper aus Headern liest, durch den Scope-Guard des SDK.
  4. Fügen Sie jeder Tabelle organization_id, owner_user_id und business_unit_id hinzu, mit Primärschlüsseln, die mit dem Mandanten beginnen.
  5. Deklarieren Sie jede Route mit ihrem Recht, und installieren Sie das Ablehnungsprotokoll.
  6. Führen Sie die Gates aus, bis sie grün sind.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin migrate nexus.manifest.json --write
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-test

Der Nachweis ist, dass nexus-gates mit 0 beendet wird und scope-adherence, one-fence, migrations-are-scoped, crud-adherence und api-contract alle bestehen. Rechnen Sie damit, dass der erste Lauf bei den meisten fehlschlägt; bei uns wurde jede Route als ohne Scope gemeldet, weil der Entwurf Headern vertraute, die der Browser setzen konnte. Die Gates haben bewusst keinen Korrekturschalter.

Gewrappte Apps funktionieren in jeder Edition. Die Bereitstellung erfolgt nur über die Release-Kanäle der Installation, ignorieren Sie daher alle Bereitstellungsdateien, die der Entwurf geschrieben hat. Die Isolationsarbeit kostet die meiste Zeit: Planen Sie bei einer echten App Tage ein, nicht Stunden.