PrijavaZakažite brifing

Poglavlje 2.18

Model proširenja

Šest načina proširivanja sistema Nexus, od podešavanja do domenskog paketa, ograničenja svakog od njih i kako nivoi poverenja i izolacije određuju gde se Vaš kod izvršava. Pročitajte ovo pre nego što otvorite komplet za razvoj softvera (SDK).

Ovu stranicu je sa engleskog originala prevela AI tehnologija. Ako nešto nije jasno, merodavna je stranica na engleskom. Pročitajte ovu stranicu na engleskom

16 min čitanja

Prva stvar koju sam napravio na platformi Nexus u kompaniji Corrán Orbital nije bio plugin. Naš tim za dinamiku leta želeo je da asistent na pitanje „koje prelete zemaljske stanice gubimo ako antena na Svalbardu bude isključena radi održavanja?“ svaki put odgovara u istom obliku, sa tabelom preleta na prvom mestu i troškom u minutima kontakta ispod nje. Proveo sam pola dana čitajući komplet za razvoj softvera (SDK) pre nego što mi je kolega ukazao da mi je zapravo potreban skill: fascikla sa SKILL.md u njoj, otpremljena u Skills Engine i objavljena kada su njeni testovi prošli i kada ju je recenzent odobrio. Trajalo je četrdeset minuta.

Dva plugina i jedan domenski paket kasnije, to je i dalje prvi savet koji dajem. Nexus se može proširiti na šest načina, a oni su raspoređeni na lestvici uloženog truda. Jeftine prečke postižu više nego što ljudi očekuju, a skupe nose obaveze koje je lako potceniti. Ovo poglavlje prikazuje tu lestvicu. Izaberite najnižu prečku koja obavlja posao. Poglavlja nakon njega detaljno obrađuju svaku od njih: poglavlje 2.19, Pravila koja nasleđuje svako proširenje; poglavlje 2.20, Skills; poglavlje 2.21, Plugin SDK; poglavlje 2.22, Okruženje za izvršavanje pluginova; i poglavlje 2.23, Domenski paketi.

Šest gradivnih blokova

Evo ih redosledom kojim bi trebalo da ih razmotrite.

  1. Podešavanja i politike. To su vrednosti koje administrator postavlja u konzoli za organizaciju, jedinicu ili jednu osobu, u okviru onoga što licenca dozvoljava. Ne pišete nikakav kod.
  2. Skills Engine skillovi. Paket SKILL.md koji sadrži uputstva i alate koje skill sme da poziva, uz opcione datoteke i skripte pored njih. Asistent, agenti, tokovi rada i AI (veštačka inteligencija) dugmad na ekranima pokreću iste skillove, kao i Vaš IDE (integrisano razvojno okruženje).
  3. Pluginovi. Vaš sopstveni kod, deklarisan manifestom i napravljen alatima iz SDK-a. Plugin pripada jednom od tri nivoa: skills-only, ui-only ili full-service.
  4. Domenski paketi. Lensovi i šabloni jedne industrije, njeni skillovi i model znanja, konektori i ekrani za telefon, licencirani kao celina. Adverant isporučuje deset; možete napraviti i sopstveni.
  5. Lensovi. Ono što jedna uloga vidi unutar paketa ili platforme. Lens sužava osnovni lens i nikada ga ne proširuje.
  6. MCP veze i konektori. Alati protokola Model Context Protocol (MCP) koje plugin objavljuje ili preko kojih se povezuje AI alat za programiranje, kao i konektori samo za čitanje koji preuzimaju zapise iz sistema koje već koristite.

Dve reči imaju previše značenja, pa ću ih sada precizno odrediti. Skills Engine skill je paket SKILL.md u biblioteci. Manifest skill je tipizirani red u nizu skills[] jednog plugina, preveden u registar skillova platforme i izvršen preko UNO, mehanizma za tokove rada. Na ekranu se oba nazivaju skillovima. Pišu se i regulišu na različite načine, a ova dokumentacija uvek navodi na koji se odnosi.

Započnite nešto novo
Započnite nešto novo
Opcija Započnite nešto novo nudi šest preporučenih putanja, po jednu za svaku vrstu proširenja. Svaka pravi repozitorijum iz verzionisanog šablona sa manifestom koji deklariše šta mu je potrebno i postavlja testove, razvojni prostor i grane podataka.

Šta svaki od njih može da uradi, a šta ne može

Tabela je kratka verzija. Kolonu „ne može“ namerno sam uključio: svako ograničenje je svojstvo dizajna i svako od njih me je od nečega sačuvalo.

Gradivni blok Šta može Šta ne može Ko ga pravi
Podešavanje ili politika Promeniti ponašanje funkcije na bilo kom nivou, od organizacije do jedne osobe; zaključati vrednost; delegirati je naniže; zahtevati drugu osobu za odobrenje promene Dodati ekran ili rutu, čuvati novu tabelu ili pokrenuti novu vrstu posla Administrator, u konzoli
Skills Engine skill Dati asistentu i agentima, tokovima rada i AI dugmadi ponovljiv način da obave jedan posao, sa sopstvenim uputstvima i test slučajevima Čuvati akreditive; pozvati alat izvan liste dozvoljenih alata osobe koja ga pokreće (SKILL_CANNOT_WIDEN_TOOLS); postati aktivan bez svojih testova i odobrenja Svako ko ima odgovarajuće pravo, u alatu za kreiranje ili iz svog IDE-a
Plugin, skills-only Objaviti manifest skillove koji se izvršavaju na platformi: povratne pozive hosta, posao u redu čekanja, mapiranja preko liste i, uz nivo poverenja core ili verified, skillove zasnovane na modelu Posluživati sopstvene stranice Programer, uz SDK
Plugin, ui-only Dodati frontend površinu unutar okvira aplikacije Čuvati sopstvene podatke ili izvršavati obradu Programer, uz SDK
Plugin, full-service Sopstveni backend i frontend, Postgres šemu, tabelu ruta sa pravima, kao i skillove i MCP alate Pozvati dobavljača modela; čuvati ključ modela; čitati redove druge organizacije osim preko evidentiranog odobrenja; izvršavati obradu izvan UNO raspoređivanja Programer, uz SDK
Domenski paket Doneti lensove i šablone jedne industrije, njene skillove i tokove rada, model znanja, mapu dokaza i ekrane za telefon u jedinice koje administrator izabere Promeniti okvir aplikacije ili njegove komponente, ili pravila pisanja; raditi ako ga licenca organizacije ne obuhvata Adverant ili Vaši sopstveni programeri na planu Enterprise
Lens Izabrati kartice i polja koje jedna uloga vidi unutar paketa ili platforme, kao i radnje koje nudi Prikazati bilo šta što njegov osnovni lens skriva (LENS_CANNOT_WIDEN); promeniti šta uloga sme da radi Autor paketa ga pravi; administrator ga dodeljuje po jedinici
MCP alati i konektori Učiniti alate plugina dostupnim agentima i alatima za programiranje; čitati zapise iz sistema polisa ili arhive telemetrije u model znanja Upisivati nazad u izvorni sistem preko konektora; delovati izvan dozvola prijavljene osobe Programer deklariše MCP alate; administrator podešava konektore

Nekoliko ovih ćelija zaslužuje još jednu rečenicu.

Podešavanja su okvir i svaki plugin koristi isti. Plugin koji u svom manifestu deklariše blok settings dobija nivoe (platforma, organizacija, paket, jedinica, grupa, repozitorijum, osoba), zaključavanje i delegiranje, evidenciju promena i odobrenje druge osobe, sve bez pisanja tabele podešavanja. Zato je najjeftinija prečka često dovoljna: ako ponašanje koje želite već postoji i samo mu je potrebna drugačija vrednost za jedinicu u Roterdamu, to je podešavanje.

Skills Engine skill se izvršava kao osoba. Nikada ne čuva ključ, može da pristupi samo alatima sa liste dozvoljenih alata osobe koja ga pokreće i da čita samo ono što ta osoba sme da otvori. Skill koji dodaje alat koji upisuje podatke zadržava se dok ga dve osobe ne odobre, zatim postaje aktivan u režimu senke, potom u canary režimu, pa za sve.

Plugin skills-only je srednja prečka. Potreban Vam je kada je posao kod koji posedujete: deterministički proračun, obrađivač reda čekanja, raspodela preko liste. Platforma poziva Vaš kod; Vaš kod nikada ne poziva model.

Plugin full-service je mali proizvod. Poseduje Postgres šemu, tabelu ruta sa registrom prava, frontend, skup uloga u bazi podataka i svaku obavezu izolacije iz poglavlja 2.19, Pravila koja nasleđuje svako proširenje. To je ispravan odgovor češće nego što se ljudi plaše i pogrešan odgovor češće nego što se nadaju.

Koji mi je potreban?

Počnite od vrha ove tabele i zaustavite se na prvom redu koji odgovara.

Želite da… Koristite Zašto ne nešto lakše
Promenite vrednost ili ograničenje, ili ko sme nešto da uradi Podešavanje ili politiku Ništa lakše ne postoji
Naterate asistenta da jedan posao svaki put obavi na isti način Skills Engine skill Podešavanje ne može da sadrži uputstva
Postavite „AI dugme“ na ekran koje pokreće taj posao Skills Engine skill povezan sa dugmetom Dugme samo pokreće skillove; nema šta da se pravi
Omogućite AI alatu za programiranje pristup platformi Nexus MCP vezu preko Workbench-a Nema šta da se piše; osoba se prijavljuje preko svog pregledača
Čitate zapise iz postojećeg sistema u model znanja Konektor samo za čitanje Konektor ništa ne upisuje nazad, pa ne nosi rizik od upisa
Izvršavate deterministički kod koji posedujete po rasporedu platforme Plugin skills-only sa skillom host_callback ili plugin_queue Skills Engine skill ne može da izvršava Vaš kod
Dodate ekran ili dva unutar okvira aplikacije Plugin ui-only Samo pluginovi dodaju ekrane
Čuvate sopstvene zapise iza sopstvenih ruta i prava Plugin full-service Samo ovaj nivo poseduje šemu
Date jednoj ulozi uži prikaz ekrana jedne industrije Lens na postojećem paketu Lens je podatak, a ne kod
Donesete model znanja i lensove jedne industrije, sa ekranima za telefon, u nekoliko jedinica Domenski paket Sam plugin nema lensove niti proveru licence

U kompaniji Corrán Orbital pitanje planiranja preleta ostalo je Skills Engine skill. Propagacija orbite koja mu je potrebna postala je plugin skills-only sa jednim skillom host_callback, jer je numerički rad naš i mora dvaput dati isti odgovor. Naš odbor za pregled anomalija postao je plugin full-service, jer vodi sopstvenu evidenciju o tome ko je pregledao koje odstupanje telemetrije i šta je odlučio. Paket je došao poslednji, kada je druga jedinica poželela isto.

Kako se delovi kombinuju

Gradivni blokovi se slažu naviše. Domenski paket je najjasniji primer, jer je skup ostalih blokova uz proveru licence:

  • model znanja, vrste stvari koje industrija poznaje i način na koji su povezane, često izgrađen na osnovnom modelu iz drugog paketa;
  • lensovi, po jedan za svaku ulogu, od kojih svaki sužava osnovni lens;
  • šabloni i tokovi rada, kao i Skills Engine skillovi koje pozivaju;
  • pluginovi tamo gde je paketu potreban sopstveni kod;
  • konektori samo za čitanje ka sistemima koji već sadrže zapise;
  • mobilni sloj koji određuje koje se kartice i koraci unosa prikazuju na telefonima;
  • i pravo korišćenja: grupe funkcija koje licenca mora da obuhvata pre nego što se bilo šta od toga uključi.
Nacrtajte niz horizontalnih traka. Na dnu je „Osnovne funkcije Nexus platforme“ (asistent, datoteke, memorija, poslovi), a pored nje „UNO dispatch“ i „AI Provider Router“. Iznad nje je traka „Dodaci“ sa dva polja, „samo veštine“ i „potpuna usluga“, i traka „Veštine Skills Engine“. Iznad njih je široko polje „Domenski paket“ koje sadrži četiri manja polja: „Model znanja“, „Sočiva“, „Šabloni i tokovi rada“, „Mobilni sloj“. Levo od paketa je polje „Konektori samo za čitanje“ sa strelicom ka „Model znanja“. Na vrhu su tri polja jedinica („Rotterdam“, „Felixstowe“, „Sedište“) sa strelicama naniže od paketa označenim „sočivo dodeljeno po ulozi“. Katanac na ivici paketa označen je sa „licenca: domain_packs“.
Kako domenski paket objedinjuje ostale gradivne blokove.

Ništa od ovoga nije infrastruktura specifična za aplikaciju. Paket ne isporučuje sopstveni kod za izolaciju, klijent modela niti proveru licence: nasleđuje ih od platforme. To je tema sledećeg poglavlja i razlog zbog kog autor paketa u banci i autor paketa u luci pišu istu količinu bezbednosnog koda, a to je nimalo.

Domenski paketi
Domenski paketi
Stranica Domenski paketi navodi svih deset paketa, sa onim što je svakom potrebno i gde se izvršava. Paket koji licenca ne obuhvata ostaje na listi, zasivljen, uz navođenje onoga što bi mu bilo potrebno.

Nivoi poverenja

Svaki plugin u svom manifestu deklariše nivo trust. Poverenje nije kapija koju SDK može da zaobiđe. To su savetodavni metapodaci koje platforma čita da bi odlučila koliko izolovano se izvršavaju doprinosi plugina i koji su najosetljiviji podaci kojima njegovi skillovi smeju da pristupe. Aktivne kapije (klasifikacija i lokacija podataka, izvoz i potrošnja) ostaju tačno tamo gde jesu.

Poverenje Kome je namenjen Režim izolacije Gornja granica klasifikacije
core Kod prve strane koji se isporučuje u okviru platforme none: isto poreklo, bez dodatne izolacije restricted
verified Proverena treća strana, verifikovani izdavač Površina same-origin, posredovani skillovi restricted
community Neproverena treća strana; podrazumevano za novi plugin Površina sandboxed, posredovani skillovi tenant
untrusted Bilo šta iz nepoznatog izvora strict: površina u izolovanom okruženju, isključivo posredovani skillovi, bez poverenja hosta public

Iz te tabele proizlaze dva pravila, a create-nexus-plugin validate sprovodi oba pre nego što se bilo šta izgradi.

Prvo, classification skilla ne može da premaši gornju granicu njegovog plugina. Klasifikacije se rangiraju redom public, zatim tenant, zatim restricted. Izgradnja plugina community koji deklariše skill restricted ne uspeva.

Drugo, samo pluginovi core i verified smeju da deklarišu skillove koji pristupaju usmerivaču AI dobavljača (AI Provider Router). To su nivoi tool_using i llm_only. Plugin community ili untrusted posreduje u determinističkom radu (host_callback, plugin_queue i map nad njima) i traži od platforme da uradi sve što zahteva model. Moj prvi plugin bio je community i izgubio sam jedno popodne pokušavajući da deklarišem skill za sažetak llm_only pre nego što sam shvatio da je odbijanje upravo i bila poenta.

Ako izostavite trust, SDK tretira plugin kao community. Izostavljeno polje nikada ne može biti unapređenje.

Nivoi izolacije od 1 do 4

Nezavisno od poverenja, blok runtime u manifestu određuje kako se plugin izvršava. isolationLevel je ceo broj od 1 do 4, a režim izvršavanja proizlazi iz njega. Ne birate ih nezavisno: validator izvodi jedno iz drugog i odbija manifest čiji se par ne slaže.

isolationLevel executionMode Šta znači
1 external_https Plugin se izvršava izvan instalacije i pristupa mu se preko HTTPS-a
2 mcp_container Kontejner koji izlaže MCP alate
3 hardened_docker Ojačani kontejner u sopstvenim podovima plugina; podrazumevano u šablonu
4 firecracker MicroVM, najjače razdvajanje
"runtime": {
  "nodeVersion": "20",
  "executionMode": "hardened_docker",
  "isolationLevel": 3,
  "entrypoint": "dist/server.js",
  "healthCheck": "/health"
}

entrypoint je obavezan. Ulazne tačke su isporučeni artefakti i nikada se ne preuzimaju tokom izvršavanja: SDK uopšte nema putanju za dinamički uvoz ili udaljeno učitavanje, tako da se poverenje zapisuje i proverava jednom, zatim zamrzava, i nikada ne preuzima.

Na šta se obavezujete na svakom stepeniku

Svaka prečka iznad podešavanja ima svoju cenu održavanja. Evo koliko Vas košta svaka od njih.

  • Veština u okviru Skills Engine zahteva test slučajeve, recenzenta koji niste Vi i istoriju verzija o kojoj će Vas pitati kada se ponaša neispravno. Isti bajtovi se nikada ne objavljuju dvaput (CONTENT_HASH_ALREADY_PUBLISHED), pa „samo je ponovo otpremite“ nije rešenje.
  • Dodatak zahteva manifest čija se tabela ruta poklapa sa rutama koje Vaš kod registruje, u oba smera. Ruta koja postoji, a nije deklarisana, predstavlja neusaglašenost, kao i deklarisana ruta koju kod nikada ne registruje.
  • Dodatak tipa full-service poseduje šemu sa pet uloga u bazi podataka, bezbednošću na nivou redova nametnutom za svaku tabelu i pokretanjem koje odbija da prihvata zahteve dok baza podataka ne dokaže da zaštita važi. On takođe u svom manifestu doslovno ponavlja tri zakona platforme.
  • Domenski paket je licenciran. Uključuje se jedna po jedna jedinica, kroz pilot, a licenca organizacije mora da ga obuhvata. Nije na Vama da odlučite da ga klijent ima.
  • Sočivo može samo da oduzima. Ako uloga treba da vidi više, mora se promeniti osnovno sočivo, a to zahteva razgovor sa onim ko je vlasnik te osnove.

Nijedan od ovih troškova ne može se pregovarati po aplikaciji, i u tome je kompromis. Odričete se dela slobode pri prvom dodatku, a vraćate je kod svakog sledećeg.

Instalirajte dodatak treće strane
Instalirajte dodatak treće strane
Instaliranje dodatka treće strane funkcioniše kao dozvole aplikacija. Svaki opseg koji njegov manifest deklariše odobrava se ili uskraćuje po jedinici, a poziv za bilo šta što nije deklarisao odbija se sa CONNECTION_SCOPE_EXCEEDED.

MCP alati i konekcije

MCP se pojavljuje na tri mesta i lako ih je pomešati.

Dodatak može da objavljuje MCP alate tako što ih deklariše u mcpTools[]: name, description i inputSchema. Jedino pravilo koje validator dodaje jeste da inputSchema ne sme da koristi oneOf, allOf ili anyOf na najvišem nivou, jer kombinator na vrhu šeme dovodi do toga da svaki MCP klijent koji uveze alat ne uspe sa greškom 400. Dodatak na isolationLevel 2 izvršava se kao mcp_container.

Biblioteka Skills Engine je dostupna preko MCP. Claude Code i agenti koriste trinaest MCP alata da pronađu i upare veštine, pokrenu ih i zabeleže izvršavanje, kao i da ih kreiraju, uvezu ili sinhronizuju, a svaki poziv se izvršava u ime osobe koja ga je pokrenula, unutar njene liste dozvola.

Takođe, AI alat za programiranje povezuje se preko Workbench okruženja: jedna adresa po instalaciji, prijava preko pregledača te osobe, propusnica od jednog sata umesto sačuvanog ključa i samo alati koje ta osoba označi. Poglavlje 2.26, Razvoj uz AI alate za programiranje, objašnjava ovo korak po korak.

Konektori su tiši sused. Model znanja domenskog paketa napajaju konektori samo za čitanje ka sistemima kao što su administracija polisa ili sistem za odštetne zahteve, svaki sa rasporedom i dugmetom za testiranje. Ništa se ne upisuje nazad u izvor.

Dodaci i MCP sinhronizacija
Dodaci i MCP sinhronizacija
Stranica Dodaci i MCP sinhronizacija prikazuje koji dodaci donose veštine, koje sinhronizacije su odbijene u celini i trinaest MCP alata koje Claude Code i agenti koriste za pristup biblioteci.

Od vaše grane koda do ekrana korisnika

Na kojoj god prečki da se nalazite, put do produkcije je isti. Svako izdanje prelazi iz Vašeg razvojnog prostora u staging, zatim u pilot jedinicu, pa u sve jedinice, a svaki korak ima kapije: testove, manifest koji nije proširen, probno pokretanje na maskiranoj kopiji i imenovane recenzente koji nisu autor. Promocija koja pokuša da preskoči korak odbija se sa GATE_CANNOT_BE_SKIPPED. Svako okruženje čuva prethodnu verziju 30 dana, a vraćanje jedne jedinice predstavlja recenziranu izmenu koja traje oko minut.

Samo raspoređivanje odvija se isključivo kroz kanale izdanja instalacije. Jedinice biraju svoj kanal, a njihov administrator odobrava svaki prelazak. Na stranici Kanali i instalacije vidite brojeve i stope grešaka po jedinici, ali nikada ono što je bilo ko uradio sa Vašim proširenjem. Poglavlje 2.28, Objavljivanje Vašeg proširenja, pokriva stranu izdanja od početka do kraja.

Napomena o izdanjima

Veći deo ove lestvice postoji u oba izdanja. Community dobija podešavanja i veštine Skills Engine, dodatke na svim nivoima i iste preporučene puteve na jednom serveru, sa kodom na Vašem sopstvenom Git hostu. Enterprise dodaje promociju iz razvojnog prostora preko staginga do pilot jedinice sa njenim kapijama, kao i klastere izdavača i maskirane kopije podataka iz produkcije. Takođe dodaje Vaš sopstveni privatni katalog i domenske pakete. Poglavlje 2.25, Razvoj za svako izdanje, sadrži detalje.

Sledeće poglavlje treba pročitati pre nego što napišete bilo kakav kod. Ima malo izbora, a mnogo pravila, i pravila su ista za prvo proširenje kao i za hiljadito.