Model
- Funkcja to typowany interfejs, nigdy produkt.
mailma operacjemail.inbox.read,mail.inbox.searchimail.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ń.
| Oznaczenie | Znaczenie |
|---|---|
| Bez zatwierdzenia | Odczyt 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 zatwierdzenia | Przenosi pieniądze, kontaktuje się z kimś spoza firmy lub nie da się jej cofnąć. Nebo pyta, zanim powiązane narzędzie zostanie uruchomione. |
| Krytyczna | Przepł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 deklarowane | Skutek |
|---|---|
ceiling w agent.json | Wymienione operacje zawsze wymagają pytania właściciela w przypadku tego pracownika. Jedyna wartość to "approval". |
ceiling przepisu w warstwie firmowej | Wymienione operacje są zablokowane dla każdego pracownika. |
Przepis firmowy z reserved_to: owner | Wymienione 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.
| Tryb | Zachowanie |
|---|---|
automatic | Domyś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. |
ask | Każde wywołanie, które coś zmienia, wymaga pytania, chyba że obejmuje je reguła zezwolenia. |
plan | Tylko odczyt i planowanie. Wywołanie, które coś zmienia, nie zostaje wykonane. |
full_access | Nic 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.