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Қолданбаның sidecar-ы ұсынатын HTTP құралдары. «Sidecar құралдары» бөлімін қараңыз.
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Ақша сомасын белгілейді. Ақша сұрағының әдепкі мәні болмайды.

Sidecar құралдары

Sidecar-ы бар қолданба HTTP соңғы нүктелерін өз қызметкеріне құралдар ретінде ұсынады. Nebo әр жазбаны app__<app>__<name> ретінде тіркейді және шақыруларды sidecar-ға method мен path бойынша жібереді. App Sidecar бөлімін қараңыз.

"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 астындағы әр кілт бір жұмыс үдерісін атайды; атауы — оның идентификаторы. Толық пішім Жұмыс үдерістері, Іске қосу шарттары және Әрекеттер беттерінде.