NeboAI
NeboAI
Kezdés

Képességek és jóváhagyások

A képesség egy rendszertípust nevez meg, például levelezést vagy főkönyvet, és a rajta végezhető műveleteket. A munkatárscsomagok deklarálják, mely képességekre van szükségük; a bővítmények deklarálják, melyeket biztosítják; a tulajdonos felvételkor összeköti a kettőt. A jóváhagyások a műveletekhez kapcsolódnak, így ugyanazok a szabályok érvényesek, bármelyik rendszer is tölti be a képességet.

A modell

  • A képesség egy típusos interfész, soha nem egy termék. A mail műveletei: mail.inbox.read, mail.inbox.search és mail.message.send.
  • A munkatárscsomag a requires.interfaces mezőben sorolja fel a szerepköréhez szükséges képességeket.
  • A bővítmény úgy biztosít egy képességet, hogy az interfaceBindings mezőben a műveleteit a saját parancsaihoz köti.
  • A kapcsolat az a bővítmény, amelyet a tulajdonos az adott képességhez csatlakoztatott. Egy képességet megnevező figyelőindító ezen fut.

Deklarálja, mire van szüksége egy szerepkörnek

{
  "requires": { "interfaces": ["mail", "ledger"] },
  "ceiling": { "ledger.bill.create": "approval" }
}

Képességeket nevezzen meg, ne bővítményeket. A ledger képességet igénylő munkatárscsomag minden cégnél működik, bármilyen könyvelési rendszert használ is. A requires.plugins mezőt csak akkor használja, ha egy szerepkör tényleg egy konkrét bővítménytől függ.

Képesség biztosítása

"interfaceBindings": {
  "mail.inbox.read": "messages list --folder inbox",
  "mail.inbox.search": "messages search --query {query}",
  "mail.message.send": "messages send"
}

Az a bővítmény, amely bármely mail.* műveletet köt, a mail képességet biztosítja. Minden kötésből a munkatársak számára egy típusos eszköz is lesz, például mail_message_send. A sablonszintaxist lásd: plugin.json referencia.

Amikor egy munkafolyamat egy képességet figyel, a Nebo azt a telepített bővítményt választja, amely biztosítja, előnyben részesítve azt, amelyben ennek a munkatársnak fiókja van, ezután betűrendben. Ha nincs ilyen, a munkafolyamat megmarad, csökkentett állapotúként jelölődik, és a tulajdonos értesítést kap arról, mit kell csatlakoztatnia.

A katalógus

A Nebo képességek és műveleteik katalógusával érkezik, köztük: ledger, mail, sms, telephony, calendar, drive, helpdesk, kb, deals, esign, timebilling, projects, cms, social, ads, reviews, email-marketing, repo, ci, deploy, monitoring és incidents. A katalógus közös szókincs, nem kerítés. Használja a kifejezéseit, ahol csak illenek, hogy a különböző közzétevők munkatársai és bővítményei egymásra találjanak; egy új kifejezés konvenció kérdése, nem hiba.

Minden művelet a három jelölés egyikét viseli.

JelölésJelentés
SzabadOlvasás, vagy olyan védő művelet, amely visszafordítható, és elveszíti az értékét, ha várnia kell, például szüneteltetés, megszakítás vagy visszaállítás. Kérdés nélkül fut.
Jóváhagyáshoz kötöttPénzt mozgat, a cégen kívüli személlyel lép kapcsolatba, vagy nem vonható vissza. A Nebo a kötött eszköz futása előtt rákérdez.
KritikusPénzmozgás, szerződéskötés, a cég saját nyilvántartásai, vagy állandó felhatalmazás felügyelet nélküli cselekvésre. Mindig jóváhagyáshoz kötött; a tulajdonos munkatársanként és műveletenként egyenként adja meg, és semmilyen munkatársszintű beállítás nem lazít rajta.

Hozzájárulás felvételkor

Amikor egy tulajdonos felvesz egy munkatársat, a Nebo a csomagból olvassa ki az igényeit: a requires.interfaces képességeit, a requires.plugins bővítményeit, és minden képességet vagy bővítményt, amelyet egy figyelőindító megnevez. A tulajdonos egyetlen mondatot lát, amely ezeket az igényeket közli. A felvétel állandó engedélyként adja meg őket az adott munkatársnak. A jóváhagyáshoz kötött műveletek jóváhagyási tételek maradnak.

Egy bővítmény, MCP-szerver, alkalmazás vagy készség telepítése maga az engedély a használatára; ezeket nem kell egyenként bekapcsolni. A Nebo saját beépített képességei ezekbe a csoportokba tartoznak: chat, file, shell, web, contacts, desktop, media és system.

Plafonok és jogszabályok

Hol deklarálvaHatás
ceiling az agent.json fájlbanA felsorolt műveletek ennél a munkatársnál mindig megkérdezik a tulajdonost. Az egyetlen érték: "approval".
Egy jogszabály ceiling mezője a céges rétegbenA felsorolt műveletek minden munkatárs számára tiltottak.
Egy céges jogszabály reserved_to: owner értékkelA felsorolt műveletekhez a tulajdonos saját jóváhagyása kell, és ez a jóváhagyás soha nem adható át egy munkatársnak.

Engedélyezési módok

Minden munkatársnak van engedélyezési módja. Ez dönt azokról a hívásokról, amelyeket egyetlen szabály sem rendez, és a tulajdonos egyetlen futtatásra felülbírálhatja.

MódViselkedés
automaticAz alapértelmezés. A munkatárs a munkakörén belül cselekszik, és csak a jóváhagyáshoz kötött műveleteknél és a tulajdonos kérdezési szabályainál kérdez.
askMinden valamit megváltoztató hívás rákérdez, hacsak egy engedélyező szabály nem fedi le.
planCsak olvasás és tervezés. A valamit megváltoztató hívás nem fut le.
full_accessSemmi sem kérdez. A tiltó szabályok és a szigorú korlátok továbbra is érvényesek.

A Nebo minden műveletet ugyanabban a sorrendben ellenőriz: előbb a szigorú korlátokat, aztán a plafonokat és a jogszabályokat, aztán a tulajdonos szabályait, végül a módot. A szigorú korlátok, például a hitelesítő adatok kiszivárgás elleni védelme, soha nem oldódnak fel, még full_access módban sem.