모델
- 기능은 제품이 아니라 타입이 지정된 인터페이스입니다.
mail에는mail.inbox.read,mail.inbox.search,mail.message.send작업이 있습니다. - 직원 패키지는 역할에 필요한 기능을
requires.interfaces에 나열합니다. - 플러그인은
interfaceBindings에서 작업을 자신의 명령에 바인딩해 기능을 제공합니다. - 연결은 소유자가 해당 기능에 연결한 플러그인입니다. 기능을 지정한 감시 트리거는 이 연결에서 실행됩니다.
역할에 필요한 것 선언하기
{
"requires": { "interfaces": ["mail", "ledger"] },
"ceiling": { "ledger.bill.create": "approval" }
} 플러그인이 아니라 기능을 지정하세요. ledger를 요구하는 직원 패키지는 어떤 회계 시스템을 쓰는 회사에서든 작동합니다. 역할이 정말로 특정 플러그인 하나에 의존할 때만 requires.plugins를 사용하세요.
기능 제공하기
"interfaceBindings": {
"mail.inbox.read": "messages list --folder inbox",
"mail.inbox.search": "messages search --query {query}",
"mail.message.send": "messages send"
} mail.* 작업 중 하나라도 바인딩한 플러그인은 mail을 제공합니다. 각 바인딩은 mail_message_send처럼 직원이 쓸 수 있는 타입 지정 도구도 됩니다. 템플릿 문법은 plugin.json 참조에 있습니다.
워크플로가 기능을 감시하면, Nebo는 그 기능을 제공하는 설치된 플러그인 중에서 이 직원의 계정이 있는 것을 우선하고, 그다음 알파벳 순으로 고릅니다. 하나도 없으면 워크플로는 유지되고 저하됨으로 표시되며, 소유자에게 무엇을 연결해야 하는지 알립니다.
카탈로그
Nebo는 기능과 그 작업의 카탈로그를 제공합니다. ledger, mail, sms, telephony, calendar, drive, helpdesk, kb, deals, esign, timebilling, projects, cms, social, ads, reviews, email-marketing, repo, ci, deploy, monitoring, incidents 등이 있습니다. 카탈로그는 울타리가 아니라 공통 어휘입니다. 서로 다른 게시자의 직원과 플러그인이 만날 수 있도록 맞는 용어가 있으면 어디서든 그 용어를 쓰세요. 새 용어는 오류가 아니라 관례의 문제입니다.
각 작업에는 세 가지 표시 중 하나가 붙습니다.
| 표시 | 의미 |
|---|---|
| 승인 불필요 | 읽기, 또는 일시 중지·취소·롤백처럼 되돌릴 수 있고 기다리면 의미가 사라지는 보호 조치. 묻지 않고 실행됩니다. |
| 승인 필요 | 돈을 옮기거나, 회사 외부 사람에게 연락하거나, 되돌릴 수 없는 작업. 바인딩된 도구가 실행되기 전에 Nebo가 묻습니다. |
| 중요 | 자금 이동, 계약 체결, 회사 자체 기록, 또는 무인으로 행동할 상시 권한. 항상 승인이 필요하며, 소유자가 직원별·작업별로 하나씩 허용하고, 직원 전체 설정으로는 완화되지 않습니다. |
채용 시 동의
소유자가 직원을 채용하면 Nebo는 패키지에서 요구 사항을 읽습니다. requires.interfaces의 기능, requires.plugins의 플러그인, 그리고 감시 트리거가 지정한 각 기능이나 플러그인입니다. 소유자는 이 요구 사항을 설명하는 문장 하나를 봅니다. 채용하면 이 요구 사항이 해당 직원에게 상시 권한으로 부여됩니다. 승인 필요 작업은 계속 승인 항목으로 남습니다.
플러그인, MCP 서버, 앱, 스킬을 설치하는 것 자체가 사용 허가입니다. 하나씩 켜는 방식이 아닙니다. Nebo의 내장 능력은 chat, file, shell, web, contacts, desktop, media, system으로 묶여 있습니다.
상한과 법규
| 선언 위치 | 효과 |
|---|---|
agent.json의 ceiling | 나열된 작업은 이 직원에 대해 항상 소유자에게 묻습니다. 유일한 값은 "approval"입니다. |
회사 계층에 있는 법규의 ceiling | 나열된 작업은 모든 직원에게 차단됩니다. |
reserved_to: owner가 있는 회사 법규 | 나열된 작업에는 소유자 본인의 승인이 필요하며, 그 승인은 절대 직원에게 넘길 수 없습니다. |
권한 모드
각 직원에게는 권한 모드가 있습니다. 어떤 규칙으로도 정해지지 않는 호출을 이 모드가 결정하며, 소유자는 실행 한 번에 한해 모드를 바꿀 수 있습니다.
| 모드 | 동작 |
|---|---|
automatic | 기본값. 직원은 자기 업무 범위 안에서 행동하며, 승인 필요 작업과 소유자의 확인 규칙에 대해서만 묻습니다. |
ask | 허용 규칙에 해당하지 않는 한, 무언가를 바꾸는 모든 호출에서 묻습니다. |
plan | 읽기와 계획만 합니다. 무언가를 바꾸는 호출은 실행되지 않습니다. |
full_access | 아무것도 묻지 않습니다. 거부 규칙과 절대 한도는 그대로 적용됩니다. |
Nebo는 모든 행동을 같은 순서로 확인합니다. 먼저 절대 한도, 다음으로 상한과 법규, 그다음 소유자의 규칙, 마지막으로 모드입니다. 자격 증명 유출 방지 같은 절대 한도는 full_access에서도 절대 해제되지 않습니다.