Halimbawa
{
"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." }
]
}
}
} Mga Field
| Field | Uri | Kahulugan |
|---|---|---|
requires.interfaces | listahan ng mga string | Mga capability na kailangan ng tungkulin, gaya ng mail o ledger. Ibinibigay sa pag-hire; nananatiling approval item ang bawat operasyong nangangailangan ng pag-apruba. Tingnan ang Mga Kakayahan at Pag-apruba. |
requires.plugins | listahan ng mga string | Mga plugin na ini-install kasama ng empleyado. Gamitin lang kapag talagang nakasalalay ang tungkulin sa iisang plugin; mas mainam ang capability. |
requires.tools | listahan ng mga string | Mga tool na nilo-load sa session ng empleyado mula sa unang turn nito. Hindi kailanman nilalampasan nito ang pag-apruba. |
skills | listahan ng mga string | Mga marketplace skill na ii-install at gagamitin: @org/skills/name, opsyonal na may @version, o isang SKIL- code. Hindi kailangan ng entry ang mga skill sa sariling skills/ folder ng package. |
inputs | list | Mga tanong na sinasagot ng may-ari sa pag-hire. Tingnan ang Inputs. |
memory | object | Kung paano iniingatan ang mga usapan at memory. Tingnan ang Persona at Memory. |
subscribes | listahan ng mga string | Mga larangan ng impormasyon ng kumpanya na binabasa ulit ng empleyado kapag nagbago ang mga ito, gaya ng finance.ar.*. |
ceiling | map | Operasyon papunta sa "approval". Laging nagtatanong sa may-ari ang operasyong iyon para sa empleyadong ito. Walang ibang value na tinatanggap. |
workflows | map | Pangalan ng workflow papunta sa workflow. Tingnan ang Workflows. |
tools | list | Mga HTTP tool na inihahain ng sidecar ng isang app. Tingnan ang Sidecar tools. |
scopes | map | Mga may-pangalang grupo ng tools, skills at plugins. Inilalarawan sa empleyado ang plugins ng isang scope kapag aktibo ang scope na iyon. |
Mga Input
Ang input ay isang tanong na sinasagot ng may-ari kapag kumukuha ng empleyado. Lumalabas sa empleyado ang mga sagot sa ilalim ng "Configured Inputs" at pinupunan nito ang mga placeholder na {{key}} sa mga watch at folder trigger.
{
"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"
} | Field | Default | Kahulugan |
|---|---|---|
key | kailangan | Pangalang ginagamit sa mga placeholder. Tinatanggap ang name bilang fallback. |
label | mula sa key | Ang tanong na ipinapakita sa may-ari. |
type | text | text, textarea, number, select, checkbox o radio. |
required | false | Minamarkahan ang tanong bilang dapat sagutin ng may-ari. |
default | wala | Paunang sagot. Hindi pinapayagan sa tanong tungkol sa pera. |
placeholder, description | wala | Help text. |
options | wala | Para sa select at radio: mga {value, label} object o simpleng string. |
id | wala | Isang matatag at may tuldok na pangalan para sa impormasyon, gaya ng finance.ap.invoice_mailbox, para maibahagi ito ng ibang empleyado. |
scope | company | company: isang shared na impormasyon ng kumpanya. seat: para sa hire na ito lang. |
missing | wala | Ang ginagawa ng empleyado habang hindi pa nasasagot ang tanong. |
money | false | Minamarkahan ang halaga ng pera. Hindi puwedeng magkaroon ng default ang tanong tungkol sa pera. |
Mga Sidecar tool
Inilalantad ng isang app na may sidecar ang mga HTTP endpoint sa empleyado nito bilang mga tool. Nire-register ng Nebo ang bawat entry bilang app__<app>__<name> at ipinapadala ang mga tawag sa sidecar sa method at path. Tingnan ang 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" } } }
}
] Mga Workflow
Bawat key sa ilalim ng workflows ay pangalan ng isang workflow; ang pangalan ang identifier nito. Nasa Workflows, Triggers at Activities ang buong format.