Útgáfa 1.0.0-alpha.1nýjast
Kafli 2.18
Viðbótarlíkanið
Leiðirnar sex til að útvíkka Nexus, allt frá stillingu til sviðspakka, takmarkanir hverrar um sig, og hvernig traust- og einangrunarstig ákveða hvar kóðinn þinn keyrir. Lestu þetta áður en þú opnar þróunarsettið (SDK).
Þessi síða var þýdd með gervigreind úr enska frumtextanum. Ef eitthvað er óljóst gildir enska síðan til viðmiðunar. Lesa þessa síðu á ensku

Það fyrsta sem ég smíðaði í Nexus hjá Corrán Orbital var ekki viðbót (e. plugin). Teymið okkar í flugfræði vildi að aðstoðarinn svaraði spurningunni „hvaða yfirferðir yfir jarðstöðvar töpum við ef loftnetið á Svalbarða fer úr sambandi vegna viðhalds?“ með sama sniði í hvert skipti, með yfirferðatöfluna fyrst og kostnaðinn í mínútum af sambandi þar fyrir neðan. Ég eyddi hálfum degi í að lesa um þróunarbúnaðinn (SDK) áður en samstarfsmaður benti mér á að það sem mig vantaði væri færni (e. skill): mappa með SKILL.md í henni, hlaðið upp í Skills Engine og gefin út um leið og prófanir hennar stóðust og yfirlesari samþykkti hana. Það tók fjörutíu mínútur.
Tveimur viðbótum og einum sviðspakka (e. domain pack) síðar er þetta enn fyrsta ráðið sem ég gef. Nexus býður upp á sex leiðir til að útvíkka kerfið og þær raðast á stiga eftir fyrirhöfn. Ódýru þrepin gera meira en fólk býst við og þau dýru fela í sér skuldbindingar sem auðvelt er að vanmeta. Þessi kafli leggur stigann á borðið. Veldu lægsta þrepið sem leysir verkið. Kaflarnir á eftir fara djúpt í hvert þeirra: kafli 2.19, Reglurnar sem sérhver útvíkkun erfir; kafli 2.20, Færni; kafli 2.21, Viðbótar-SDK; kafli 2.22, Keyrsluumhverfi viðbóta; og kafli 2.23, Sviðspakkar.
Byggingareiningarnar sex
Hér eru þau í þeirri röð sem þú ættir að íhuga þau.
- Stillingar og reglur. Þetta eru gildi sem kerfisstjóri stillir í stjórnborðinu fyrir stofnunina, einingu eða einn einstakling, innan þess sem leyfið heimilar. Þú skrifar engan kóða.
- Færni í Skills Engine.
SKILL.md-pakki sem geymir fyrirmæli og þau verkfæri sem færnin má kalla á, ásamt valfrjálsum skrám og skriftum. Aðstoðarinn, erindrekar, verkferlar og hnappar fyrir gervigreind (AI) á skjáum keyra allir sömu færnina, og það gerir þróunarumhverfið þitt (IDE) líka. - Viðbætur. Þinn eigin kóði, skilgreindur með lýsiskrá (e. manifest) og smíðaður með verkfærum úr SDK. Viðbót kemur í einu af þremur þrepum:
skills-only,ui-onlyeðafull-service. - Sviðspakkar. Linsur og sniðmát fyrir eina atvinnugrein, færni hennar og þekkingarlíkan, tengi hennar og símaskjáir, leyfisbundið sem ein heild. Adverant afhendir tíu slíka; þú getur smíðað þína eigin.
- Linsur. Það sem eitt hlutverk sér inni í pakka eða á vettvangi. Linsa þrengir grunnlinsu og víkkar hana aldrei.
- MCP-tengingar og tengi. Verkfæri fyrir Model Context Protocol (MCP) sem viðbót gefur út eða forritunarverkfæri með gervigreind tengist í gegnum, og ritvarin tengi sem sækja færslur úr kerfum sem þú rekur nú þegar.
Tvö hugtök eru ofnotuð, svo ég skýri þau núna. Skills Engine-færni er SKILL.md-pakki í safninu. Lýsiskrárfærni (e. manifest skill) er tagsett lína í skills[]-fylki viðbótar, þýdd inn í færniskrá vettvangsins og keyrð í gegnum UNO, verkferlavélina. Bæði eru kölluð færni á skjánum. Þau eru skrifuð og stýrt á ólíkan hátt og í þessum gögnum kemur alltaf fram hvort er átt við.
Hvað hver þeirra getur gert og hvað hún getur ekki
Taflan er stutta útgáfan. Ég setti dálkinn „Hvað hann getur ekki“ inn viljandi: hver takmörkun er eiginleiki hönnunarinnar og sérhver þeirra hefur bjargað mér frá einhverju.
| Byggingareining | Hvað hún getur | Hvað hún getur ekki | Hver býr hana til |
|---|---|---|---|
| Stilling eða regla | Breytt hegðun eiginleika á hvaða stigi sem er, frá stofnuninni niður í einn einstakling; læst gildi; framselt það niður; krafist samþykkis annars aðila við breytingu | Bætt við skjá eða slóð, geymt nýja töflu eða hafið nýja tegund vinnu | Kerfisstjóri, í stjórnborðinu |
| Skills Engine-færni | Gefið aðstoðaranum og erindrekum, verkferlum og gervigreindarhnöppum endurtekna leið til að vinna eitt verk, með eigin fyrirmælum og prófunartilvikum | Geymt auðkenni; kallað á verkfæri utan leyfislista þess sem keyrir hana (SKILL_CANNOT_WIDEN_TOOLS); farið í loftið án prófana og samþykkis |
Hver sá sem hefur réttindin, í hönnuðinum eða úr sínu IDE |
Viðbót, skills-only |
Gefið út lýsiskrárfærni sem keyrir á vettvanginum: endurköll hýsils, vinnu í biðröð, vörpun yfir lista og, á trauststigi core eða verified, færni studda af líkani |
Birt sínar eigin síður | Forritari, með SDK |
Viðbót, ui-only |
Bætt við framendaviðmóti inni í skelinni | Geymt sín eigin gögn eða keyrt reikniafl | Forritari, með SDK |
Viðbót, full-service |
Sinn eigin bakenda og framenda, Postgres-skema, slóðatöflu með réttindum, auk færni og MCP-verkfæra | Kallað á líkanaveitu; geymt líkanalykil; lesið raðir annarrar stofnunar nema í gegnum skráða heimild; keyrt reikniafl utan UNO-útsendingar | Forritari, með SDK |
| Sviðspakki | Fært linsur og sniðmát atvinnugreinar, færni hennar og verkferla, þekkingarlíkan, sönnunarkort og símaskjái til þeirra eininga sem kerfisstjóri velur | Breytt skelinni eða íhlutum hennar, eða ritreglunum; keyrt án þess að leyfi stofnunarinnar beri hann | Adverant, eða þínir eigin forritarar í Enterprise |
| Linsa | Valið þau spjöld og reiti sem eitt hlutverk sér inni í pakka eða á vettvangi, og þær aðgerðir sem hún býður upp á | Sýnt nokkuð sem grunnlinsa hennar felur (LENS_CANNOT_WIDEN); breytt því hvað hlutverk má gera |
Pakkahöfundur smíðar hana; kerfisstjóri veitir hana á hverja einingu |
| MCP-verkfæri og tengi | Gert verkfæri viðbótar aðgengileg erindrekum og forritunarverkfærum; lesið færslur úr reglukerfi eða fjarmælingasafni inn í þekkingarlíkanið | Skrifað til baka í upprunakerfið í gegnum tengi; framkvæmt umfram eigin heimildir innskráðs aðila | Forritari skilgreinir MCP-verkfæri; kerfisstjóri setur upp tengi |
Nokkrir af þessum reitum verðskulda eina setningu í viðbót.
Stillingar eru umgjörð og sérhver viðbót notar þá sömu. Viðbót sem skilgreinir settings-blokk í lýsiskrá sinni fær stigin (vettvangur, stofnun, pakki, eining, hópur, geymsla, einstaklingur), læsingar og framsal, breytingaskrá og samþykki annars aðila, allt án þess að skrifa stillingatöflu. Þess vegna dugar ódýrasta þrepið oft: ef hegðunin sem þú vilt er þegar til og þarf aðeins annað gildi fyrir eininguna í Rotterdam, þá er það stilling.
Skills Engine-færni keyrir sem einstaklingurinn. Hún geymir aldrei lykil og getur aðeins nálgast verkfæri innan leyfislista þess sem keyrir hana og aðeins lesið það sem sá aðili má opna. Færni sem bætir við verkfæri sem skrifar gögn er haldið aftur af þar til tveir aðilar samþykkja hana, fer svo í loftið í skuggaham (e. shadow), síðan í tilraunaham (e. canary) og loks fyrir alla.
skills-only-viðbót er miðþrepið. Þú þarft hana þegar verkið er kóði sem þú átt: ákvarðanlegur útreikningur, vinnsluaðili í biðröð, dreifing yfir lista. Vettvangurinn kallar á kóðann þinn; kóðinn þinn kallar aldrei á líkan.
full-service-viðbót er lítil vara. Hún á Postgres-skema, slóðatöflu með réttindaskrá, framenda, sett af gagnagrunnshlutverkum og sérhverja einangrunarskyldu í kafla 2.19, Reglurnar sem sérhver útvíkkun erfir. Hún er rétta svarið oftar en fólk óttast og ranga svarið oftar en fólk vonar.
Hverja þeirra þarf ég?
Byrjaðu efst í þessari töflu og stoppaðu við fyrstu línuna sem passar.
| Þú vilt… | Notaðu | Hvers vegna ekki eitthvað léttara |
|---|---|---|
| Breyta gildi eða mörkum, eða því hver má gera eitthvað | Stillingu eða reglu | Ekkert léttara er til |
| Láta aðstoðarann vinna eitt verk á sama hátt í hvert skipti | Skills Engine-færni | Stilling getur ekki geymt fyrirmæli |
| Setja „gervigreindarhnapp“ á skjá sem keyrir það verk | Skills Engine-færni tengda við hnappinn | Hnappur keyrir aðeins færni; það þarf ekkert að smíða |
| Leyfa forritunarverkfæri með gervigreind að ná í Nexus | MCP-tengingu í gegnum Workbench | Ekkert að skrifa; aðilinn skráir sig inn í gegnum vafrann sinn |
| Lesa færslur úr núverandi kerfi inn í þekkingarlíkanið | Ritvarið tengi | Tengi skrifar ekkert til baka, svo því fylgir engin ritáhætta |
| Keyra ákvörðunarbundinn kóða sem þú átt samkvæmt áætlun vettvangsins | skills-only-viðbót með host_callback- eða plugin_queue-færni |
Skills Engine-færni getur ekki keyrt kóðann þinn |
| Bæta við einum eða tveimur skjáum inni í skelinni | ui-only-viðbót |
Aðeins viðbætur bæta við skjáum |
| Halda utan um þínar eigin færslur á bak við þínar eigin slóðir og réttindi | full-service-viðbót |
Aðeins þetta þrep á skema |
| Gefa einu hlutverki þrengri sýn á skjái atvinnugreinar | Linsu á núverandi pakka | Linsa er gögn, ekki kóði |
| Færa þekkingarlíkan og linsur atvinnugreinar, ásamt símaskjáum, til nokkurra eininga | Sviðspakka | Viðbót ein og sér hefur hvorki linsur né leyfishlið |
Hjá Corrán Orbital varð spurningin um yfirferðaáætlunina áfram Skills Engine-færni. Brautarútreikningurinn sem hún þarf varð að skills-only-viðbót með einni host_callback-færni, vegna þess að tölulega vinnan er okkar og verður að gefa sama svarið tvisvar. Frávikaráðið okkar varð að full-service-viðbót, vegna þess að það heldur utan um eigin færslur um hver skoðaði hvaða fjarmælingarfrávik og hvað var ákveðið. Pakkinn kom síðast, þegar önnur eining vildi það sama.
Hvernig einingarnar spila saman
Byggingareiningarnar raðast saman upp á við. Sviðspakki er skýrasta dæmið, vegna þess að hann er vöndull af hinum auk leyfishliðs:
- þekkingarlíkan, þær tegundir hluta sem atvinnugreinin þekkir og hvernig þær tengjast, oft byggt á grunnlíkani úr öðrum pakka;
- linsur, ein fyrir hvert hlutverk, þar sem hver um sig þrengir grunnlinsu;
- sniðmát og verkferlar, og sú Skills Engine-færni sem þau kalla á;
- viðbætur þar sem pakkinn þarf sinn eigin kóða;
- ritvarin tengi inn í kerfin sem geyma færslurnar nú þegar;
- farsímaþekja sem segir til um hvaða spjöld og skráningarskref birtast í símum;
- og réttindin: þeir eiginleikahópar sem leyfið verður að innihalda áður en nokkuð af þessu kviknar á.
Ekkert af þessu er grunnvirki fyrir hvert forrit. Pakkinn inniheldur engan eigin einangrunarkóða, engan biðlara fyrir líkön og enga leyfisathugun: hann erfir það frá vettvanginum. Það er viðfangsefni næsta kafla, og það er ástæðan fyrir því að pakkahöfundur í banka og annar við höfn skrifa jafn mikinn öryggiskóða, sem er enginn.
Trauststig
Sérhver viðbót skilgreinir trust-stig í lýsiskrá sinni. Traust er ekki hlið sem SDK getur talað sig í gegnum. Það eru ráðgefandi lýsigögn sem vettvangurinn les til að ákveða hversu einangruð framlög viðbótar keyra og hver viðkvæmustu gögnin eru sem færni hennar má snerta. Virku hliðin (flokkun og vistun, útflutningur og eyðsla) haldast nákvæmlega þar sem þau eru.
| Traust | Fyrir hverja það er | Einangrunarstaða | Flokkunarþak |
|---|---|---|---|
core |
Eigin kóði sem fylgir með vettvanginum | none: sami uppruni, engin viðbótareinangrun |
restricted |
verified |
Yfirfarinn þriðji aðili, staðfestur útgefandi | same-origin-viðmót, miðluð færni |
restricted |
community |
Óyfirfarinn þriðji aðili; sjálfgefið fyrir nýja viðbót | sandboxed-viðmót, miðluð færni |
tenant |
untrusted |
Allt frá óþekktum uppruna | strict: sandkassaviðmót, aðeins miðluð færni, ekkert traust hýsils |
public |
Tvær reglur leiða af þessari töflu og create-nexus-plugin validate framfylgir báðum áður en nokkuð er smíðað.
Í fyrsta lagi má classification færni ekki fara yfir þak viðbótar sinnar. Flokkanir raðast sem public, síðan tenant og svo restricted. community-viðbót sem skilgreinir restricted-færni nær ekki að smíðast.
Í öðru lagi mega aðeins core- og verified-viðbætur skilgreina færni sem nær til AI Provider Router. Það eru þrepin tool_using og llm_only. community- eða untrusted-viðbót miðlar löggengri vinnu (host_callback, plugin_queue og map yfir þau) og biður vettvanginn um að gera allt sem þarf líkan. Fyrsta viðbótin mín var community og ég eyddi heilu síðdegi í að reyna að skilgreina llm_only-samantektarfærni áður en ég skildi að synjunin var allur tilgangurinn.
Ef þú sleppir trust meðhöndlar SDK viðbótina sem community. Slepping á reit getur aldrei falið í sér hækkun á stigi.
Einangrunarstig 1 til 4
Aðskilið frá trausti segir runtime-blokk lýsiskrárinnar til um hvernig viðbótin keyrir. isolationLevel er heiltala frá 1 til 4 og keyrsluhamurinn leiðir af henni. Þú velur þetta tvennt ekki óháð hvort öðru: sannprófarinn leiðir annað af hinu og hafnar lýsiskrá þar sem parið stangast á.
isolationLevel |
executionMode |
Hvað það þýðir |
|---|---|---|
| 1 | external_https |
Viðbótin keyrir utan uppsetningarinnar og er nálgast yfir HTTPS |
| 2 | mcp_container |
Gámur sem gerir MCP-verkfæri aðgengileg |
| 3 | hardened_docker |
Hertur gámur í eigin poddum viðbótarinnar; sjálfgefið í sniðmátinu |
| 4 | firecracker |
Örsýndarvél (microVM), sterkasti aðskilnaðurinn |
"runtime": {
"nodeVersion": "20",
"executionMode": "hardened_docker",
"isolationLevel": 3,
"entrypoint": "dist/server.js",
"healthCheck": "/health"
}entrypoint er áskilið. Inngangspunktar eru afhentir gripir og aldrei sóttir á keyrslutíma: SDK hefur enga leið fyrir kvika innflutninga eða fjarhleðslu, þannig að traust er skráð niður og athugað einu sinni, síðan fryst, aldrei sótt af netinu.
Hvað þú gengst undir á hverju þrepi
Sérhvert þrep fyrir ofan stillingar kostar eitthvað í rekstri. Hér er það sem hvert þeirra kostar þig.
- Skills Engine-færni þarf prófunartilvik, yfirlesara sem er ekki þú og útgáfusögu sem þú verður spurður út í þegar hún hagar sér illa. Sömu bætin eru aldrei gefin út tvisvar (
CONTENT_HASH_ALREADY_PUBLISHED), þannig að „hladdu henni bara upp aftur“ er ekki lausn. - Viðbót þarf lýsiskrá þar sem slóðataflan passar við slóðirnar sem kóðinn þinn skráir, í báðar áttir. Slóð sem er til en er ekki skilgreind er samræmisvilla, og það sama gildir um skilgreinda slóð sem kóðinn skráir aldrei.
full-service-viðbót á skema með fimm gagnagrunnshlutverkum, öryggi á línustigi (e. row-level security) sem er þvingað á hverja töflu og ræsingu sem neitar að hlusta þar til gagnagrunnurinn sannar að girðingin haldi. Hún endurtekur einnig lögmál vettvangsins þrjú í lýsiskrá sinni, orð fyrir orð.- Sviðspakki er leyfisbundinn. Kveikt er á honum fyrir eina einingu í einu, í gegnum tilraunaverkefni, og leyfi stofnunarinnar verður að innihalda hann. Þú færð ekki að ákveða að viðskiptavinur hafi hann.
- Linsa getur aðeins tekið í burtu. Ef hlutverk þarf að sjá meira verður grunnlinsan að breytast, sem kallar á samtal við þann sem á þann grunn.
Ekki er hægt að semja um neinn af þessum kostnaði fyrir hvert forrit, sem eru málamiðlunin. Þú gefur eftir eitthvert frelsi við fyrstu viðbótina og færð það til baka í öllum þeim sem á eftir koma.
CONNECTION_SCOPE_EXCEEDED.MCP-verkfæri og tengingar
MCP birtist á þremur stöðum og það er auðvelt að rugla þeim saman.
Viðbót getur gefið út MCP-verkfæri með því að skilgreina þau í mcpTools[]: name, description og inputSchema. Eina reglan sem sannprófarinn bætir við er að inputSchema má ekki nota oneOf, allOf eða anyOf á efsta stigi, vegna þess að tengivirkjar efst í skemanu valda því að sérhver MCP-biðlari sem flytur inn verkfærið bregst með villunni 400. Viðbót á isolationLevel 2 keyrir sem mcp_container.
Safn Skills Engine er aðgengilegt yfir MCP. Claude Code og erindrekar nota þrettán MCP-verkfæri til að finna og para saman færni, keyra hana og skrá keyrsluna, og búa til, flytja inn eða samstilla hana, og hvert kall keyrir sem sá aðili sem ræsti það, innan leyfislista viðkomandi.
Og forritunarverkfæri með gervigreind tengist í gegnum Workbench: eitt vistfang á hverja uppsetningu, innskráning í gegnum vafra viðkomandi, klukkustundarpassi í stað geymds lykils og aðeins þau verkfæri sem sá aðili hakar við. Kafli 2.26, Smíðað með gervigreindarverkfærum til forritunar, fer yfir þetta.
Tengi eru hljóðlátari nágranninn. Þekkingarlíkan sviðspakka fær gögn frá ritvörðum tengjum inn í kerfi á borð við vátryggingastjórnun eða tjónakerfi, hvert með sinni áætlun og prófunarhnappi. Ekkert er skrifað til baka í upprunann.
Úr greininni þinni á skjái fólks
Á hvaða þrepi sem þú ert, þá er leiðin í raunrekstur sú sama. Sérhver útgáfa færist af þróunarsvæðinu þínu yfir í prófunarumhverfi (e. staging), síðan í tilraunaeiningu og loks í allar einingar, og hvert skref er með hliðum: prófunum, lýsiskrá sem hefur ekki víkkað, þurrkeyrslu á dulbúnu afriti og nafngreindum yfirlesurum sem eru ekki höfundurinn. Uppfærslu sem reynir að stökkva yfir skref er hafnað með GATE_CANNOT_BE_SKIPPED. Hvert umhverfi geymir fyrri útgáfu í 30 daga og það að færa eina einingu til baka er yfirfarin breyting sem tekur um eina mínútu.
Innleiðingin sjálf fer eingöngu í gegnum útgáfurásir uppsetningarinnar. Einingar velja sína rás og kerfisstjóri þeirra samþykkir hverja færslu. Þú sérð fjölda og villutíðni á hverja einingu á síðunni Rásir og uppsetningar, en aldrei hvað nokkur gerði við útvíkkunina þína. Kafli 2.28, Útgáfa útvíkkunar, fjallar um útgáfuhliðina frá upphafi til enda.
Athugasemd um útgáfur
Mestur hluti þessa stiga er til í báðum útgáfum. Community fær stillingar og Skills Engine-færni, viðbætur á öllum þrepum og sömu gullnu leiðirnar á einum netþjóni með kóða í þinni eigin Git-hýsingu. Enterprise bætir við færslunni af þróunarsvæði í gegnum prófunarumhverfi yfir í tilraunaeiningu ásamt hliðum hennar, auk útgefendaklasa og dulbúinna afrita af raungögnum. Hún bætir einnig við þinni eigin einkaskrá og sviðspökkum. Kafli 2.25, Smíðað fyrir hverja útgáfu, geymir nánari upplýsingar.
Næsti kafli er sá sem þú ættir að lesa áður en þú skrifar nokkurn kóða. Hann býður upp á fáa valkosti en margar reglur, og reglurnar eru þær sömu fyrir fyrstu útvíkkunina og þá þúsundustu.



