AGENT.md
AGENT.md는 일반 Markdown입니다. 직원의 이름과 한 줄 설명을 담은 프런트매터로 시작하세요. 마켓플레이스와 소유자의 인력 화면이 둘 다 사용합니다. 그런 다음 페르소나를 2인칭으로 작성하세요. 직원의 책임, 일하는 방식, 규칙을 적습니다.
--- name: Collections Specialist description: Follows up on every overdue invoice until it is paid, disputed, or handed to the owner. --- # Collections Specialist You keep receivables moving. Every overdue invoice gets a follow-up on schedule, in a tone that protects the customer relationship. ## How you work - Check the aging report before any follow-up so you never chase a paid invoice. - Escalate to the owner when a customer disputes an amount. ## Rules - Never threaten, and never mention collections agencies. - Never agree to a payment plan; propose it to the owner.
Nebo는 각 세션이 시작될 때 직원에게 페르소나를 전달합니다. 프런트매터의 이름, 설명, 트리거와 함께, 소유자가 Nebo에서 정한 설정인 성격, 규칙, 영혼도 함께 전달합니다. 페르소나는 해당 직원만 볼 수 있으며, 다른 직원과 공유하는 프롬프트에는 절대 추가되지 않습니다.
역할이 무엇을 책임지고 어떻게 판단하는지 쓰세요. 도구 이름과 제품 이름은 빼세요. 직원의 도구는 기능과 연결에서 오며, 같은 페르소나가 채용하는 모든 회사에서 작동해야 합니다.
메모리
모든 직원은 소유자 본인의 정보를 읽고, 자신의 메모리에만 씁니다. 메모리는 remember, recall, forget 도구로 다룹니다. 대화와 메모리 보관 방식은 agent.json의 memory.mode로 정하세요.
| 모드 | 동작 | 용도 |
|---|---|---|
single | 진행 중인 대화 하나와 메모리 하나. 기본값입니다. | 대부분의 역할. |
separate | 여러 대화가 직원의 비공개 메모리를 공유합니다. 전화를 건 사람이나 방문자처럼 소유자가 아닌 사람과의 대화는 별도의 봉인된 메모리를 유지합니다. | 많은 사람과 대화하는 역할. |
confidential | 모든 대화가 봉인된 사안입니다. 한 대화에서 배운 것은 소유자의 대화를 포함해 다른 대화에서 보이지 않습니다. | 서로 분리되어야 하는 고객 사안. |
"memory": {
"mode": "separate",
"topics": [
{ "slug": "account", "description": "A customer account: balance, promises to pay, contacts, disputes" }
],
"write_bar": ["web", "external-email"],
"share_with": []
} | 필드 | 의미 |
|---|---|
mode | single, separate 또는 confidential. 예전의 context_isolated: true는 separate로 읽습니다. |
topics | 직원에게 어떤 종류의 것을 기억해야 하는지 알려 주는 {slug, description} 쌍, 최대 8개. 슬러그는 소문자와 하이픈으로 쓰고, 설명은 1~120자입니다. 예약된 슬러그: tacit, entity, daily, project, memory, style, artifact. |
write_bar | 다음 출처의 콘텐츠를 받아들인 실행은 메모리에 쓸 수 없습니다: web, external-email, channel, document, phone, coworker. 생략하면 separate와 confidential 모드에서 channel과 phone이 차단됩니다. 빈 목록은 차단을 해제합니다. |
share_with | 이 직원에게서 받은 답장에 이 직원의 메모리를 받을 수 있는 직원 id 또는 *. 기본값은 비어 있으며, 아무것도 공유하지 않습니다. |
회사 계층
회사 계층은 모든 직원이 공유하는 지식입니다. 회사의 용어, 거래 상대, 규칙, 법규와 표준, 참고 자료가 담깁니다. 봇의 팩 안에 있습니다. 팩은 INDUSTRY.md, FRANCHISE.md, COMPANY.md 중 정확히 하나의 표시 파일과 그 옆의 유형별 폴더로 이루어진 폴더입니다. 계층끼리 충돌하면 회사가 프랜차이즈보다, 프랜차이즈가 업종보다 우선합니다.
<data>/packs/example-co/ ├── COMPANY.md ├── vocabulary/ ├── parties/ ├── rules/ ├── laws/ │ └── refunds.md ├── standards/ ├── workflows/ └── reference/
폴더 안의 모든 파일은 선택적 프런트매터가 있는 Markdown입니다. 프런트매터에는 규칙의 always, 표준의 id와 value, 법규의 ceiling 같은 구조 정보가 들어가고, 본문에는 설명이 들어갑니다. 팩은 절차가 아닌 지식만 담으므로, 스킬이 들어 있는 팩은 거부됩니다.
법규
법규의 ceiling에는 어떤 직원도 수행할 수 없는 작업이 나열됩니다. 회사 계층에서 reserved_to: owner를 쓰면 달라집니다. 작업은 여전히 가능하지만 소유자 본인의 승인이 있어야만 하며, 그 승인은 절대 다른 이에게 넘길 수 없습니다.
--- ceiling: [ledger.refund.create] reserved_to: owner --- Refunds are issued only by the owner. Employees may prepare a refund and send it to the owner for approval.
직원이 계층을 익히는 방식
직원은 일하는 도중에 계층을 조회하지 않습니다. 계층이 바뀌면 각 직원이 변경 사항을 한 번 읽고 자신의 규칙을 다시 씁니다. 소유자는 언제든 COMPANY.md와 모든 회사 폴더를 편집할 수 있으며, 변경 사항을 저장하는 것이 소유자가 무엇이 사실인지 밝히는 방법입니다.