Mfano
{
"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." }
]
}
}
} Sehemu
| Sehemu | Aina | Maana |
|---|---|---|
requires.interfaces | orodha ya strings | Uwezo ambao nafasi inahitaji, kama vile mail au ledger. Hutolewa wakati wa kuajiri; kila shughuli inayohitaji idhini hubaki kuwa kipengee cha idhini. Tazama Uwezo na Idhini. |
requires.plugins | orodha ya strings | Programu-jalizi zinazosakinishwa pamoja na mfanyakazi. Tumia tu nafasi inapotegemea kweli programu-jalizi moja; pendelea uwezo. |
requires.tools | orodha ya strings | Zana zinazopakiwa kwenye kipindi cha mfanyakazi tangu zamu yake ya kwanza. Hii kamwe haipiti idhini. |
skills | orodha ya strings | Ujuzi wa soko wa kusakinisha na kutumia: @org/skills/name, kwa hiari @version, au msimbo wa SKIL-. Ujuzi ulio katika folda ya skills/ ya kifurushi chenyewe hauhitaji kuingizwa. |
inputs | list | Maswali ambayo mmiliki hujibu wakati wa kuajiri. Tazama Maingizo. |
memory | object | Jinsi mazungumzo na kumbukumbu vinavyohifadhiwa. Tazama Haiba na Kumbukumbu. |
subscribes | orodha ya strings | Maeneo ya taarifa za kampuni ambayo mfanyakazi huyasoma tena yanapobadilika, kama vile finance.ar.*. |
ceiling | map | Shughuli kwa "approval". Shughuli hiyo daima humuuliza mmiliki kwa mfanyakazi huyu. Hakuna thamani nyingine inayokubaliwa. |
workflows | map | Jina la mtiririko wa kazi kwa mtiririko wa kazi. Tazama Mitiririko ya kazi. |
tools | list | Zana za HTTP zinazotolewa na sidecar ya programu. Tazama Zana za sidecar. |
scopes | map | Makundi yenye majina ya tools, skills na plugins. plugins za scope huelezwa kwa mfanyakazi scope hiyo inapokuwa hai. |
Maingizo
Ingizo ni swali ambalo mmiliki hujibu wakati wa kuajiri. Majibu yanaonekana kwa mfanyakazi chini ya "Configured Inputs" na kujaza nafasi za {{key}} katika vichochezi vya ufuatiliaji na vya folda.
{
"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"
} | Sehemu | Chaguo-msingi | Maana |
|---|---|---|
key | inahitajika | Jina linalotumika katika placeholders. name inakubaliwa kama mbadala. |
label | kutoka key | Swali linaloonyeshwa kwa mmiliki. |
type | text | text, textarea, number, select, checkbox au radio. |
required | false | Huweka alama kwamba swali ni lazima lijibiwe na mmiliki. |
default | hakuna | Jibu lililojazwa mapema. Haliruhusiwi kwa swali la pesa. |
placeholder, description | hakuna | Maandishi ya msaada. |
options | hakuna | Kwa select na radio: vitu vya {value, label} au strings za kawaida. |
id | hakuna | Jina thabiti lenye nukta kwa taarifa hiyo, kama vile finance.ap.invoice_mailbox, ili wafanyakazi wengine waweze kuishiriki. |
scope | company | company: taarifa ya kampuni inayoshirikiwa. seat: kwa mwajiriwa huyu pekee. |
missing | hakuna | Kile mfanyakazi anachofanya wakati swali bado halijajibiwa. |
money | false | Huweka alama kwenye kiasi cha pesa. Swali la pesa haliwezi kuwa na chaguo-msingi. |
Zana za sidecar
Programu yenye sidecar hufichua endpoints za HTTP kwa mfanyakazi wake kama zana. Nebo husajili kila kipengee kama app__<app>__<name> na hutuma maombi kwa sidecar kwenye method na path. Tazama Sidecar ya Programu.
"tools": [
{
"name": "list_entries",
"description": "List journal entries for a date range.",
"method": "GET",
"path": "/entries",
"input_schema": { "type": "object", "properties": { "from": { "type": "string" } } }
}
] Mitiririko ya kazi
Kila ufunguo chini ya workflows hutaja mtiririko mmoja wa kazi; jina ndilo kitambulisho chake. Muundo kamili uko kwenye Mitiririko ya kazi, Vichochezi na Shughuli.