NeboAI
NeboAI
Zacznij

Możliwości i zatwierdzenia

Funkcja nazywa rodzaj systemu, np. pocztę albo księgę rachunkową, oraz operacje na nim. Pakiety pracowników deklarują funkcje, których potrzebują; wtyczki deklarują te, które zapewniają; właściciel łączy jedne z drugimi przy zatrudnieniu. Zatwierdzenia są przypisane do operacji, więc te same zasady obowiązują niezależnie od tego, jaki system pełni daną funkcję.

Model

  • Funkcja to typowany interfejs, nigdy produkt. mail ma operacje mail.inbox.read, mail.inbox.search i mail.message.send.
  • Pakiet pracownika wymienia funkcje potrzebne jego roli w requires.interfaces.
  • Wtyczka zapewnia funkcję, wiążąc jej operacje z własnymi poleceniami w interfaceBindings.
  • Połączenie to wtyczka, którą właściciel podłączył dla danej funkcji. Wyzwalacz obserwacji, który wskazuje funkcję, działa na tym połączeniu.

Zadeklaruj, czego potrzebuje rola

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

Wskazuj funkcje, nie wtyczki. Pakiet pracownika wymagający ledger działa w każdej firmie, niezależnie od używanego systemu księgowego. Używaj requires.plugins tylko wtedy, gdy rola naprawdę zależy od jednej konkretnej wtyczki.

Zapewnij funkcję

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

Wtyczka, która wiąże dowolną operację mail.*, zapewnia mail. Każde powiązanie staje się też typowanym narzędziem dla pracowników, np. mail_message_send. Składnię szablonów opisuje dokumentacja plugin.json.

Gdy przepływ pracy obserwuje funkcję, Nebo wybiera zainstalowaną wtyczkę, która ją zapewnia, preferując tę, na której ten pracownik ma konto, a potem według kolejności alfabetycznej. Jeśli żadnej nie ma, przepływ pracy zostaje zachowany i oznaczony jako ograniczony, a właściciel dowiaduje się, co podłączyć.

Katalog

Nebo zawiera katalog funkcji i ich operacji, w tym ledger, mail, sms, telephony, calendar, drive, helpdesk, kb, deals, esign, timebilling, projects, cms, social, ads, reviews, email-marketing, repo, ci, deploy, monitoring i incidents. Katalog to wspólne słownictwo, a nie ogrodzenie. Używaj jego terminów wszędzie tam, gdzie pasują, żeby pracownicy i wtyczki od różnych wydawców się dogadali; nowy termin to kwestia konwencji, a nie błąd.

Każda operacja ma jedno z trzech oznaczeń.

OznaczenieZnaczenie
Bez zatwierdzeniaOdczyt albo działanie ochronne, które da się cofnąć i traci sens, jeśli czeka, np. wstrzymanie, anulowanie lub wycofanie. Działa bez pytania.
Wymaga zatwierdzeniaPrzenosi pieniądze, kontaktuje się z kimś spoza firmy lub nie da się jej cofnąć. Nebo pyta, zanim powiązane narzędzie zostanie uruchomione.
KrytycznaPrzepływ pieniędzy, zawieranie umów, własne rejestry firmy lub stałe upoważnienie do działania bez nadzoru. Zawsze wymaga zatwierdzenia; właściciel przyznaje każdą z nich osobno dla pracownika i dla operacji, a żadne ustawienie dla całego pracownika tego nie łagodzi.

Zgoda przy zatrudnieniu

Gdy właściciel zatrudnia pracownika, Nebo odczytuje jego potrzeby z pakietu: funkcje z requires.interfaces, wtyczki z requires.plugins oraz każdą funkcję lub wtyczkę wskazaną przez wyzwalacz obserwacji. Właściciel widzi jedno zdanie, które opisuje te potrzeby. Zatrudnienie przyznaje je temu pracownikowi jako stałe uprawnienia. Operacje wymagające zatwierdzenia nadal pozostają pozycjami do zatwierdzenia.

Zainstalowanie wtyczki, serwera MCP, aplikacji lub umiejętności samo w sobie jest zgodą na ich używanie; nie włącza się ich pojedynczo. Wbudowane możliwości Nebo są pogrupowane jako chat, file, shell, web, contacts, desktop, media i system.

Limity i przepisy

Gdzie deklarowaneSkutek
ceiling w agent.jsonWymienione operacje zawsze wymagają pytania właściciela w przypadku tego pracownika. Jedyna wartość to "approval".
ceiling przepisu w warstwie firmowejWymienione operacje są zablokowane dla każdego pracownika.
Przepis firmowy z reserved_to: ownerWymienione operacje wymagają osobistej zgody właściciela i tej zgody nigdy nie można przyznać pracownikowi.

Tryby uprawnień

Każdy pracownik ma tryb uprawnień. Rozstrzyga on wywołania, których nie obejmuje żadna reguła, a właściciel może go nadpisać dla pojedynczego przebiegu.

TrybZachowanie
automaticDomyślny. Pracownik działa w ramach swojej pracy i pyta tylko o operacje wymagające zatwierdzenia oraz zgodnie z regułami pytania ustalonymi przez właściciela.
askKażde wywołanie, które coś zmienia, wymaga pytania, chyba że obejmuje je reguła zezwolenia.
planTylko odczyt i planowanie. Wywołanie, które coś zmienia, nie zostaje wykonane.
full_accessNic nie pyta. Reguły zakazu i twarde limity nadal obowiązują.

Nebo sprawdza każde działanie w tej samej kolejności: najpierw twarde limity, potem limity i przepisy, potem reguły właściciela, a na końcu tryb. Twarde limity, takie jak ochrona danych logowania przed wyciekiem, nigdy nie są znoszone, nawet w full_access.