NeboAI
NeboAI
시작하기

agent.json 레퍼런스

agent.json에는 직원에 관한 것 중 문장이 아닌 모든 것이 담깁니다. 필요한 기능, 소유자에게 묻는 질문, 메모리 보관 방식, 항상 승인이 필요한 작업, 실행하는 워크플로입니다. 모든 필드는 선택 사항입니다.

예시

{
  "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/ 폴더의 스킬은 항목이 필요 없습니다.
inputslist채용 시 소유자가 답하는 질문. 입력을 참조하세요.
memoryobject대화와 메모리를 보관하는 방식. 페르소나와 메모리를 참조하세요.
subscribes문자열 목록변경될 때 직원이 다시 읽는 회사 정보 영역. 예: finance.ar.*.
ceilingmap작업과 "approval"의 매핑. 해당 작업은 이 직원에 대해 항상 소유자에게 묻습니다. 다른 값은 허용되지 않습니다.
workflowsmap워크플로 이름과 워크플로의 매핑. 워크플로를 참조하세요.
toolslist앱의 사이드카가 제공하는 HTTP 도구. 사이드카 도구를 참조하세요.
scopesmaptools, 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도 허용됩니다.
labelkey에서 가져옴소유자에게 표시되는 질문.
typetexttext, textarea, number, select, checkbox 또는 radio.
requiredfalse소유자가 반드시 답해야 하는 질문으로 표시합니다.
default없음미리 채워진 답. 금액 질문에는 허용되지 않습니다.
placeholder, description없음도움말 텍스트.
options없음select와 radio용: {value, label} 객체 또는 일반 문자열.
id없음다른 직원과 공유할 수 있도록 정보에 붙이는 안정적인 점 표기 이름. 예: finance.ap.invoice_mailbox.
scopecompanycompany: 회사 공통 정보. seat: 이번 채용에만 해당.
missing없음질문에 답이 없는 동안 직원이 하는 일.
moneyfalse금액임을 표시합니다. 금액 질문에는 기본값을 둘 수 없습니다.

사이드카 도구

사이드카가 있는 앱은 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 아래의 각 키는 워크플로 하나를 지정하며, 그 이름이 식별자가 됩니다. 전체 형식은 워크플로, 트리거, 활동에 있습니다.