예시
{
"requires": {
"interfaces": ["ledger", "mail"],
"plugins": [],
"tools": []
},
"skills": ["@example/skills/receipt-capture"],
"inputs": [
{
"key": "invoice_mailbox",
"label": "Mailbox that receives vendor invoices",
"type": "text",
"id": "finance.ap.invoice_mailbox",
"scope": "company",
"required": true,
"missing": "Ask the owner which mailbox to watch before processing invoices."
}
],
"memory": {
"mode": "separate",
"topics": [
{ "slug": "vendor", "description": "A supplier: terms, usual amounts, contacts, open disputes" }
]
},
"subscribes": ["finance.ap.*"],
"ceiling": { "ledger.bill.create": "approval" },
"workflows": {
"invoice-intake": {
"trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
"activities": [
{ "id": "record", "intent": "If the message in _watch_payload is a vendor invoice, record it as a bill." }
]
}
}
} 필드
| 필드 | 유형 | 의미 |
|---|---|---|
requires.interfaces | 문자열 목록 | 역할에 필요한 기능. 예: mail, ledger. 채용 시 부여되며, 승인이 필요한 각 작업은 계속 승인 항목으로 남습니다. 기능과 승인을 참조하세요. |
requires.plugins | 문자열 목록 | 직원과 함께 설치되는 플러그인. 역할이 정말로 특정 플러그인 하나에 의존할 때만 사용하고, 가능하면 기능을 지정하세요. |
requires.tools | 문자열 목록 | 첫 턴부터 직원의 세션에 로드되는 도구. 승인을 우회하지는 않습니다. |
skills | 문자열 목록 | 설치해 사용할 마켓플레이스 스킬: @org/skills/name, 선택적으로 @version, 또는 SKIL- 코드. 패키지 자체 skills/ 폴더의 스킬은 항목이 필요 없습니다. |
inputs | list | 채용 시 소유자가 답하는 질문. 입력을 참조하세요. |
memory | object | 대화와 메모리를 보관하는 방식. 페르소나와 메모리를 참조하세요. |
subscribes | 문자열 목록 | 변경될 때 직원이 다시 읽는 회사 정보 영역. 예: finance.ar.*. |
ceiling | map | 작업과 "approval"의 매핑. 해당 작업은 이 직원에 대해 항상 소유자에게 묻습니다. 다른 값은 허용되지 않습니다. |
workflows | map | 워크플로 이름과 워크플로의 매핑. 워크플로를 참조하세요. |
tools | list | 앱의 사이드카가 제공하는 HTTP 도구. 사이드카 도구를 참조하세요. |
scopes | map | tools, skills, plugins의 이름 있는 그룹. 범위가 활성화되면 그 범위의 plugins가 직원에게 설명됩니다. |
입력
입력 항목은 소유자가 직원을 채용할 때 답하는 질문입니다. 답변은 직원에게 "Configured Inputs" 아래에 표시되며, 감시 및 폴더 트리거의 {{key}} 자리표시자를 채웁니다.
{
"key": "close_day",
"label": "Business day to finish the close",
"type": "select",
"options": [
{ "value": "3", "label": "Third business day" },
{ "value": "5", "label": "Fifth business day" }
],
"default": "5",
"scope": "company",
"id": "finance.close.day"
} | 필드 | 기본값 | 의미 |
|---|---|---|
key | 필수 | 자리 표시자에 사용되는 이름. 대체 값으로 name도 허용됩니다. |
label | key에서 가져옴 | 소유자에게 표시되는 질문. |
type | text | text, textarea, number, select, checkbox 또는 radio. |
required | false | 소유자가 반드시 답해야 하는 질문으로 표시합니다. |
default | 없음 | 미리 채워진 답. 금액 질문에는 허용되지 않습니다. |
placeholder, description | 없음 | 도움말 텍스트. |
options | 없음 | select와 radio용: {value, label} 객체 또는 일반 문자열. |
id | 없음 | 다른 직원과 공유할 수 있도록 정보에 붙이는 안정적인 점 표기 이름. 예: finance.ap.invoice_mailbox. |
scope | company | company: 회사 공통 정보. seat: 이번 채용에만 해당. |
missing | 없음 | 질문에 답이 없는 동안 직원이 하는 일. |
money | false | 금액임을 표시합니다. 금액 질문에는 기본값을 둘 수 없습니다. |
사이드카 도구
사이드카가 있는 앱은 HTTP 엔드포인트를 직원에게 도구로 노출합니다. Nebo는 각 항목을 app__<app>__<name>으로 등록하고, 호출을 사이드카의 method와 path로 보냅니다. 앱 사이드카를 참조하세요.
"tools": [
{
"name": "list_entries",
"description": "List journal entries for a date range.",
"method": "GET",
"path": "/entries",
"input_schema": { "type": "object", "properties": { "from": { "type": "string" } } }
}
] 워크플로
workflows 아래의 각 키는 워크플로 하나를 지정하며, 그 이름이 식별자가 됩니다. 전체 형식은 워크플로, 트리거, 활동에 있습니다.