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ä | Tyyppi | Merkitys |
|---|---|---|
requires.interfaces | merkkijonoluettelo | Kyvyt, 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.plugins | merkkijonoluettelo | Työntekijän mukana asennettavat laajennukset. Käytä vain, kun rooli todella riippuu yhdestä laajennuksesta; suosi kykyä. |
requires.tools | merkkijonoluettelo | Työkalut, jotka ladataan työntekijän istuntoon sen ensimmäisestä vuorosta alkaen. Tämä ei koskaan ohita hyväksyntää. |
skills | merkkijonoluettelo | Asennettavat ja käytettävät kaupan taidot: @org/skills/name, valinnaisesti @version, tai SKIL--koodi. Paketin oman skills/-kansion taidot eivät tarvitse merkintää. |
inputs | list | Kysymykset, joihin omistaja vastaa palkattaessa. Katso Syötteet. |
memory | object | Miten keskustelut ja muisti säilytetään. Katso Persoona ja muisti. |
subscribes | merkkijonoluettelo | Yrityksen tietoalueet, jotka työntekijä lukee uudelleen niiden muuttuessa, kuten finance.ar.*. |
ceiling | map | Toiminto arvoon "approval". Kyseinen toiminto kysyy aina omistajalta tämän työntekijän osalta. Muita arvoja ei hyväksytä. |
workflows | map | Työnkulun nimi työnkulkuun. Katso Työnkulut. |
tools | list | Sovelluksen sivuvaunun tarjoamat HTTP-työkalut. Katso Sivuvaunun työkalut. |
scopes | map | Nimettyjä 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ä | Oletus | Merkitys |
|---|---|---|
key | pakollinen | Paikkamerkeissä käytettävä nimi. name hyväksytään varavaihtoehtona. |
label | kentästä key | Omistajalle näytettävä kysymys. |
type | text | text, textarea, number, select, checkbox tai radio. |
required | false | Merkitsee kysymyksen sellaiseksi, johon omistajan on vastattava. |
default | ei mitään | Esitäytetty vastaus. Ei sallittu rahakysymyksessä. |
placeholder, description | ei mitään | Ohjeteksti. |
options | ei mitään | Kentille select ja radio: {value, label}-olioita tai pelkkiä merkkijonoja. |
id | ei mitään | Pysyvä, pisteillä eroteltu nimi tiedolle, kuten finance.ap.invoice_mailbox, jotta muut työntekijät voivat jakaa sen. |
scope | company | company: jaettu yrityksen tieto. seat: vain tämä palkkaus. |
missing | ei mitään | Mitä työntekijä tekee, kun kysymykseen ei ole vastattu. |
money | false | Merkitsee 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.