NeboAI
NeboAI
Aloita

agent.json-viite

agent.json sisältää kaiken työntekijästä, mikä ei ole proosaa: kyvyt, joita se vaatii, kysymykset, joita se esittää omistajalle, miten sen muistia säilytetään, mitkä toiminnot vaativat aina hyväksynnän ja työnkulut, joita se suorittaa. Jokainen kenttä on valinnainen.

Esimerkki

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

Kentät

KenttäTyyppiMerkitys
requires.interfacesmerkkijonoluetteloKyvyt, joita rooli tarvitsee, kuten mail tai ledger. Myönnetään palkattaessa; jokainen hyväksyntää vaativa toiminto pysyy hyväksyntäkohteena. Katso Kyvyt ja hyväksynnät.
requires.pluginsmerkkijonoluetteloTyöntekijän mukana asennettavat laajennukset. Käytä vain, kun rooli todella riippuu yhdestä laajennuksesta; suosi kykyä.
requires.toolsmerkkijonoluetteloTyökalut, jotka ladataan työntekijän istuntoon sen ensimmäisestä vuorosta alkaen. Tämä ei koskaan ohita hyväksyntää.
skillsmerkkijonoluetteloAsennettavat ja käytettävät kaupan taidot: @org/skills/name, valinnaisesti @version, tai SKIL--koodi. Paketin oman skills/-kansion taidot eivät tarvitse merkintää.
inputslistKysymykset, joihin omistaja vastaa palkattaessa. Katso Syötteet.
memoryobjectMiten keskustelut ja muisti säilytetään. Katso Persoona ja muisti.
subscribesmerkkijonoluetteloYrityksen tietoalueet, jotka työntekijä lukee uudelleen niiden muuttuessa, kuten finance.ar.*.
ceilingmapToiminto arvoon "approval". Kyseinen toiminto kysyy aina omistajalta tämän työntekijän osalta. Muita arvoja ei hyväksytä.
workflowsmapTyönkulun nimi työnkulkuun. Katso Työnkulut.
toolslistSovelluksen sivuvaunun tarjoamat HTTP-työkalut. Katso Sivuvaunun työkalut.
scopesmapNimettyjä ryhmiä kentistä tools, skills ja plugins. Rajauksen plugins kuvataan työntekijälle, kun rajaus on aktiivinen.

Syötteet

Syöte on kysymys, johon omistaja vastaa palkatessaan. Vastaukset näkyvät työntekijälle kohdassa ”Configured Inputs” ja täyttävät {{key}}-paikkamerkit seuranta- ja kansiokäynnistimissä.

{
  "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"
}
KenttäOletusMerkitys
keypakollinenPaikkamerkeissä käytettävä nimi. name hyväksytään varavaihtoehtona.
labelkentästä keyOmistajalle näytettävä kysymys.
typetexttext, textarea, number, select, checkbox tai radio.
requiredfalseMerkitsee kysymyksen sellaiseksi, johon omistajan on vastattava.
defaultei mitäänEsitäytetty vastaus. Ei sallittu rahakysymyksessä.
placeholder, descriptionei mitäänOhjeteksti.
optionsei mitäänKentille select ja radio: {value, label}-olioita tai pelkkiä merkkijonoja.
idei mitäänPysyvä, pisteillä eroteltu nimi tiedolle, kuten finance.ap.invoice_mailbox, jotta muut työntekijät voivat jakaa sen.
scopecompanycompany: jaettu yrityksen tieto. seat: vain tämä palkkaus.
missingei mitäänMitä työntekijä tekee, kun kysymykseen ei ole vastattu.
moneyfalseMerkitsee rahamäärän. Rahakysymyksellä ei voi olla oletusarvoa.

Sivuvaunun työkalut

Sovellus, jolla on sivuvaunu, tarjoaa HTTP-päätepisteitä työntekijälleen työkaluina. Nebo rekisteröi jokaisen merkinnän muodossa app__<app>__<name> ja lähettää kutsut sivuvaunuun osoitteeseen method ja path. Katso Sovelluksen sivuvaunu.

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

Työnkulut

Jokainen workflows-kentän avain nimeää yhden työnkulun; nimi on sen tunniste. Koko muoto on kuvattu sivuilla Työnkulut, Käynnistimet ja Toiminnot.