PrijavaRezervirajte predstavitev

Poglavje 2.18

Model razširitev

Šest načinov za razširitev sistema Nexus, od nastavitve do domenskega paketa, omejitve vsakega izmed njih ter kako ravni zaupanja in izolacije določajo, kje se izvaja vaša koda. Preberite to, preden odprete komplet za razvoj programske opreme (SDK).

To stran je iz angleškega izvirnika prevedla UI. Če je karkoli nejasno, je referenca angleška stran. Preberite to stran v angleščini

16 min branja

Prva stvar, ki sem jo v podjetju Corrán Orbital zgradil na platformi Nexus, ni bil vtičnik. Naša ekipa za dinamiko letov je želela, da pomočnik na vprašanje »katere prelete nad zemeljsko postajo izgubimo, če gre antena na Svalbardu v vzdrževanje?« vsakič odgovori v enaki obliki, s tabelo preletov na prvem mestu in stroškom v kontaktnih minutah pod njo. Pol dneva sem bral komplet za razvoj programske opreme (SDK), preden me je sodelavec opozoril, da potrebujem veščino: mapo z SKILL.md v njej, naloženo v Skills Engine in objavljeno, ko uspešno prestane preizkuse in jo odobri pregledovalec. Vzelo mi je štirideset minut.

Dva vtičnika in en domenski paket pozneje je to še vedno nasvet, ki ga dam najprej. Nexus ponuja šest načinov za razširitev, ki so razporejeni po lestvici zahtevnosti. Nižje stopničke zmorejo več, kot ljudje pričakujejo, višje pa prinašajo obveznosti, ki jih je zlahka podceniti. To poglavje predstavi to lestvico. Izberite najnižjo stopničko, ki opravi nalogo. Naslednja poglavja podrobno obravnavajo vsako izmed njih: poglavje 2.19, Pravila, ki jih podeduje vsaka razširitev; poglavje 2.20, Veščine; poglavje 2.21, SDK za vtičnike; poglavje 2.22, Izvajalno okolje vtičnikov; in poglavje 2.23, Domenski paketi.

Šest gradnikov

Tukaj so navedeni v vrstnem redu, v katerem bi jih morali obravnavati.

  1. Nastavitve in pravilniki. To so vrednosti, ki jih skrbnik nastavi v konzoli za organizacijo, enoto ali posameznika v okviru tega, kar dovoljuje licenca. Pri tem sploh ne pišete kode.
  2. Veščine v okolju Skills Engine. Paket SKILL.md, ki vsebuje navodila in orodja, ki jih veščina lahko kliče, ter izbirne datoteke in skripte ob njih. Pomočnik, agenti, delovni tokovi in gumbi UI (umetne inteligence) na zaslonih izvajajo iste veščine, prav tako pa tudi vaše IDE (integrirano razvojno okolje).
  3. Vtičniki. Vaša lastna koda, deklarirana z manifestom in zgrajena z orodji SDK. Vtičnik je na voljo v eni od treh ravni: skills-only, ui-only ali full-service.
  4. Domenski paketi. Pogledi in predloge posamezne panoge, njene veščine in model znanja, njeni konektorji in zasloni za telefone, licencirani kot celota. Adverant jih dobavlja deset; zgradite pa lahko tudi lastne.
  5. Pogledi. Tisto, kar posamezna vloga vidi znotraj paketa ali platforme. Pogled zoži osnovni pogled in ga nikoli ne razširi.
  6. Povezave MCP in konektorji. Orodja protokola Model Context Protocol (MCP), ki jih objavi vtičnik ali prek katerih se poveže orodje za programiranje z UI, ter bralni konektorji, ki uvažajo zapise iz sistemov, ki jih že uporabljate.

Dva izraza imata več pomenov, zato ju razjasnimo kar zdaj. Veščina Skills Engine je paket SKILL.md v knjižnici. Manifestna veščina je tipizirana vrstica v polju skills[] vtičnika, prevedena v register veščin platforme in izvedena prek UNO, pogona za delovne tokove. Obe se na zaslonu imenujeta veščini. Pišejo in upravljajo se različno, ta dokumentacija pa vedno navede, katero ima v mislih.

Začnite nekaj novega
Začnite nekaj novega
Možnost Začnite nekaj novega ponuja šest zlatih poti, po eno za vsako vrsto razširitve. Vsaka ustvari repozitorij iz različene predloge z manifestom, ki deklarira, kaj potrebuje, ter nastavi preizkuse, razvojni prostor in podatkovne veje.

Kaj vsak gradnik zmore in česa ne

Tabela predstavlja kratko različico. Stolpec »česa ne zmore« sem dodal namenoma: vsaka omejitev je lastnost zasnove in prav vsaka izmed njih me je že pred nečim rešila.

Gradnik Kaj zmore Česa ne zmore Kdo ga ustvari
Nastavitev ali pravilnik Spremeniti delovanje funkcionalnosti na kateri koli ravni od organizacije do posameznika; zakleniti vrednost; jo delegirati navzdol; zahtevati potrditev druge osebe ob spremembi Dodati zaslon ali usmerjevalno pot, shraniti novo tabelo ali začeti novo vrsto dela Skrbnik v konzoli
Veščina Skills Engine Pomočniku, agentom, delovnim tokovom in gumbom UI zagotoviti ponovljiv način za izvedbo posamezne naloge z lastnimi navodili in testnimi primeri Hraniti poverilnice; klicati orodje zunaj seznama dovoljenih orodij osebe, ki jo zažene (SKILL_CANNOT_WIDEN_TOOLS); preiti v produkcijo brez preizkusov in odobritve Kdor koli z ustreznimi pravicami, v ustvarjalniku ali iz svojega okolja IDE
Vtičnik, skills-only Objaviti manifestne veščine, ki se izvajajo na platformi: povratne klice gostitelja, delo v čakalni vrsti, preslikave čez seznam ter pri stopnji zaupanja core ali verified veščine, podprte z modeli Streči lastne strani Razvijalec z orodjem SDK
Vtičnik, ui-only Dodati čelno površino znotraj lupine Shranjevati lastne podatke ali izvajati računske operacije Razvijalec z orodjem SDK
Vtičnik, full-service Lasten zaledni in čelni del, shemo Postgres, usmerjevalno tabelo s pravicami ter veščine in orodja MCP Klicati ponudnika modela; hraniti ključ modela; brati vrstice druge organizacije, razen prek zabeležene odobritve; izvajati računske operacije zunaj razporejevalnika UNO Razvijalec z orodjem SDK
Domenski paket Prenesti poglede in predloge panoge, njene veščine in delovne tokove, model znanja, zemljevid dokazil in zaslone za telefone v enote, ki jih izbere skrbnik Spremeniti lupino ali njene komponente ali pravila pisanja; se izvajati, ne da bi ga vključevala licenca organizacije Adverant ali vaši lastni razvijalci v izdaji Enterprise
Pogled Izbrati kartice in polja, ki jih posamezna vloga vidi znotraj paketa ali platforme, ter dejanja, ki jih ponuja Prikazati kar koli, kar njegov osnovni pogled skriva (LENS_CANNOT_WIDEN); spremeniti, kaj sme vloga početi Zgradi ga avtor paketa; skrbnik ga dodeli po posameznih enotah
Orodja MCP in konektorji Izpostaviti orodja vtičnika agentom in orodjem za programiranje; brati zapise iz sistema pravilnikov ali telemetričnega arhiva v model znanja Zapisovati nazaj v izvorni sistem prek konektorja; delovati prek lastnih dovoljenj prijavljene osebe Razvijalec deklarira orodja MCP; skrbnik nastavi konektorje

Nekaj teh celic si zasluži še dodaten stavek.

Nastavitve so ogrodje in vsak vtičnik uporablja istega. Vtičnik, ki v svojem manifestu deklarira blok settings, dobi ravni (platforma, organizacija, paket, enota, skupina, repozitorij, oseba), zaklepanja in delegiranje, dnevnik sprememb in odobritev druge osebe, vse brez pisanja tabele nastavitev. Zato najcenejša stopnička pogosto zadostuje: če želeno delovanje že obstaja in potrebuje le drugačno vrednost za enoto v Rotterdamu, je to nastavitev.

Veščina Skills Engine se izvaja v imenu osebe. Nikoli ne hrani ključa, doseže pa lahko le orodja na seznamu dovoljenih orodij tistega, ki jo zažene, in bere le tisto, kar ta oseba sme odpreti. Veščina, ki doda orodje za zapisovanje, je zadržana, dokler je ne odobrita dve osebi, nato preide v senčno izvajanje, zatem v kanarčkovo in nazadnje postane na voljo vsem.

Vtičnik skills-only je srednja stopnička. Potrebujete ga, ko delo predstavlja vaša lastna koda: deterministični izračun, delavec čakalne vrste, razvejanje čez seznam. Platforma kliče vašo kodo; vaša koda nikoli ne kliče modela.

Vtičnik full-service je majhen produkt. Ima lastno shemo Postgres, usmerjevalno tabelo z registrom pravic, čelni del, nabor vlog podatkovne baze in vse izolacijske obveznosti iz poglavja 2.19, Pravila, ki jih podeduje vsaka razširitev. Je pravilna izbira pogosteje, kot se ljudje bojijo, in napačna izbira pogosteje, kot ljudje upajo.

Katerega potrebujem?

Začnite na vrhu te tabele in se ustavite pri prvi vrstici, ki ustreza.

Želite … Uporabite Zakaj ne česa lažjega
Spremeniti vrednost ali omejitev ali določiti, kdo sme kaj storiti Nastavitev ali pravilnik Nič lažjega ne obstaja
Doseči, da pomočnik posamezno nalogo vsakič opravi na enak način Veščino Skills Engine Nastavitev ne more vsebovati navodil
Na zaslon postaviti »gumb UI«, ki zažene to nalogo Veščino Skills Engine, vezano na gumb Gumb izvaja samo veščine; ničesar ni treba graditi
Omogočiti orodju za programiranje z UI dostop do platforme Nexus Povezavo MCP prek okolja Workbench Ničesar ni treba pisati; oseba se prijavi prek svojega brskalnika
Brati zapise iz obstoječega sistema v model znanja Bralni konektor Konektor ničesar ne zapisuje nazaj, zato ne prinaša tveganja pri zapisovanju
Izvajati lastno deterministično kodo po urniku platforme Vtičnik skills-only z veščino host_callback ali plugin_queue Veščina Skills Engine ne more izvajati vaše kode
Dodati zaslon ali dva znotraj lupine Vtičnik ui-only Samo vtičniki dodajajo zaslone
Hraniti lastne zapise za lastnimi usmerjevalnimi potmi in pravicami Vtičnik full-service Samo ta raven ima lastno shemo
Posamezni vlogi omogočiti ožji pogled na zaslone panoge Pogled na obstoječem paketu Pogled so podatki, ne koda
Prenesti model znanja in poglede panoge, skupaj z zasloni za telefone, v več enot Domenski paket Sam vtičnik nima pogledov ali licenčnih vrat

V podjetju Corrán Orbital je vprašanje načrtovanja preletov ostalo veščina Skills Engine. Izračun širjenja orbite, ki ga potrebuje, je postal vtičnik skills-only z eno veščino host_callback, saj je numerično delo naše in mora dvakrat dati enak rezultat. Naš odbor za pregled anomalij je postal vtičnik full-service, ker hrani lastne zapise o tem, kdo je pregledal posamezno telemetrično odstopanje in kaj so sklenili. Paket je prišel na vrsto zadnji, ko je druga enota želela isto stvar.

Kako se deli povezujejo

Gradniki se sestavljajo navzgor. Domenski paket je najjasnejši primer, saj je sveženj preostalih gradnikov z dodanimi licenčnimi vrati:

  • model znanja, vrste entitet, ki jih panoga pozna, in kako se povezujejo, pogosto zgrajen na osnovnem modelu iz drugega paketa;
  • pogledi, po eden za vsako vlogo, pri čemer vsak zoži osnovni pogled;
  • predloge in delovni tokovi ter veščine Skills Engine, ki jih kličejo;
  • vtičniki, kjer paket potrebuje lastno kodo;
  • bralni konektorji v sisteme, ki že hranijo zapise;
  • mobilna prekrivna plast, ki določa, katere kartice in koraki zajema se prikažejo na telefonih;
  • in upravičenje: skupine funkcionalnosti, ki jih mora licenca vključevati, preden se kar koli od tega vklopi.
Narišite sklad vodoravnih pasov. Na dnu »Osnovne funkcionalnosti Nexus« (pomočnik, datoteke, pomnilnik, opravila) in ob njem »Razporejevalnik UNO« ter »AI Provider Router«. Nad tem pas »Vtičniki« z dvema poljema, »samo veščine« in »polna storitev«, ter pas »Veščine Skills Engine«. Nad njimi široko polje »Domenski paket«, ki vsebuje štiri manjša polja: »Model znanja«, »Pogledi«, »Predloge in delovni tokovi«, »Mobilna prekrivna plast«. Levo od paketa polje »Bralni konektorji« s puščico v »Model znanja«. Na vrhu tri polja enot (»Rotterdam«, »Felixstowe«, »Sedež podjetja«) s puščicami navzdol iz paketa z oznako »pogled, dodeljen glede na vlogo«. Ključavnica na robu paketa ima oznako »licenca: domain_packs«.
Kako domenski paket združuje druge gradnike.

Nič od tega ni infrastruktura na ravni posamezne aplikacije. Paket ne vsebuje lastne izolacijske kode, odjemalca za modele ali preverjanja licence: vse to podeduje od platforme. To je tema naslednjega poglavja in razlog, zakaj avtor paketa v banki in avtor v pristanišču napišeta enako količino varnostne kode – torej nič.

Domenski paketi
Domenski paketi
Stran Domenski paketi navaja vseh deset paketov skupaj s tem, kaj vsak potrebuje in kje se izvaja. Paket, ki ga licenca ne vključuje, ostane naveden in osivljen, s prikazom, kaj bi potreboval.

Ravni zaupanja

Vsak vtičnik v svojem manifestu deklarira raven trust. Zaupanje niso vrata, ki bi jih SDK lahko zaobšel. So svetovalni metapodatki, ki jih platforma prebere, da določi, kako izolirano se izvajajo prispevki vtičnika in kako občutljivih podatkov se smejo dotakniti njegove veščine. Aktivna vrata (klasifikacija in rezidenčnost, izvoz in poraba) ostanejo natanko tam, kjer so.

Zaupanje Komu je namenjen Izolacijska drža Zgornja meja klasifikacije
core Lastna koda, ki je dobavljena s platformo none: isti izvor, brez dodatne izolacije restricted
verified Pregledana tretja oseba, preverjen izdajatelj Površina same-origin, posredovane veščine restricted
community Nepregledana tretja oseba; privzeto za nov vtičnik Površina sandboxed, posredovane veščine tenant
untrusted Kar koli iz neznanega vira strict: površina v peskovniku, samo posredovane veščine, brez zaupanja gostitelja public

Iz te tabele izhajata dve pravili in create-nexus-plugin validate uveljavi obe, preden se kar koli zgradi.

Prvič, classification veščine ne sme preseči zgornje meje svojega vtičnika. Klasifikacije si sledijo od public, nato tenant in nato restricted. Gradnja vtičnika community, ki deklarira veščino restricted, ne uspe.

Drugič, samo vtičniki core in verified smejo deklarirati veščine, ki dosežejo AI Provider Router. To sta ravni tool_using in llm_only. Vtičnik community ali untrusted posreduje deterministično delo (host_callback, plugin_queue in map čez te) in zahteva od platforme, da opravi vse, kar potrebuje model. Moj prvi vtičnik je bil community in izgubil sem celo popoldne, ko sem poskušal deklarirati veščino povzemanja llm_only, preden sem dojel, da je bila prav zavrnitev bistvo zasnove.

Če izpustite trust, SDK obravnava vtičnik kot community. Izpuščeno polje nikoli ne more pomeniti povišanja ravni.

Ravni izolacije od 1 do 4

Ločeno od zaupanja blok runtime v manifestu določa, kako se vtičnik izvaja. isolationLevel je celo število od 1 do 4 in način izvajanja sledi iz njega. Teh dveh vrednosti ne izbirate neodvisno: validator izpelje eno iz druge in zavrne manifest, pri katerem se par ne ujema.

isolationLevel executionMode Kaj pomeni
1 external_https Vtičnik se izvaja zunaj namestitve in je dosegljiv prek protokola HTTPS
2 mcp_container Vsebnik, ki izpostavlja orodja MCP
3 hardened_docker Utrjen vsebnik v lastnih podih vtičnika; privzeta nastavitev predloge
4 firecracker MikroVM, najmočnejša ločitev
"runtime": {
  "nodeVersion": "20",
  "executionMode": "hardened_docker",
  "isolationLevel": 3,
  "entrypoint": "dist/server.js",
  "healthCheck": "/health"
}

Polje entrypoint je obvezno. Vstopne točke so dobavljeni artefakti in se nikoli ne pridobivajo ob izvajanju: SDK sploh nima poti za dinamični uvoz ali oddaljeno nalaganje, zato se zaupanje zapiše in preveri enkrat, nato pa zamrzne in nikoli ne prenaša s spleta.

Kaj sprejmete na posamezni stopnji

Vzdrževanje vsake stopničke nad nastavitvami nekaj stane. Tukaj je navedeno, kaj vas stane vsaka izmed njih.

  • Veščina Skills Engine potrebuje testne primere, pregledovalca, ki niste vi, in zgodovino različic, o kateri vas bodo spraševali, ko ne bo delovala pravilno. Isti bajti se nikoli ne objavijo dvakrat (CONTENT_HASH_ALREADY_PUBLISHED), zato »samo ponovno naloži« ni rešitev.
  • Vtičnik potrebuje manifest, katerega usmerjevalna tabela se v obeh smereh ujema z usmerjevalnimi potmi, ki jih registrira vaša koda. Usmerjevalna pot, ki obstaja, a ni deklarirana, pomeni napako skladnosti, prav tako pa tudi deklarirana pot, ki je koda nikoli ne registrira.
  • Vtičnik full-service ima lastno shemo s petimi vlogami podatkovne baze, vsiljeno varnostjo na ravni vrstic v vsaki tabeli ter zagonom, ki zavrne poslušanje, dokler podatkovna baza ne dokaže, da zaščitna ograja drži. Prav tako v svojem manifestu dobesedno ponovi tri zakone platforme.
  • Domenski paket je licenciran. Vklaplja se po eno enoto naenkrat prek pilotnega projekta, vključevati pa ga mora licenca organizacije. Vi ne morete odločiti, da ga stranka ima.
  • Pogled lahko samo odvzema. Če mora vloga videti več, se mora spremeniti osnovni pogled, kar zahteva pogovor z lastnikom te osnove.

O nobenem od teh stroškov se ni mogoče pogajati za posamezno aplikacijo, kar je bistvo kompromisa. Pri prvem vtičniku se odrečete nekaj svobode, a jo dobite nazaj pri vsakem naslednjem.

Namestitev vtičnika tretje osebe
Namestitev vtičnika tretje osebe
Nameščanje vtičnika tretje osebe deluje kot dovoljenja aplikacij. Vsak obseg, ki ga deklarira njegov manifest, se odobri ali odreče za posamezno enoto, klic za kar koli, česar ni deklariral, pa se zavrne z CONNECTION_SCOPE_EXCEEDED.

Orodja in povezave MCP

MCP se pojavi na treh mestih in zlahka jih je zamešati.

Vtičnik lahko objavi orodja MCP tako, da jih deklarira v mcpTools[]: name, description in inputSchema. Edino pravilo, ki ga doda validator, je, da inputSchema na najvišji ravni ne sme uporabljati oneOf, allOf ali anyOf, saj kombinator na vrhu sheme povzroči, da vsak odjemalec MCP, ki uvozi orodje, odpove z napako 400. Vtičnik na ravni isolationLevel 2 se izvaja kot mcp_container.

Knjižnica okolja Skills Engine je dosegljiva prek protokola MCP. Claude Code in agenti uporabljajo trinajst orodij MCP za iskanje in ujemanje veščin, njihovo izvajanje in beleženje izvajanja ter ustvarjanje, uvažanje ali sinhronizacijo, pri čemer se vsak klic izvede v imenu osebe, ki ga je sprožila, znotraj njenega seznama dovoljenih orodij.

In orodje za programiranje z UI se poveže prek okolja Workbench: en naslov na namestitev, prijava prek brskalnika osebe, enourna prepustnica namesto shranjenega ključa in samo tista orodja, ki jih ta oseba označi. Poglavje 2.26, Gradnja z orodji za programiranje z UI, vas vodi skozi ta postopek.

Konektorji so tišji sosed. Model znanja domenskega paketa se napaja z bralnimi konektorji v sisteme, kot sta sistem za upravljanje polic ali sistem za škodne zahtevke, pri čemer ima vsak svoj urnik in gumb za preizkus. V izvorni sistem se nič ne zapisuje nazaj.

Vtičniki in sinhronizacija MCP
Vtičniki in sinhronizacija MCP
Stran Vtičniki in sinhronizacija MCP prikazuje, kateri vtičniki prinašajo veščine, katere sinhronizacije so bile v celoti zavrnjene, ter trinajst orodij MCP, ki jih Claude Code in agenti uporabljajo za dostop do knjižnice.

Od vaše razvojne veje do zaslonov uporabnikov

Ne glede na to, na kateri stopnički ste, je pot v produkcijo enaka. Vsaka izdaja potuje iz vašega razvojnega prostora v testno okolje (staging), nato v pilotno enoto in zatem v vse enote, vsak korak pa ima vrata: preizkuse, manifest, ki se ni razširil, poskusni zagon na maskirani kopiji in imenovane pregledovalce, ki niso avtor. Napredovanje, ki poskuša preskočiti korak, je zavrnjeno z GATE_CANNOT_BE_SKIPPED. Vsako okolje hrani prejšnjo različico 30 dni, povrnitev posamezne enote na prejšnjo različico pa je pregledana sprememba, ki traja približno eno minuto.

Sama namestitev poteka izključno prek izdajnih kanalov namestitve. Enote izberejo svoj kanal, njihov skrbnik pa potrdi vsak premik. Na strani Kanali in namestitve vidite število uporab in stopnje napak po enotah, nikoli pa tega, kaj je kdo počel z vašo razširitvijo. Poglavje 2.28, Izdajanje vaše razširitve, celovito obravnava področje izdaj.

Opomba o izdajah

Večina te lestvice obstaja v obeh izdajah. Izdaja Community vključuje nastavitve in veščine Skills Engine, vtičnike na vseh ravneh ter iste zlate poti na enem strežniku s kodo pri vašem lastnem gostitelju Git. Izdaja Enterprise dodaja napredovanje iz razvojnega prostora prek testnega okolja v pilotno enoto skupaj z vrati, poleg tega pa še gruče izdajateljev in maskirane kopije produkcijskih podatkov. Dodaja tudi vaš lastni zasebni katalog in domenske pakete. Podrobnosti so v poglavju 2.25, Gradnja za posamezno izdajo.

Naslednje poglavje morate prebrati, preden napišete kar koli kode. Ponuja malo izbir in veliko pravil, pravila pa so enaka za prvo in tisočo razširitev.