Versioni 1.0.0-alpha.1më i fundit
Kapitulli 2.18
Modeli i zgjerimit
Gjashtë mënyrat për të zgjeruar Nexus, nga një cilësim deri te një paketë fushe, kufijtë e secilës dhe si nivelet e besimit dhe të izolimit vendosin se ku ekzekutohet kodi juaj. Lexojeni përpara se të hapni paketën e zhvillimit të softuerit (SDK).
Kjo faqe u përkthye nga AI prej origjinalit në anglisht. Nëse diçka është e paqartë, faqja në anglisht shërben si referencë. Lexoni këtë faqe në anglisht

Gjëja e parë që ndërtova në Nexus te Corrán Orbital nuk ishte një shtojcë (plugin). Ekipi ynë i dinamikës së fluturimit donte që asistenti t'i përgjigjej pyetjes "cilat kalime mbi stacionet tokësore humbasim nëse antena e Svalbardit bie për mirëmbajtje?" në të njëjtën formë çdo herë, me tabelën e kalimeve në fillim dhe koston në minuta kontakti poshtë saj. Kalova gjysmë dite duke lexuar paketën e zhvillimit të softuerit (SDK) para se një koleg të më vinte në dukje se ajo që doja ishte një aftësi (skill): një dosje me një SKILL.md brenda saj, e ngarkuar në Skills Engine dhe e publikuar sapo të kalonte testet dhe ta miratonte një rishikues. U deshën dyzet minuta.
Dy shtojca dhe një paketë domeni më vonë, kjo mbetet ende këshilla e parë që jap. Nexus ka gjashtë mënyra për ta zgjeruar atë, dhe ato qëndrojnë në një shkallë përpjekjesh. Shkallët e lira bëjnë më shumë sesa presin njerëzit, ndërsa ato të shtrenjtat mbartin detyrime që janë të lehta për t'u nënvlerësuar. Ky kapitull paraqet këtë shkallë. Zgjidhni shkallën më të ulët që e kryen punën. Kapitujt pas tij thellohen në secilën: kapitulli 2.19, Rregullat që trashëgon çdo zgjerim; kapitulli 2.20, Aftësitë; kapitulli 2.21, SDK-ja e shtojcave; kapitulli 2.22, Mjedisi i ekzekutimit të shtojcave; dhe kapitulli 2.23, Paketat e domenit.
Gjashtë blloqet ndërtuese
Ja ku janë sipas rendit që duhet t'i merrni në konsideratë.
- Cilësimet dhe politikat. Këto janë vlera që një administrator i vendos në konsolë për organizatën, një njësi ose një person të vetëm, brenda asaj që lejon licenca. Ju nuk shkruani fare kod.
- Aftësitë e Skills Engine. Një paketë
SKILL.mdqë mban udhëzime dhe mjetet që aftësia mund të thërrasë, me skedarë dhe skripte opsionale pranë saj. Asistenti, agjentët, rrjedhat e punës dhe butonat e AI (inteligjencës artificiale) në ekrane ekzekutojnë të gjithë të njëjtat aftësi, dhe po ashtu bën edhe IDE-ja (mjedisi i integruar i zhvillimit) juaj. - Shtojcat (Plugins). Kodi juaj, i deklaruar nga një manifest dhe i ndërtuar me mjetet e SDK-së. Një shtojcë vjen në një nga tre nivelet:
skills-only,ui-onlyosefull-service. - Paketat e domenit. Lentet dhe shabllonet e një industrie, aftësitë dhe modeli i saj i njohurive, lidhësit e saj dhe ekranet e saj të telefonit, të licencuara si një njësi e vetme. Adverant ofron dhjetë të tilla; ju mund të ndërtoni tuajën.
- Lentet. Çfarë sheh një rol brenda një pakete ose një platforme. Një lente ngushton një lente bazë dhe nuk e zgjeron kurrë atë.
- Lidhjet dhe lidhësit MCP. Mjetet e Model Context Protocol (MCP) që publikon një shtojcë ose përmes të cilave lidhet një mjet kodimi me AI, dhe lidhësit vetëm për lexim që sjellin regjistrime nga sistemet që ju tashmë i përdorni.
Dy terma ngatërrohen shpesh, ndaj më lejoni t'i sqaroj tani. Një aftësi e Skills Engine është një paketë SKILL.md në bibliotekë. Një aftësi manifesti është një rresht i tipizuar në vargun skills[] të një shtojce, i kompiluar në regjistrin e aftësive të platformës dhe i ekzekutuar përmes UNO, motorit të rrjedhës së punës. Të dyja quhen aftësi në ekran. Ato shkruhen dhe qeverisen ndryshe, dhe ky dokumentacion tregon gjithmonë se për cilën prej tyre bëhet fjalë.
Çfarë mund të bëjë secili dhe çfarë nuk mund të bëjë
Tabela është versioni i shkurtër. E kam vendosur kolonën "Çfarë nuk mund të bëjë" qëllimisht: çdo kufizim është një veti e dizajnit, dhe secili prej tyre më ka shpëtuar nga diçka.
| Blloku ndërtues | Çfarë mund të bëjë | Çfarë nuk mund të bëjë | Kush e krijon |
|---|---|---|---|
| Cilësim ose politikë | Ndryshon mënyrën se si sillet një veçori në çdo nivel nga organizata deri te një person; bllokon një vlerë; e delegon atë më poshtë; kërkon një person të dytë për një ndryshim | Të shtojë një ekran ose një rrugë (route), të ruajë një tabelë të re, ose të nisë një lloj të ri pune | Një administrator, në konsolë |
| Aftësi e Skills Engine | I jep asistentit dhe agjentëve, rrjedhave të punës dhe butonave të AI një mënyrë të përsëritshme për të kryer një punë, me udhëzimet dhe rastet e veta të testimit | Të mbajë një kredencial; të thërrasë një mjet jashtë listës së lejuar të personit që e ekzekuton (SKILL_CANNOT_WIDEN_TOOLS); të aktivizohet pa testet dhe miratimin e saj |
Kushdo që ka të drejtën, në krijues ose nga IDE-ja e vet |
Shtojcë, skills-only |
Publikon aftësi manifesti që ekzekutohen në platformë: thirrje kthyese (callbacks) të hostit, punë në radhë, përpunime mbi një listë dhe, në nivelin e besimit core ose verified, aftësi të mbështetura në modele |
Të shërbejë faqe të vetat | Një zhvillues, me SDK-në |
Shtojcë, ui-only |
Shton një ndërfaqe (frontend) brenda guaskës (shell) | Të ruajë të dhëna të vetat ose të kryejë llogaritje (compute) | Një zhvillues, me SDK-në |
Shtojcë, full-service |
Backend-in dhe frontend-in e vet, një skemë Postgres, një tabelë rrugësh me të drejta, si dhe aftësi dhe mjete MCP | Të thërrasë një ofrues modeli; të mbajë një çelës modeli; të lexojë rreshtat e një organizate tjetër përveçse përmes një autorizimi të regjistruar; të kryejë llogaritje jashtë shpërndarjes së UNO-s | Një zhvillues, me SDK-në |
| Paketë domeni | Sjell lentet dhe shabllonet e një industrie, aftësitë dhe rrjedhat e saj të punës, një model njohurish, një hartë provash dhe ekrane telefoni në njësitë që zgjedh një administrator | Të ndryshojë guaskën ose komponentët e saj, apo rregullat e shkrimit; të ekzekutohet pa e pasur të përfshirë licenca e organizatës | Adverant, ose zhvilluesit tuaj në Enterprise |
| Lente | Zgjedh kartat dhe fushat që sheh një rol brenda një pakete ose platforme, si dhe veprimet që ajo ofron | Të shfaqë çdo gjë që fsheh lentja e saj bazë (LENS_CANNOT_WIDEN); të ndryshojë atë që mund të bëjë një rol |
Një autor pakete e ndërton atë; një administrator e jep atë për çdo njësi |
| Mjete dhe lidhës MCP | Ekspozon mjetet e një shtojce për agjentët dhe mjetet e kodimit; lexon regjistrime nga një sistem politikash ose një arkiv telemetrie në modelin e njohurive | Të shkruajë mbrapsht në sistemin burimor përmes një lidhësi; të veprojë përtej lejeve të vetë personit të identifikuar | Një zhvillues deklaron mjetet MCP; një administrator konfiguron lidhësit |
Disa nga ato qeliza meritojnë edhe nga një fjali më shumë.
Cilësimet janë një kornizë (framework), dhe çdo shtojcë përdor të njëjtën. Një shtojcë që deklaron një bllok settings në manifestin e saj merr nivelet (platformë, organizatë, paketë, njësi, grup, depo kodi, person), bllokimet dhe delegimin, një regjistër ndryshimesh dhe miratimin nga një person i dytë, të gjitha pa shkruar një tabelë cilësimesh. Kjo është arsyeja pse shkalla më e lirë është shpesh e mjaftueshme: nëse sjellja që dëshironi ekziston tashmë dhe ka nevojë vetëm për një vlerë tjetër për njësinë e Roterdamit, ky është një cilësim.
Një aftësi e Skills Engine ekzekutohet si vetë personi. Ajo nuk mban kurrë një çelës, dhe mund të arrijë vetëm mjetet brenda listës së lejuar të atij që e ekzekuton dhe të lexojë vetëm atë që ai person mund të hapë. Një aftësi që shton një mjet i cili kryen shkrime mbahet pezull derisa ta miratojnë dy persona, pastaj aktivizohet në mënyrë hije (shadow), pastaj në canary, dhe në fund për të gjithë.
Një shtojcë skills-only është shkalla e mesme. Ju nevojitet kur puna është kod që e zotëroni ju: një llogaritje deterministe, një punëtor radhe (queue worker), një shpërndarje (fan-out) mbi një listë. Platforma thërret kodin tuaj; kodi juaj nuk thërret kurrë një model.
Një shtojcë full-service është një produkt i vogël. Ajo zotëron një skemë Postgres, një tabelë rrugësh me një regjistër të drejtash, një frontend, një grup rolesh të bazës së të dhënave, dhe çdo detyrim izolimi në kapitullin 2.19, Rregullat që trashëgon çdo zgjerim. Është përgjigjja e duhur më shpesh sesa druhen njerëzit dhe përgjigjja e gabuar më shpesh sesa shpresojnë ata.
Cili më duhet?
Filloni në krye të kësaj tabele dhe ndaloni te rreshti i parë që ju përshtatet.
| Ju dëshironi të… | Përdorni | Pse jo diçka më të lehtë |
|---|---|---|
| Ndryshoni një vlerë ose një kufi, ose kush mund të bëjë diçka | Një cilësim ose një politikë | Nuk ekziston asgjë më e lehtë |
| Bëni që asistenti të kryejë një punë në të njëjtën mënyrë çdo herë | Një aftësi e Skills Engine | Një cilësim nuk mund të mbajë udhëzime |
| Vendosni një "buton AI" në një ekran që ekzekuton atë punë | Një aftësi e Skills Engine e lidhur me butonin | Një buton ekzekuton vetëm aftësi; nuk ka asgjë për të ndërtuar |
| Lejoni një mjet kodimi me AI të arrijë në Nexus | Një lidhje MCP përmes Workbench | Asgjë për të shkruar; personi identifikohet përmes shfletuesit të vet |
| Lexoni regjistrime nga një sistem ekzistues në modelin e njohurive | Një lidhës vetëm për lexim | Një lidhës nuk shkruan asgjë mbrapsht, kështu që nuk mbart asnjë rrezik shkrimi |
| Ekzekutoni kod determinist që e zotëroni ju sipas orarit të platformës | Një shtojcë skills-only me një aftësi host_callback ose plugin_queue |
Një aftësi e Skills Engine nuk mund të ekzekutojë kodin tuaj |
| Shtoni një ose dy ekrane brenda guaskës | Një shtojcë ui-only |
Vetëm shtojcat shtojnë ekrane |
| Mbani regjistrimet tuaja pas rrugëve dhe të drejtave tuaja | Një shtojcë full-service |
Vetëm ky nivel zotëron një skemë |
| Jepini një roli një pamje më të ngushtë të ekraneve të një industrie | Një lente mbi një paketë ekzistuese | Një lente është e dhënë, jo kod |
| Sillni modelin e njohurive dhe lentet e një industrie, me ekrane telefoni, në disa njësi | Një paketë domeni | Një shtojcë e vetme nuk ka lente apo portë licence |
Te Corrán Orbital pyetja e planifikimit të kalimeve mbeti një aftësi e Skills Engine. Përhapja e orbitës që i nevojitet u bë një shtojcë skills-only me një aftësi host_callback, sepse puna numerike është e jona dhe duhet të japë të njëjtën përgjigje dy herë. Bordi ynë i rishikimit të anomalive u bë një shtojcë full-service, sepse mban regjistrimet e veta se kush e pa cilën shmangie telemetrike dhe çfarë vendosën. Paketa erdhi e fundit, kur një njësi e dytë kërkoi të njëjtën gjë.
Si kombinohen pjesët
Blloqet ndërtuese kombinohen nga poshtë lart. Një paketë domeni është shembulli më i qartë, sepse është një grupim i të tjerave plus një portë licence:
- një model njohurish, llojet e gjërave që njeh industria dhe si lidhen ato, shpesh i ndërtuar mbi një model bazë nga një paketë tjetër;
- lente, nga një për çdo rol, ku secila ngushton një lente bazë;
- shabllone dhe rrjedha pune, si dhe aftësitë e Skills Engine që ato thërrasin;
- shtojca aty ku paketa ka nevojë për kodin e vet;
- lidhës vetëm për lexim drejt sistemeve që tashmë i mbajnë regjistrimet;
- një mbishtresë celulare (mobile overlay) që përcakton cilat karta dhe hapa regjistrimi shfaqen në telefona;
- dhe e drejta e përdorimit (entitlement): grupet e veçorive që duhet të mbartë licenca përpara se ndonjëra prej tyre të aktivizohet.
Asnjë nga këto nuk është infrastrukturë e brendshme për çdo aplikacion veçmas. Paketa nuk ofron asnjë kod izolimi të vetin, asnjë klient modeli dhe asnjë kontroll licence: ajo trashëgon ato të platformës. Ky është subjekti i kapitullit tjetër, dhe është arsyeja pse një autor pakete në një bankë dhe një në një port shkruajnë të njëjtën sasi kodi sigurie, që është zero.
Nivelet e besimit
Çdo shtojcë deklaron një nivel trust në manifestin e saj. Besimi nuk është një portë që SDK-ja mund ta anashkalojë. Është metadatë këshilluese që platforma e lexon për të vendosur se sa të izoluara ekzekutohen kontributet e një shtojce dhe cilat janë të dhënat më të ndjeshme që mund të prekin aftësitë e saj. Portat aktive (klasifikimi dhe vendndodhja e të dhënave, eksporti dhe shpenzimet) qëndrojnë pikërisht aty ku janë.
| Besimi | Për kë është | Qëndrimi i izolimit | Tavani i klasifikimit |
|---|---|---|---|
core |
Kodi i palës së parë që vjen me platformën | none: e njëjta origjinë (same-origin), pa izolim shtesë |
restricted |
verified |
Një palë e tretë e rishikuar, një publikues i verifikuar | Ndërfaqe same-origin, aftësi të ndërmjetësuara |
restricted |
community |
Një palë e tretë e parishikuar; parazgjedhja për një shtojcë të re | Ndërfaqe sandboxed, aftësi të ndërmjetësuara |
tenant |
untrusted |
Çdo gjë nga një burim i panjohur | strict: ndërfaqe në sandbox, vetëm aftësi të ndërmjetësuara, pa besim te hosti |
public |
Nga kjo tabelë rrjedhin dy rregulla, dhe create-nexus-plugin validate i zbaton të dyja përpara se të ndërtohet ndonjë gjë.
Së pari, classification i një aftësie nuk mund të tejkalojë tavanin e shtojcës së saj. Klasifikimet renditen public, pastaj tenant, pastaj restricted. Një shtojcë community që deklaron një aftësi restricted dështon të ndërtohet.
Së dyti, vetëm shtojcat core dhe verified mund të deklarojnë aftësi që arrijnë te AI Provider Router. Këto janë nivelet tool_using dhe llm_only. Një shtojcë community ose untrusted ndërmjetëson punën deterministe (host_callback, plugin_queue, dhe map mbi to) dhe i kërkon platformës të bëjë çdo gjë që ka nevojë për një model. Shtojca ime e parë ishte community, dhe humba një pasdite duke u përpjekur të deklaroja një aftësi përmbledhëse llm_only përpara se të kuptoja se refuzimi ishte vetë qëllimi.
Nëse e lini jashtë trust, SDK-ja e trajton shtojcën si community. Një fushë e lënë jashtë nuk mund të jetë kurrë një ngritje në nivel.
Nivelet e izolimit nga 1 deri në 4
Veçmas nga besimi, blloku runtime i manifestit tregon se si ekzekutohet shtojca. isolationLevel është një numër i plotë nga 1 në 4, dhe mënyra e ekzekutimit rrjedh prej tij. Ju nuk i zgjidhni të dyja në mënyrë të pavarur: validuesi e nxjerr njërën nga tjetra dhe refuzon një manifest çifti i të cilit nuk përputhet.
isolationLevel |
executionMode |
Çfarë do të thotë |
|---|---|---|
| 1 | external_https |
Shtojca ekzekutohet jashtë instalimit dhe arrihet përmes HTTPS |
| 2 | mcp_container |
Një kontejner që ekspozon mjetet MCP |
| 3 | hardened_docker |
Një kontejner i përforcuar në pod-et e vetë shtojcës; parazgjedhja e shabllonit |
| 4 | firecracker |
Një microVM, ndarja më e fortë |
"runtime": {
"nodeVersion": "20",
"executionMode": "hardened_docker",
"isolationLevel": 3,
"entrypoint": "dist/server.js",
"healthCheck": "/health"
}Kërkohet entrypoint. Pikat hyrëse (entrypoints) janë artefakte të dërguara në paketë dhe nuk merren kurrë gjatë ekzekutimit: SDK-ja nuk ka fare rrugë për importim dinamik ose ngarkim nga distanca, kështu që besimi shkruhet dhe kontrollohet një herë, pastaj ngrihet, dhe nuk shkarkohet kurrë.
Çfarë merrni përsipër në çdo shkallë
Çdo shkallë mbi cilësimet ka një kosto për t'u mirëmbajtur. Ja sa ju kushton secila prej tyre.
- Një aftësi e Skills Engine ka nevojë për raste testimi, një rishikues që nuk jeni ju, dhe një historik versionesh për të cilin do t'ju pyesin kur të mos sillet siç duhet. Të njëjtat bajt nuk publikohen kurrë dy herë (
CONTENT_HASH_ALREADY_PUBLISHED), kështu që "thjesht ringarkoje" nuk është një zgjidhje. - Një shtojcë ka nevojë për një manifest tabela e rrugëve e të cilit përputhet me rrugët që regjistron kodi juaj, në të dyja drejtimet. Një rrugë që ekziston por nuk është e deklaruar përbën një dështim përputhshmërie, dhe po ashtu është edhe një rrugë e deklaruar që kodi nuk e regjistron kurrë.
- Një shtojcë
full-servicezotëron një skemë me pesë role të bazës së të dhënave, siguri në nivel rreshti (row-level security) të detyruar në çdo tabelë, dhe një proces nisjeje që refuzon të pranojë thirrje derisa baza e të dhënave të vërtetojë se kufiri mbrojtës funksionon. Ajo gjithashtu rishpreh tre ligjet e platformës në manifestin e saj, fjalë për fjalë. - Një paketë domeni është e licencuar. Ajo aktivizohet një njësi në të njëjtën kohë, përmes një faze pilot, dhe licenca e organizatës duhet ta mbulojë atë. Nuk jeni ju që vendosni nëse një klient e ka atë.
- Një lente mund vetëm të heqë. Nëse një rol ka nevojë të shohë më shumë, lentja bazë duhet të ndryshojë, gjë që kërkon një bisedë me këdo që e zotëron atë bazë.
Asnjë nga këto kosto nuk mund të negociohet për çdo aplikacion veçmas, dhe ky është kompromisi. Ju hiqni dorë nga pak liri në shtojcën e parë dhe e fitoni atë mbrapsht në çdo shtojcë pas saj.
CONNECTION_SCOPE_EXCEEDED.Mjetet dhe lidhjet MCP
MCP shfaqet në tre vende, dhe është e lehtë të ngatërrohen.
Një shtojcë mund të publikojë mjete MCP duke i deklaruar ato në mcpTools[]: një name, një description dhe një inputSchema. I vetmi rregull që shton validuesi është se një inputSchema nuk mund të përdorë një oneOf, allOf ose anyOf të nivelit të lartë, sepse një kombinator në krye të skemës bën që çdo klient MCP që importon mjetin të dështojë me një gabim 400. Një shtojcë në isolationLevel 2 ekzekutohet si një mcp_container.
Biblioteka e Skills Engine është e arritshme përmes MCP. Claude Code dhe agjentët përdorin trembëdhjetë mjete MCP për të gjetur dhe përputhur aftësitë, për t'i ekzekutuar ato dhe për të regjistruar ekzekutimin, si dhe për t'i krijuar, importuar ose sinkronizuar ato, dhe çdo thirrje ekzekutohet si personi që e nisi atë, brenda listës së tij të lejuar.
Dhe një mjet kodimi me AI lidhet përmes Workbench: një adresë për çdo instalim, një identifikim përmes shfletuesit të personit, një leje kalimi njëorëshe në vend të një çelësi të ruajtur, dhe vetëm mjetet që ai person zgjedh. Kapitulli 2.26, Ndërtimi me mjete kodimi me AI, e shpjegon këtë hap pas hapi.
Lidhësit janë fqinji më i qetë. Modeli i njohurive i një pakete domeni ushqehet nga lidhës vetëm për lexim drejt sistemeve të tilla si administrimi i policave ose një sistem dëmshpërblimesh, secili me një orar dhe një buton testimi. Asgjë nuk shkruhet mbrapsht në burim.
Nga dega juaj te ekranet e njerëzve
Në cilëndo shkallë që të jeni, rruga drejt prodhimit (production) është e njëjtë. Çdo lëshim kalon nga hapësira juaj e zhvillimit në staging, pastaj në një njësi pilot, pastaj në të gjitha njësitë, dhe çdo hap ka porta kontrolli: teste, një manifest që nuk është zgjeruar, një provë (dry run) në një kopje të maskuar, dhe rishikues të emëruar që nuk janë autori. Një promovim që përpiqet të kapërcejë një hap refuzohet me GATE_CANNOT_BE_SKIPPED. Çdo mjedis ruan versionin e mëparshëm për 30 ditë, dhe rikthimi (rollback) i një njësie pas është një ndryshim i rishikuar që zgjat rreth një minutë.
Vetë shpërndarja (deployment) kalon vetëm përmes kanaleve të lëshimit të instalimit. Njësitë zgjedhin kanalin e tyre, dhe administratori i tyre bie dakord për çdo lëvizje. Ju shihni numërimet dhe normat e gabimeve për çdo njësi në faqen Kanalet dhe instalimet, por kurrë atë se çfarë ka bërë dikush me zgjerimin tuaj. Kapitulli 2.28, Lëshimi i zgjerimit tuaj, mbulon anën e lëshimit nga fillimi në fund.
Një shënim mbi edicionet
Pjesa më e madhe e kësaj shkalle ekziston në të dyja edicionet. Community merr cilësimet dhe aftësitë e Skills Engine, shtojcat në çdo nivel, dhe të njëjtat rrugë të arta në një server të vetëm me kodin në hostin tuaj Git. Enterprise shton promovimin nga hapësira e zhvillimit përmes staging në një njësi pilot me portat e saj të kontrollit, plus klasterët e publikuesve dhe kopjet e maskuara të të dhënave reale. Ai shton gjithashtu katalogun tuaj privat dhe paketat e domenit. Kapitulli 2.25, Ndërtimi për çdo edicion, përmban detajet.
Kapitulli tjetër është ai që duhet lexuar përpara se të shkruani çfarëdo kodi. Ka pak zgjedhje dhe shumë rregulla, dhe rregullat janë të njëjta si për zgjerimin e parë ashtu edhe për të mijtin.



