NeboAI
NeboAI
Mulakan

Rujukan agent.json

agent.json menyimpan segala tentang pekerja yang bukan prosa: keupayaan yang diperlukannya, soalan yang ditanyanya kepada pemilik, cara memorinya disimpan, operasi mana yang sentiasa memerlukan kelulusan, dan aliran kerja yang dijalankannya. Setiap medan adalah pilihan.

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

Medan

MedanJenisMaksud
requires.interfacessenarai rentetanKeupayaan yang diperlukan oleh peranan, seperti mail atau ledger. Diberikan semasa pengambilan; setiap operasi yang memerlukan kelulusan kekal sebagai item kelulusan. Lihat Keupayaan dan Kelulusan.
requires.pluginssenarai rentetanPlugin yang dipasang bersama pekerja. Gunakan hanya apabila peranan itu benar-benar bergantung pada satu plugin; utamakan keupayaan.
requires.toolssenarai rentetanAlat yang dimuatkan ke dalam sesi pekerja dari giliran pertamanya. Ini tidak sekali-kali memintas kelulusan.
skillssenarai rentetanKemahiran pasaran untuk dipasang dan digunakan: @org/skills/name, secara pilihan @version, atau kod SKIL-. Kemahiran dalam folder skills/ pakej itu sendiri tidak memerlukan entri.
inputslistSoalan yang dijawab oleh pemilik semasa pengambilan. Lihat Input.
memoryobjectCara perbualan dan memori disimpan. Lihat Persona dan Memori.
subscribessenarai rentetanBidang fakta syarikat yang dibaca semula oleh pekerja apabila ia berubah, seperti finance.ar.*.
ceilingmapOperasi kepada "approval". Operasi itu sentiasa meminta kebenaran pemilik untuk pekerja ini. Tiada nilai lain diterima.
workflowsmapNama aliran kerja kepada aliran kerja. Lihat Aliran Kerja.
toolslistAlat HTTP yang disajikan oleh sidecar aplikasi. Lihat Alat sidecar.
scopesmapKumpulan bernama tools, skills dan plugins. plugins sesuatu skop diterangkan kepada pekerja apabila skop itu aktif.

Input

Input ialah soalan yang dijawab oleh pemilik semasa mengambil pekerja. Jawapan dipaparkan kepada pekerja di bawah "Configured Inputs" dan mengisi pemegang tempat {{key}} dalam pencetus pantauan 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"
}
MedanLalaiMaksud
keywajibNama yang digunakan dalam pemegang tempat. name diterima sebagai sandaran.
labeldaripada keySoalan yang dipaparkan kepada pemilik.
typetexttext, textarea, number, select, checkbox atau radio.
requiredfalseMenandakan soalan sebagai soalan yang mesti dijawab oleh pemilik.
defaulttiadaJawapan yang telah diisi. Tidak dibenarkan pada soalan wang.
placeholder, descriptiontiadaTeks bantuan.
optionstiadaUntuk select dan radio: objek {value, label} atau rentetan biasa.
idtiadaNama bertitik yang stabil untuk fakta itu, seperti finance.ap.invoice_mailbox, supaya pekerja lain boleh berkongsinya.
scopecompanycompany: fakta syarikat yang dikongsi. seat: pengambilan ini sahaja.
missingtiadaApa yang dilakukan pekerja semasa soalan belum dijawab.
moneyfalseMenandakan jumlah wang. Soalan wang tidak boleh mempunyai nilai lalai.

Alat sidecar

Aplikasi dengan sidecar mendedahkan titik akhir HTTP kepada pekerjanya sebagai alat. Nebo mendaftarkan setiap entri sebagai app__<app>__<name> dan menghantar panggilan kepada sidecar di 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" } } }
  }
]

Aliran Kerja

Setiap kunci di bawah workflows menamakan satu aliran kerja; nama itu ialah pengecamnya. Format penuh terdapat di Aliran Kerja, Pencetus dan Aktiviti.