NeboAI
NeboAI
Zacznij

Podstawowe pojęcia

Zacznij od firmy i obowiązków, które trzeba w niej obsłużyć. Za te obowiązki odpowiadają pracownicy. Funkcje opisują systemy potrzebne roli, a połączenia je zapewniają. Umiejętności uczą pracy, przepływy pracy decydują, kiedy się ona odbywa, a warstwa firmowa dostarcza zasad. Ta strona definiuje każdy termin raz; reszta dokumentacji na nich bazuje.

Bot

Bot to jedna działająca kopia Nebo — na komputerze, serwerze lub komputerze Nebo Cloud. Bot przechowuje pracowników, ich pamięć, zainstalowane umiejętności i wtyczki oraz połączenia właściciela. Wszystko, co zbudujesz, instaluje się na bocie.

Pracownik

Pracownik to rola z obowiązkami, np. księgowy albo koordynator obsługi klienta. Ma personę, własną pamięć, potrzebne umiejętności i opcjonalne przepływy pracy, które wykonuje samodzielnie. Rolę budujesz jako pakiet pracownika: personę w AGENT.md i opcjonalny plik agent.json. Właściciel zatrudnia go ze sklepu lub za pomocą kodu instalacji.

Pracownicy są uniwersalni. Pakiet opisuje obowiązki, nigdy konkretny produkt. Wskazuje potrzebne funkcje, a właściciel decyduje, który z jego systemów pełni każdą z nich.

Umiejętność

Umiejętność uczy pracowników wykonywania jednego rodzaju pracy. To folder z plikiem SKILL.md i ewentualnymi plikami pomocniczymi. Pracownicy widzą listę dostępnych umiejętności i ładują jedną z nich narzędziem use_skill, gdy wymaga tego praca. Zobacz Umiejętności.

Funkcja i połączenie

Funkcja to rodzaj systemu, z którym pracuje rola, np. mail, calendar lub ledger. Każda funkcja ma nazwane operacje, np. mail.message.send. Operacje, które przenoszą pieniądze, kontaktują się z kimś spoza firmy lub nie da się ich cofnąć, wymagają zatwierdzenia.

Połączenie to prawdziwy system właściciela, który pełni daną funkcję, dostarczany przez wtyczkę. Pakiet deklaruje requires.interfaces; przy zatrudnieniu właściciel wyraża zgodę i przypisuje połączenie. Zobacz Funkcje i zatwierdzenia.

Wtyczka

Wtyczka to plik binarny wiersza poleceń z manifestem plugin.json. Daje pracownikom usługę lub program, na którym mogą działać, przechowuje jedno konto na pracownika i może zapewniać operacje funkcji, zdarzenia dla przepływów pracy i nie tylko. Zobacz Wtyczki.

Serwer MCP

Serwer MCP to kolejny sposób na danie pracownikom narzędzi. Właściciel dodaje serwer do bota, a każde jego narzędzie staje się dostępne dla pracowników. Zobacz MCP.

Przepływ pracy

Przepływ pracy to praca, którą pracownik wykonuje bez proszenia. Znajduje się w pliku agent.json pracownika i łączy wyzwalacz — np. harmonogram, zdarzenie lub obserwowaną wtyczkę — z aktywnościami, które pracownik wykonuje. Zobacz Przepływy pracy.

Aplikacja

Aplikacja to pracownik z własnym oknem. Jej strona to HTML w folderze ui/ pakietu, a z Nebo komunikuje się przez App SDK. Zobacz Aplikacje.

Warstwa firmowa

Warstwa firmowa zawiera to, co jest prawdą dla całej firmy: jej słownictwo, podmioty, zasady, przepisy, standardy i materiały referencyjne. Znajduje się w pakietach, np. COMPANY.md z folderami określonych typów obok. Właściciel zawsze może ją edytować. Gdy się zmienia, każdy pracownik odczytuje zmianę i aktualizuje własne zasady. Zobacz Persona i pamięć.

Zespół i kanał

Pracownicy na bocie mogą działać jako zespół. Wpis do zespołu trafia do jego lidera; @Name trafia do jednego członka, a @everyone do wszystkich. Zobacz Pomocnicy i zespoły. Kanał to prywatna przestrzeń dostępna tylko na zaproszenie, wspólna dla botów i ludzi.

Kod instalacji

Każdy element utworzony w sklepie dostaje kod instalacji w formacie PREFIX-XXXX-XXXX. Wpisz sam kod jako całą wiadomość na czacie Nebo, a bot zainstaluje element wraz z zależnościami.

PrefiksInstaluje
SKIL-Umiejętność
AGNT-Pakiet pracownika z jego umiejętnościami, wtyczkami i innymi zależnościami
PLUG-Wtyczkę
APPS-Aplikację
CONN-Konektor
COLL-Kolekcję elementów
LOOP-Dołącza do kanału (zaproszenie, a nie element sklepu)
NEBO-Łączy bota z kontem NeboAI (wygasa po pięciu minutach)

Sklep

Sklep NeboAI to miejsce, w którym właściciele zatrudniają pracowników i instalują umiejętności, wtyczki oraz aplikacje. Deweloperzy publikują w nim przez serwer MCP NeboAI. Zobacz Publikowanie.