NeboAI
NeboAI
Mulai

Referensi agent.json

agent.json menyimpan semua hal tentang karyawan yang bukan prosa: kapabilitas yang dibutuhkannya, pertanyaan yang diajukannya kepada pemilik, cara memorinya disimpan, operasi mana yang selalu memerlukan persetujuan, dan workflow yang dijalankannya. Setiap field bersifat opsional.

Contoh

{
  "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." }
      ]
    }
  }
}

Field

FieldTipeArti
requires.interfacesdaftar stringKapabilitas yang dibutuhkan peran, seperti mail atau ledger. Diberikan saat perekrutan; setiap operasi yang memerlukan persetujuan tetap menjadi item persetujuan. Lihat Kapabilitas dan Persetujuan.
requires.pluginsdaftar stringPlugin yang dipasang bersama karyawan. Gunakan hanya jika peran tersebut benar-benar bergantung pada satu plugin; lebih baik gunakan kapabilitas.
requires.toolsdaftar stringAlat yang dimuat ke sesi karyawan sejak giliran pertamanya. Ini tidak pernah melewati persetujuan.
skillsdaftar stringSkill marketplace yang dipasang dan digunakan: @org/skills/name, opsional dengan @version, atau kode SKIL-. Skill di folder skills/ milik paket itu sendiri tidak perlu dicantumkan.
inputslistPertanyaan yang dijawab pemilik saat perekrutan. Lihat Input.
memoryobjectCara percakapan dan memori disimpan. Lihat Persona dan Memori.
subscribesdaftar stringArea fakta perusahaan yang dibaca ulang karyawan saat berubah, seperti finance.ar.*.
ceilingmapOperasi ke "approval". Operasi itu selalu meminta persetujuan pemilik untuk karyawan ini. Tidak ada nilai lain yang diterima.
workflowsmapNama workflow ke workflow. Lihat Workflow.
toolslistAlat HTTP yang disajikan oleh sidecar aplikasi. Lihat Alat sidecar.
scopesmapKelompok bernama berisi tools, skills, dan plugins. plugins dalam sebuah scope dijelaskan kepada karyawan saat scope itu aktif.

Input

Input adalah pertanyaan yang dijawab pemilik saat merekrut. Jawabannya muncul bagi karyawan di bawah "Configured Inputs" dan mengisi placeholder {{key}} di pemicu watch dan folder.

{
  "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"
}
FieldDefaultArti
keywajibNama yang digunakan di placeholder. name diterima sebagai cadangan.
labeldari keyPertanyaan yang ditampilkan kepada pemilik.
typetexttext, textarea, number, select, checkbox, atau radio.
requiredfalseMenandai pertanyaan sebagai pertanyaan yang wajib dijawab pemilik.
defaulttidak adaJawaban yang sudah diisi sebelumnya. Tidak diizinkan pada pertanyaan uang.
placeholder, descriptiontidak adaTeks bantuan.
optionstidak adaUntuk select dan radio: objek {value, label} atau string biasa.
idtidak adaNama bertitik yang stabil untuk fakta tersebut, seperti finance.ap.invoice_mailbox, agar karyawan lain dapat membagikannya.
scopecompanycompany: fakta perusahaan bersama. seat: hanya untuk rekrutan ini.
missingtidak adaApa yang dilakukan karyawan selama pertanyaan belum dijawab.
moneyfalseMenandai jumlah uang. Pertanyaan uang tidak boleh memiliki nilai default.

Alat sidecar

Aplikasi dengan sidecar mengekspos endpoint HTTP kepada karyawannya sebagai alat. Nebo mendaftarkan setiap entri sebagai app__<app>__<name> dan mengirim panggilan ke sidecar pada method dan path. Lihat Sidecar Aplikasi.

"tools": [
  {
    "name": "list_entries",
    "description": "List journal entries for a date range.",
    "method": "GET",
    "path": "/entries",
    "input_schema": { "type": "object", "properties": { "from": { "type": "string" } } }
  }
]

Workflow

Setiap key di bawah workflows menamai satu workflow; nama itu adalah pengenalnya. Format lengkapnya ada di Workflow, Pemicu, dan Aktivitas.