Versija 1.0.0-alpha.1naujausia
2.18 skyrius
Plėtinių modelis
Šeši būdai išplėsti Nexus – nuo parametro iki srities paketo, kiekvieno iš jų ribos ir kaip pasitikėjimo bei izoliacijos lygiai lemia, kur vykdomas jūsų kodas. Perskaitykite tai prieš atidarydami programinės įrangos kūrimo rinkinį (SDK).
Šį puslapį iš originalo anglų kalba išvertė DI. Jei kas nors neaišku, remkitės puslapiu anglų kalba. Skaityti šį puslapį anglų kalba

Pirmasis dalykas, kurį sukūriau su Nexus bendrovėje Corrán Orbital, nebuvo įskiepis. Mūsų skrydžio dinamikos komanda norėjo, kad asistentas į klausimą „kurių antžeminių stočių praskridimų netektume, jei Svalbardo antena būtų išjungta techninei priežiūrai?“ kiekvieną kartą atsakytų ta pačia forma: pirmiausia praskridimų lentelė, o po ja – kaina ryšio minutėmis. Pusę dienos skaičiau programinės įrangos kūrimo rinkinio (SDK) dokumentaciją, kol kolega atkreipė dėmesį, kad man reikia įgūdžio: aplanko su SKILL.md, įkelto į Skills Engine ir paskelbto, kai buvo įvykdyti jo testai ir jį patvirtino peržiūrėtojas. Tai užtruko keturiasdešimt minučių.
Po dviejų įskiepių ir vieno srities paketo vis dar pirmiausia duodu šį patarimą. Nexus galima išplėsti šešiais būdais, ir jie išsidėsto pastangų laiptais. Pigios pakopos leidžia nuveikti daugiau, nei žmonės tikisi, o brangiosios atneša įsipareigojimų, kuriuos lengva nuvertinti. Šiame skyriuje šie laiptai aprašyti. Rinkitės žemiausią pakopą, kuri atlieka darbą. Tolesniuose skyriuose kiekviena pakopa nagrinėjama išsamiai: 2.19 skyrius, Taisyklės, kurias paveldi kiekvienas plėtinys; 2.20 skyrius, Įgūdžiai; 2.21 skyrius, Plugin SDK; 2.22 skyrius, Įskiepių vykdymo aplinka; ir 2.23 skyrius, Srities paketai.
Šeši statybiniai blokai
Štai jie ta tvarka, kuria turėtumėte juos svarstyti.
- Nustatymai ir politikos. Tai reikšmės, kurias administratorius konsolėje nustato organizacijai, padaliniui ar vienam asmeniui, neperžengdamas to, ką leidžia licencija. Jums visai nereikia rašyti kodo.
- Skills Engine įgūdžiai.
SKILL.mdpaketas, kuriame yra instrukcijos ir įrankiai, kuriuos įgūdis gali kviesti, o šalia – pasirinktiniai failai ir scenarijai. Asistentas, agentai, darbo eigos ir DI (dirbtinio intelekto) mygtukai ekranuose vykdo tuos pačius įgūdžius, kaip ir jūsų IDE (integruota kūrimo aplinka). - Įskiepiai. Jūsų pačių kodas, aprašytas manifestu ir sukurtas SDK įrankiais. Įskiepis priklauso vienai iš trijų pakopų:
skills-only,ui-onlyarbafull-service. - Srities paketai. Vienos pramonės šakos rakursai ir šablonai, jos įgūdžiai ir žinių modelis, jungtys ir telefono ekranai, licencijuojami kaip visuma. Adverant pateikia dešimt paketų; galite sukurti ir savo.
- Rakursai. Tai, ką vienas vaidmuo mato pakete ar platformoje. Rakursas susiaurina bazinį rakursą ir niekada jo neišplečia.
- MCP ryšiai ir jungtys. Model Context Protocol (MCP) įrankiai, kuriuos skelbia įskiepis arba per kuriuos jungiasi DI programavimo įrankis, ir tik skaitymo jungtys, perkeliančios įrašus iš jau naudojamų sistemų.
Du žodžiai turi per daug reikšmių, todėl iškart juos apibrėšiu. Skills Engine įgūdis yra SKILL.md paketas bibliotekoje. Manifesto įgūdis yra tipizuota eilutė įskiepio skills[] masyve, sukompiliuota į platformos įgūdžių registrą ir vykdoma per UNO – darbo eigų variklį. Ekrane abu vadinami įgūdžiais. Jie rašomi ir valdomi skirtingai, o šioje dokumentacijoje visada nurodoma, kuris turimas omenyje.
Ką kiekvienas iš jų gali daryti, o ko negali
Lentelė – tai trumpoji versija. Stulpelį „ko negali“ įtraukiau sąmoningai: kiekvienas apribojimas yra projekto savybė, ir kiekvienas iš jų mane nuo ko nors apsaugojo.
| Sudedamoji dalis | Ką gali | Ko negali | Kas kuria |
|---|---|---|---|
| Nustatymas arba politika | Keisti funkcijos veikimą bet kuriuo lygmeniu nuo organizacijos iki vieno asmens; užrakinti reikšmę; deleguoti ją žemyn; reikalauti antro asmens patvirtinimo pakeitimui | Pridėti ekraną ar maršrutą, saugoti naują lentelę ar pradėti naujos rūšies darbą | Administratorius, konsolėje |
| Skills Engine įgūdis | Suteikti asistentui ir agentams, darbo eigoms bei DI mygtukams pakartojamą būdą atlikti vieną darbą, su savomis instrukcijomis ir testavimo atvejais | Laikyti prisijungimo duomenis; kviesti įrankį už jį vykdančio asmens leidžiamųjų sąrašo ribų (SKILL_CANNOT_WIDEN_TOOLS); tapti aktyviu be savo testų ir patvirtinimo |
Bet kas, turintis teisę, kūrimo priemonėje arba iš savo IDE |
Įskiepis, skills-only |
Skelbti manifesto įgūdžius, vykdomus platformoje: pagrindinės sistemos atgalinius iškvietimus, eilės darbus, operacijas su sąrašu, o esant pasitikėjimo lygiui core arba verified – ir modeliu grindžiamus įgūdžius |
Teikti savų puslapių | Kūrėjas, naudodamas SDK |
Įskiepis, ui-only |
Pridėti priekinės sąsajos paviršių apvalkalo viduje | Saugoti savų duomenų ar vykdyti skaičiavimų | Kūrėjas, naudodamas SDK |
Įskiepis, full-service |
Savą serverinę ir priekinę dalį, Postgres schemą, maršrutų lentelę su teisėmis, įgūdžius ir MCP įrankius | Kviesti modelių tiekėjo; laikyti modelio rakto; skaityti kitos organizacijos eilučių, išskyrus per užregistruotą suteikimą; vykdyti skaičiavimų už UNO paskirstymo ribų | Kūrėjas, naudodamas SDK |
| Srities paketas | Pateikti pramonės šakos rakursus ir šablonus, įgūdžius ir darbo eigas, žinių modelį, įrodymų žemėlapį ir telefono ekranus administratoriaus pasirinktiems padaliniams | Keisti apvalkalo ar jo komponentų arba rašymo taisyklių; veikti, jei organizacijos licencija jo neapima | Adverant arba jūsų pačių kūrėjai, naudojant Enterprise |
| Rakursas | Pasirinkti korteles ir laukus, kuriuos vienas vaidmuo mato pakete ar platformoje, ir siūlomus veiksmus | Rodyti ko nors, ką slepia jo bazinis rakursas (LENS_CANNOT_WIDEN); keisti, ką vaidmuo gali daryti |
Jį sukuria paketo autorius; administratorius suteikia jį kiekvienam padaliniui |
| MCP įrankiai ir jungtys | Atverti įskiepio įrankius agentams ir programavimo įrankiams; nuskaityti įrašus iš poliso sistemos ar telemetrijos archyvo į žinių modelį | Rašyti atgal į šaltinio sistemą per jungtį; veikti už prisijungusio asmens leidimų ribų | Kūrėjas aprašo MCP įrankius; administratorius sukonfigūruoja jungtis |
Keli iš šių langelių nusipelno dar vieno sakinio.
Nustatymai yra karkasas, ir kiekvienas įskiepis naudoja tą patį. Įskiepis, savo manifeste aprašęs settings bloką, gauna lygmenis (platforma, organizacija, paketas, padalinys, grupė, saugykla, asmuo), užraktus ir delegavimą, pakeitimų žurnalą ir antro asmens patvirtinimą – visa tai nerašydamas nustatymų lentelės. Todėl pigiausios pakopos dažnai pakanka: jei norima elgsena jau egzistuoja ir jai tik reikia kitokios reikšmės Roterdamo padaliniui, tai nustatymas.
Skills Engine įgūdis veikia asmens vardu. Jis niekada nelaiko rakto, gali pasiekti tik įrankius, esančius jį vykdančio asmens leidžiamųjų sąraše, ir skaityti tik tai, ką tas asmuo gali atidaryti. Įgūdis, pridedantis įrašymo įrankį, sulaikomas, kol jį patvirtina du žmonės, tada pradeda veikti šešėliniu režimu, vėliau – kanarėlės režimu, o galiausiai – visiems.
skills-only įskiepis yra vidurinė pakopa. Jo reikia, kai darbas yra jums priklausantis kodas: deterministinis skaičiavimas, eilės apdorojimo procesas, išskaidymas per sąrašą. Platforma kviečia jūsų kodą; jūsų kodas niekada nekviečia modelio.
full-service įskiepis yra mažas produktas. Jam priklauso Postgres schema, maršrutų lentelė su teisių registru, priekinė sąsaja, duomenų bazės vaidmenų rinkinys ir visi izoliacijos įsipareigojimai, aprašyti 2.19 skyriuje, Taisyklės, kurias paveldi kiekvienas plėtinys. Jis yra teisingas sprendimas dažniau, nei žmonės baiminasi, ir neteisingas dažniau, nei jie tikisi.
Kurio man reikia?
Pradėkite nuo šios lentelės viršaus ir sustokite ties pirma tinkančia eilute.
| Norite… | Naudokite | Kodėl ne kas nors lengvesnio |
|---|---|---|
| Pakeisti reikšmę ar ribą arba tai, kas gali ką nors daryti | Nustatymą arba politiką | Nieko lengvesnio nėra |
| Kad asistentas kiekvieną kartą vieną darbą atliktų taip pat | Skills Engine įgūdį | Nustatymas negali talpinti instrukcijų |
| Ekrane įdėti „DI mygtuką“, kuris vykdo tą darbą | Su mygtuku susietą Skills Engine įgūdį | Mygtukas tik vykdo įgūdžius; nieko kurti nereikia |
| Leisti DI programavimo įrankiui pasiekti Nexus | MCP ryšį per Workbench | Nieko rašyti nereikia; asmuo prisijungia per savo naršyklę |
| Nuskaityti įrašus iš esamos sistemos į žinių modelį | Tik skaitymo jungtį | Jungtis nieko neįrašo atgal, todėl nekelia įrašymo rizikos |
| Vykdyti jums priklausantį deterministinį kodą pagal platformos tvarkaraštį | skills-only įskiepį su host_callback arba plugin_queue įgūdžiu |
Skills Engine įgūdis negali vykdyti jūsų kodo |
| Pridėti vieną ar du ekranus apvalkalo viduje | ui-only įskiepį |
Ekranus prideda tik įskiepiai |
| Laikyti savo įrašus už savų maršrutų ir teisių | full-service įskiepį |
Schemą turi tik ši pakopa |
| Suteikti vienam vaidmeniui siauresnį pramonės šakos ekranų vaizdą | Rakursą esamame pakete | Rakursas yra duomenys, o ne kodas |
| Pateikti pramonės šakos žinių modelį ir rakursus su telefono ekranais keliems padaliniams | Srities paketą | Vienas įskiepis neturi nei rakursų, nei licencijos patikros |
Corrán Orbital bendrovėje praskridimų planavimo klausimas liko Skills Engine įgūdžiu. Jam reikalingas orbitos skaičiavimas tapo skills-only įskiepiu su vienu host_callback įgūdžiu, nes skaitinis darbas yra mūsų ir du kartus turi duoti tą patį atsakymą. Mūsų anomalijų peržiūros komisija tapo full-service įskiepiu, nes ji saugo savus įrašus apie tai, kas peržiūrėjo kurį telemetrijos nuokrypį ir ką nusprendė. Paketas atsirado paskutinis, kai to paties panoro antras padalinys.
Kaip dalys jungiamos tarpusavyje
Sudedamosios dalys jungiasi aukštyn. Srities paketas yra aiškiausias pavyzdys, nes tai kitų dalių rinkinys su licencijos patikra:
- žinių modelis – dalykų, kuriuos pramonės šaka žino, rūšys ir jų sąsajos, dažnai sukurtas remiantis baziniu kito paketo modeliu;
- rakursai, po vieną kiekvienam vaidmeniui, kiekvienas susiaurinantis bazinį rakursą;
- šablonai ir darbo eigos bei jų kviečiami Skills Engine įgūdžiai;
- įskiepiai, kai paketui reikia savo kodo;
- tik skaitymo jungtys į sistemas, kuriose jau yra įrašai;
- mobilusis sluoksnis, nurodantis, kurios kortelės ir fiksavimo žingsniai rodomi telefonuose;
- ir teisė naudotis: funkcijų grupės, kurias turi apimti licencija, kad kas nors iš to įsijungtų.
Niekas iš to nėra atskirai kiekvienai programai kuriama infrastruktūra. Paketas nepateikia jokio savo izoliacijos kodo, modelio kliento ar licencijos patikros: jis paveldi platformos. Tai kito skyriaus tema, ir būtent dėl to paketo autorius banke ir paketo autorius uoste rašo tiek pat saugumo kodo – visai nerašo.
Pasitikėjimo lygiai
Kiekvienas įskiepis savo manifeste nurodo trust lygį. Pasitikėjimas nėra užtvara, kurią SDK galėtų apeiti. Tai patariamieji metaduomenys, kuriuos platforma skaito, kad nuspręstų, kiek izoliuotai vykdomi įskiepio komponentai ir kokie jautriausi duomenys gali būti pasiekiami jo įgūdžiams. Veikiančios užtvaros (klasifikavimas ir duomenų buvimo vieta, eksportas ir išlaidos) lieka lygiai ten, kur yra.
| Pasitikėjimas | Kam jis skirtas | Izoliacijos režimas | Klasifikavimo riba |
|---|---|---|---|
core |
Pirmosios šalies kodas, pateikiamas platformoje | none: ta pati kilmė, be papildomos izoliacijos |
restricted |
verified |
Peržiūrėta trečioji šalis, patvirtintas leidėjas | same-origin paviršius, tarpininkaujami įgūdžiai |
restricted |
community |
Neperžiūrėta trečioji šalis; numatytoji reikšmė naujam įskiepiui | sandboxed paviršius, tarpininkaujami įgūdžiai |
tenant |
untrusted |
Bet kas iš nežinomo šaltinio | strict: izoliuotas paviršius, tik tarpininkaujami įgūdžiai, jokio pagrindinės sistemos pasitikėjimo |
public |
Iš šios lentelės išplaukia dvi taisyklės, ir create-nexus-plugin validate jas abi užtikrina prieš ką nors sukuriant.
Pirma, įgūdžio classification negali viršyti jo įskiepio ribos. Klasifikacijos rikiuojamos taip: public, tada tenant, tada restricted. community įskiepis, aprašantis restricted įgūdį, nesukompiliuojamas.
Antra, tik core ir verified įskiepiai gali aprašyti įgūdžius, pasiekiančius AI Provider Router. Tai tool_using ir llm_only pakopos. community arba untrusted įskiepis tarpininkauja deterministiniam darbui (host_callback, plugin_queue ir map su jais) ir prašo platformos atlikti viską, kam reikia modelio. Mano pirmasis įskiepis buvo community, ir praradau popietę bandydamas aprašyti llm_only santraukos įgūdį, kol supratau, kad atsisakymas ir yra esmė.
Jei praleidžiate trust, SDK įskiepį laiko community. Praleistas laukas niekada negali reikšti paaukštinimo.
1–4 izoliacijos lygiai
Atskirai nuo pasitikėjimo manifesto runtime blokas nurodo, kaip įskiepis vykdomas. isolationLevel yra sveikasis skaičius nuo 1 iki 4, o vykdymo režimas išplaukia iš jo. Šių dviejų nepasirenkate nepriklausomai: tikrintuvas išveda vieną iš kito ir atmeta manifestą, kurio pora nesutampa.
isolationLevel |
executionMode |
Ką tai reiškia |
|---|---|---|
| 1 | external_https |
Įskiepis veikia už diegimo ribų ir pasiekiamas per HTTPS |
| 2 | mcp_container |
Konteineris, atveriantis MCP įrankius |
| 3 | hardened_docker |
Sustiprintas konteineris paties įskiepio poduose; šablono numatytoji reikšmė |
| 4 | firecracker |
MicroVM – stipriausias atskyrimas |
"runtime": {
"nodeVersion": "20",
"executionMode": "hardened_docker",
"isolationLevel": 3,
"entrypoint": "dist/server.js",
"healthCheck": "/health"
}entrypoint yra privalomas. Įėjimo taškai yra pateikiami artefaktai ir niekada neatsiunčiami vykdymo metu: SDK visai neturi dinaminio importavimo ar nuotolinio įkėlimo kelio, todėl pasitikėjimas užrašomas ir patikrinamas vieną kartą, tada užfiksuojamas ir niekada neatsiunčiamas.
Kam įsipareigojate kiekvienoje pakopoje
Kiekvieną pakopą virš nustatymų reikia prižiūrėti, o tai kainuoja. Štai ką jums kainuoja kiekviena iš jų.
- Skills Engine įgūdžiui reikia testinių atvejų, peržiūrėtojo, kuris nėra jūs, ir versijų istorijos, apie kurią jūsų klaus, kai jis veiks netinkamai. Tie patys baitai niekada neskelbiami du kartus (
CONTENT_HASH_ALREADY_PUBLISHED), todėl „tiesiog įkelkite iš naujo“ nėra sprendimas. - Papildiniui reikia manifesto, kurio maršrutų lentelė abiem kryptimis atitinka maršrutus, kuriuos registruoja jūsų kodas. Maršrutas, kuris egzistuoja, bet nėra deklaruotas, yra atitikties pažeidimas, kaip ir deklaruotas maršrutas, kurio kodas niekada neregistruoja.
full-servicepapildinys valdo schemą su penkiais duomenų bazės vaidmenimis, eilučių lygio sauga, priverstinai taikoma kiekvienai lentelei, ir paleidimu, kuris nepradeda priimti užklausų, kol duomenų bazė neįrodo, kad užtvara laikosi. Savo manifeste jis taip pat pažodžiui pakartoja tris platformos dėsnius.- Domeno paketas yra licencijuojamas. Jis įjungiamas po vieną padalinį, per bandomąjį etapą, ir organizacijos licencija turi jį apimti. Ne jūs sprendžiate, ar klientas jį turi.
- Lęšis gali tik apriboti. Jei vaidmeniui reikia matyti daugiau, turi būti pakeistas bazinis lęšis, o tai reikia aptarti su tuo, kam ta bazė priklauso.
Nė dėl vienos iš šių sąnaudų negalima derėtis atskirai kiekvienai programai, ir tai yra mainai. Kurdami pirmąjį papildinį atsisakote dalies laisvės, o kurdami kiekvieną paskesnį ją atgaunate.
CONNECTION_SCOPE_EXCEEDED.MCP įrankiai ir jungtys
MCP pasitaiko trijose vietose, ir jas lengva supainioti.
Papildinys gali skelbti MCP įrankius, deklaruodamas juos mcpTools[]: name, description ir inputSchema. Vienintelė taisyklė, kurią prideda tikrintuvas: inputSchema negali naudoti aukščiausiojo lygio oneOf, allOf ar anyOf, nes dėl kombinatoriaus schemos viršuje kiekvienas šį įrankį importuojantis MCP klientas patiria klaidą 400. Papildinys, kurio isolationLevel yra 2, veikia kaip mcp_container.
Skills Engine biblioteka pasiekiama per MCP. Claude Code ir agentai naudoja trylika MCP įrankių įgūdžiams rasti ir susieti, juos paleisti ir užfiksuoti paleidimą, taip pat juos kurti, importuoti ar sinchronizuoti, o kiekvienas iškvietimas vykdomas jį inicijavusio asmens vardu, neperžengiant jo leidžiamųjų sąrašo.
Be to, DI programavimo įrankis jungiasi per Workbench: vienas adresas kiekvienam diegimui, prisijungimas per asmens naršyklę, vienos valandos leidimas vietoj saugomo rakto ir tik tie įrankiai, kuriuos tas asmuo pažymi. Tai išsamiai aprašyta 2.26 skyriuje „Kūrimas su DI programavimo įrankiais“.
Jungtys yra tylesnis kaimynas. Domeno paketo žinių modelį duomenimis papildo tik skaitymo jungtys su tokiomis sistemomis kaip polisų administravimo ar žalų sistema, kiekviena su tvarkaraščiu ir testavimo mygtuku. Į šaltinį niekas atgal neįrašoma.
Nuo jūsų šakos iki žmonių ekranų
Kurioje pakopoje bebūtumėte, kelias į gamybinę aplinką yra tas pats. Kiekvienas leidimas keliauja iš jūsų kūrimo erdvės į parengiamąją aplinką, tada į bandomąjį padalinį, tada į visus padalinius, ir kiekvienas žingsnis turi patikras: testus, neišplėstą manifestą, bandomąjį paleidimą su maskuota kopija ir įvardytus peržiūrėtojus, kurie nėra autorius. Perkėlimas, kuriuo bandoma praleisti žingsnį, atmetamas su GATE_CANNOT_BE_SKIPPED. Kiekviena aplinka 30 dienų saugo ankstesnę versiją, o vieno padalinio grąžinimas į ankstesnę versiją yra peržiūrimas pakeitimas, trunkantis apie minutę.
Pats diegimas vyksta tik per diegimo leidimų kanalus. Padaliniai pasirenka savo kanalą, o jų administratorius pritaria kiekvienam perėjimui. Puslapyje „Kanalai ir diegimai“ matote kiekvieno padalinio skaičius ir klaidų dažnį, bet niekada nematote, ką kas nors darė su jūsų plėtiniu. Leidimo pusė nuo pradžios iki galo aprašyta 2.28 skyriuje „Plėtinio išleidimas“.
Pastaba apie leidimus
Didžioji šių kopėčių dalis yra abiejose versijose. Community versijoje yra nustatymai ir Skills Engine įgūdžiai, visų lygių papildiniai ir tie patys auksiniai keliai viename serveryje, o kodas laikomas jūsų pačių Git prieglobos paslaugoje. Enterprise versija prideda perkėlimą iš kūrimo erdvės per parengiamąją aplinką į bandomąjį padalinį su jo patikromis, taip pat leidėjų klasterius ir maskuotas tikrųjų duomenų kopijas. Ji taip pat prideda jūsų nuosavą privatų katalogą ir domeno paketus. Išsamiau aprašyta 2.25 skyriuje „Kūrimas kiekvienai versijai“.
Kitą skyrių verta perskaityti prieš rašant bet kokį kodą. Jame mažai pasirinkimų ir daug taisyklių, o taisyklės yra tos pačios ir pirmajam, ir tūkstantajam plėtiniui.



