ឧទាហរណ៍
{
"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 | បញ្ជីខ្សែអក្សរ | Plugin ដែលដំឡើងជាមួយបុគ្គលិក។ ប្រើតែនៅពេលតួនាទីពិតជាពឹងផ្អែកលើ Plugin មួយប៉ុណ្ណោះ ចូលចិត្តប្រើសមត្ថភាពជាង។ |
requires.tools | បញ្ជីខ្សែអក្សរ | ឧបករណ៍ដែលផ្ទុកចូលវគ្គរបស់បុគ្គលិក តាំងពីវេនដំបូងរបស់វា។ វាមិនដែលរំលងការយល់ព្រមទេ។ |
skills | បញ្ជីខ្សែអក្សរ | ជំនាញទីផ្សារដែលត្រូវដំឡើង និងប្រើ៖ @org/skills/name ជាជម្រើស @version ឬកូដ SKIL-។ ជំនាញនៅក្នុងថត skills/ ផ្ទាល់របស់កញ្ចប់ មិនត្រូវការធាតុទេ។ |
inputs | list | សំណួរដែលម្ចាស់ឆ្លើយនៅពេលជួល។ មើល ទិន្នន័យបញ្ចូល។ |
memory | object | របៀបដែលការសន្ទនា និងការចងចាំត្រូវបានរក្សា។ មើល បុគ្គលិកលក្ខណៈ និងការចងចាំ។ |
subscribes | បញ្ជីខ្សែអក្សរ | ផ្នែកនៃការពិតរបស់ក្រុមហ៊ុន ដែលបុគ្គលិកអានឡើងវិញនៅពេលពួកវាផ្លាស់ប្ដូរ ដូចជា finance.ar.*។ |
ceiling | map | ប្រតិបត្តិការទៅ "approval"។ ប្រតិបត្តិការនោះតែងតែសួរម្ចាស់សម្រាប់បុគ្គលិកនេះ។ មិនទទួលយកតម្លៃផ្សេងទៀតទេ។ |
workflows | map | ឈ្មោះលំហូរការងារទៅលំហូរការងារ។ មើល លំហូរការងារ។ |
tools | list | ឧបករណ៍ HTTP ដែលផ្ដល់ដោយ sidecar របស់កម្មវិធី។ មើល ឧបករណ៍ Sidecar។ |
scopes | map | ក្រុមដែលមានឈ្មោះនៃ tools, skills និង plugins។ plugins របស់វិសាលភាពមួយ ត្រូវបានពិពណ៌នាដល់បុគ្គលិក នៅពេលវិសាលភាពនោះសកម្ម។ |
ទិន្នន័យបញ្ចូល
ការបញ្ចូល (input) គឺជាសំណួរដែលម្ចាស់ឆ្លើយនៅពេលជួល។ ចម្លើយលេចឡើងដល់បុគ្គលិកនៅក្រោម "Configured Inputs" ហើយបំពេញកន្លែងដាក់ {{key}} នៅក្នុងកត្តាចាប់ផ្ដើម watch និង folder។
{
"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 | ត្រូវការ | ឈ្មោះដែលប្រើក្នុង placeholders។ name ត្រូវបានទទួលយកជាជម្រើសបម្រុង។ |
label | ពី key | សំណួរដែលបង្ហាញដល់ម្ចាស់។ |
type | text | text, textarea, number, select, checkbox ឬ radio។ |
required | false | សម្គាល់សំណួរថាជាសំណួរដែលម្ចាស់ត្រូវតែឆ្លើយ។ |
default | គ្មាន | ចម្លើយដែលបំពេញជាមុន។ មិនអនុញ្ញាតលើសំណួរអំពីប្រាក់ទេ។ |
placeholder, description | គ្មាន | អត្ថបទជំនួយ។ |
options | គ្មាន | សម្រាប់ select និង radio៖ វត្ថុ {value, label} ឬខ្សែអក្សរធម្មតា។ |
id | គ្មាន | ឈ្មោះថេរដែលមានសញ្ញាចុចសម្រាប់ការពិត ដូចជា finance.ap.invoice_mailbox ដើម្បីឱ្យបុគ្គលិកផ្សេងទៀតអាចចែករំលែកវាបាន។ |
scope | company | company៖ ការពិតរួមរបស់ក្រុមហ៊ុន។ seat៖ សម្រាប់តែការជួលនេះប៉ុណ្ណោះ។ |
missing | គ្មាន | អ្វីដែលបុគ្គលិកធ្វើ ខណៈពេលដែលសំណួរមិនទាន់មានចម្លើយ។ |
money | false | សម្គាល់ចំនួនប្រាក់។ សំណួរអំពីប្រាក់មិនអាចមានតម្លៃលំនាំដើមទេ។ |
ឧបករណ៍ Sidecar
កម្មវិធីដែលមាន sidecar បង្ហាញ HTTP endpoints ដល់បុគ្គលិករបស់វាជាឧបករណ៍។ 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 ដាក់ឈ្មោះលំហូរការងារមួយ ឈ្មោះគឺជាឧបករណ៍សម្គាល់របស់វា។ ទម្រង់ពេញលេញមាននៅលើ លំហូរការងារ កត្តាចាប់ផ្ដើម និង សកម្មភាព។