NeboAI
NeboAI
시작하기

기능과 승인

기능은 메일이나 원장 같은 시스템의 종류와 그 시스템에서 하는 작업을 지정합니다. 직원 패키지는 필요한 기능을 선언하고, 플러그인은 제공하는 기능을 선언하며, 소유자가 채용할 때 둘을 연결합니다. 승인은 작업에 붙어 있으므로, 어떤 시스템이 기능을 채우든 같은 규칙이 적용됩니다.

모델

  • 기능은 제품이 아니라 타입이 지정된 인터페이스입니다. 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에서도 절대 해제되지 않습니다.