패키지
support-coordinator/
├── AGENT.md # required: who the employee is and how it works
├── agent.json # optional: capabilities, inputs, workflows, memory
└── skills/ # optional: skills only this employee uses
└── reply-drafting/
└── SKILL.md | 파일 | 필수 | 목적 |
|---|---|---|
AGENT.md | 예 | 페르소나: 직원이 누구인지, 어떻게 일하는지, 그리고 규칙. 페르소나와 메모리를 참조하세요. |
agent.json | 아니요 | 필요한 기능, 소유자에게 묻는 질문, 워크플로, 메모리 설정, 승인 상한. agent.json 참조를 확인하세요. |
skills/ | 아니요 | 표준 SKILL.md 형식의 스킬. 이 직원만 볼 수 있습니다. |
manifest.json | 앱만 해당 | "type": "app"이 포함된 식별 정보. 마켓플레이스는 직원을 패키징할 때 자체 매니페스트를 작성합니다. |
ui/ | 앱만 해당 | 앱의 페이지. 앱을 참조하세요. |
패키지 작성하기
페르소나부터 시작하세요. 프런트매터에는 직원의 이름과 한 줄 설명을 적고, 본문에는 평이한 문장으로 지침을 씁니다.
--- name: Support Coordinator description: Answers every customer message the day it arrives and escalates what it cannot settle. --- # Support Coordinator You answer customer email for the company. Reply within the configured window, in the company's voice, and keep every thread moving until the customer has an answer. ## How you work - Read the whole thread before you reply. - Use the reply-drafting skill for every customer reply. - When a message is about money, draft a proposal for the owner instead of promising anything. ## Rules - Never promise a refund, a discount or a date you cannot confirm.
역할에 시스템, 소유자의 설정, 또는 요청 없이 하는 작업이 필요하면 agent.json을 추가하세요. 이 예시는 mail 기능을 요구하고, 채용 시 질문 하나를 하며, 새 메시지가 도착할 때마다 답장합니다.
{
"requires": { "interfaces": ["mail"] },
"inputs": [
{
"key": "reply_window_hours",
"label": "Reply within (hours)",
"type": "number",
"id": "support.reply_window_hours",
"scope": "company",
"default": 24
}
],
"workflows": {
"new-mail": {
"trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
"description": "Handle each customer message as it arrives.",
"activities": [
{
"id": "reply",
"intent": "Read the message in _watch_payload, draft a reply within reply_window_hours, and escalate anything about money to the owner."
}
]
}
}
} 감시 트리거는 제품이 아니라 mail 기능을 지정합니다. 실행 시점에는 소유자가 메일용으로 연결한 플러그인으로 해석됩니다. 트리거와 활동은 워크플로를 참조하세요.
봇에 로드하기
폴더를 <data>/user/agents/<name>/에 넣으세요. Nebo는 AGENT.md, agent.json, manifest.json을 감시하다가 변경 후 약 1초 뒤에 직원을 다시 로드합니다. 폴더를 제거하면 직원이 비활성화되지만 기록은 유지됩니다.
Nebo는 세 곳에서 직원을 로드하며, 나중 출처가 우선합니다. Nebo에 내장된 직원, <data>/nebo/agents/의 봉인된 마켓플레이스 패키지, 그리고 <data>/user/agents/의 폴더입니다. 직원이 create_employee와 update_employee 도구로 패키지를 대신 만들거나 바꿀 수도 있으며, 이 도구들은 같은 폴더에 기록합니다.
채용 시 일어나는 일
소유자가 마켓플레이스에서 또는 AGNT- 코드로 직원을 채용하면 Nebo는 다음을 수행합니다.
- 모델에 묻지 않고 패키지의 요구 사항을 읽습니다.
requires.interfaces의 모든 기능,requires.plugins의 모든 플러그인, 그리고 감시 트리거가 지정한 모든 기능이나 플러그인입니다. - 이 요구 사항에 대한 동의 문장 하나를 소유자에게 보여 주고, 채용 시 이 직원에게 상시 권한으로 부여합니다. 승인이 필요한 작업은 그대로 승인이 필요합니다. 기능과 승인을 참조하세요.
- 종속성을 설치합니다.
requires.plugins의 플러그인,skills와 활동에 지정된 마켓플레이스 스킬, 그리고 패키지를 게시할 때 선언된 종속성입니다. - 소유자에게
inputs질문을 하고, 아직 연결이 없는 기능이 있으면 받은편지함으로 소유자에게 알립니다.
기능에 연결이 없는 워크플로는 유지되며, 이유와 함께 저하됨으로 표시됩니다. 소유자가 시스템을 연결하는 즉시 작동하기 시작합니다.
Nebo가 확인하는 항목
Nebo는 agent.json을 관대하게 읽습니다. 알 수 없는 키는 무시합니다. 스키마와 맞지 않는 워크플로는 건너뛰고, 소유자는 해당 워크플로가 실행되지 않는다는 받은편지함 알림을 받습니다. 직원의 나머지 부분은 그대로 로드됩니다. 다음 문제는 파일 전체를 거부합니다.
sources목록이 비어 있는event트리거.- 한 워크플로 안에
id가 같은 활동 두 개. scope가company나seat가 아닌 입력, 또는 기본값이 있는 금액 질문."approval"이 아닌ceiling값.- 인사말이 정확히 하나이고 이름 있는 의도가 하나 이상인 조건을 충족하지 않는 전화 응답 트리.
일부 검사는 로드할 때가 아니라 워크플로가 시작될 때 실행됩니다. 예를 들어 각 활동 유형에 필요한 매개변수 검사가 그렇습니다. 활동을 참조하세요.
도구가 아니라 책임을 쓰세요. 직원 패키지는 ledger나 mail 같은 기능을 지정하며, 특정 제품, 회사, 업종은 절대 지정하지 않습니다. 각 기능을 어떤 시스템으로 채울지는 소유자가 정하므로, 패키지 하나로 채용하는 모든 회사에 대응할 수 있습니다.
다음
- agent.json 참조
- 페르소나와 메모리
- 게시: 직원을 마켓플레이스에 올리세요.