ਉਦਾਹਰਨ
{
"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 | ਸਤਰਾਂ ਦੀ ਸੂਚੀ | ਕਰਮਚਾਰੀ ਨਾਲ ਇੰਸਟਾਲ ਹੋਣ ਵਾਲੇ ਪਲੱਗਇਨ। ਸਿਰਫ਼ ਤਾਂ ਵਰਤੋ ਜਦੋਂ ਭੂਮਿਕਾ ਸੱਚਮੁੱਚ ਇੱਕ ਪਲੱਗਇਨ ’ਤੇ ਨਿਰਭਰ ਹੋਵੇ; ਸਮਰੱਥਾ ਨੂੰ ਤਰਜੀਹ ਦਿਓ। |
requires.tools | ਸਤਰਾਂ ਦੀ ਸੂਚੀ | ਟੂਲ ਜੋ ਕਰਮਚਾਰੀ ਦੇ ਸੈਸ਼ਨ ਵਿੱਚ ਉਸਦੀ ਪਹਿਲੀ ਵਾਰੀ ਤੋਂ ਹੀ ਲੋਡ ਹੁੰਦੇ ਹਨ। ਇਹ ਕਦੇ ਵੀ ਮਨਜ਼ੂਰੀ ਨੂੰ ਨਹੀਂ ਟਾਲਦਾ। |
skills | ਸਤਰਾਂ ਦੀ ਸੂਚੀ | ਇੰਸਟਾਲ ਕਰਨ ਅਤੇ ਵਰਤਣ ਲਈ ਮਾਰਕੀਟਪਲੇਸ ਸਕਿੱਲ: @org/skills/name, ਚਾਹੋ ਤਾਂ @version ਨਾਲ, ਜਾਂ ਇੱਕ SKIL- ਕੋਡ। ਪੈਕੇਜ ਦੇ ਆਪਣੇ skills/ ਫ਼ੋਲਡਰ ਵਿਚਲੇ ਸਕਿੱਲਾਂ ਲਈ ਕਿਸੇ ਐਂਟਰੀ ਦੀ ਲੋੜ ਨਹੀਂ। |
inputs | list | ਸਵਾਲ ਜਿਨ੍ਹਾਂ ਦੇ ਜਵਾਬ ਮਾਲਕ ਭਰਤੀ ਵੇਲੇ ਦਿੰਦਾ ਹੈ। ਇਨਪੁਟ ਵੇਖੋ। |
memory | object | ਗੱਲਬਾਤਾਂ ਅਤੇ ਮੈਮੋਰੀ ਕਿਵੇਂ ਰੱਖੀਆਂ ਜਾਂਦੀਆਂ ਹਨ। ਪਰਸੋਨਾ ਅਤੇ ਮੈਮੋਰੀ ਵੇਖੋ। |
subscribes | ਸਤਰਾਂ ਦੀ ਸੂਚੀ | ਕੰਪਨੀ ਦੇ ਤੱਥਾਂ ਦੇ ਖੇਤਰ ਜਿਨ੍ਹਾਂ ਨੂੰ ਕਰਮਚਾਰੀ ਬਦਲਣ ’ਤੇ ਦੁਬਾਰਾ ਪੜ੍ਹਦਾ ਹੈ, ਜਿਵੇਂ finance.ar.*। |
ceiling | map | ਕਾਰਵਾਈ ਅਤੇ "approval"। ਉਹ ਕਾਰਵਾਈ ਇਸ ਕਰਮਚਾਰੀ ਲਈ ਹਮੇਸ਼ਾ ਮਾਲਕ ਤੋਂ ਪੁੱਛਦੀ ਹੈ। ਕੋਈ ਹੋਰ ਮੁੱਲ ਸਵੀਕਾਰ ਨਹੀਂ ਕੀਤਾ ਜਾਂਦਾ। |
workflows | map | ਵਰਕਫਲੋ ਦਾ ਨਾਮ ਅਤੇ ਉਸਦਾ ਵਰਕਫਲੋ। ਵਰਕਫਲੋ ਵੇਖੋ। |
tools | list | ਕਿਸੇ ਐਪ ਦੇ ਸਾਈਡਕਾਰ ਵੱਲੋਂ ਦਿੱਤੇ ਜਾਂਦੇ HTTP ਟੂਲ। ਸਾਈਡਕਾਰ ਟੂਲ ਵੇਖੋ। |
scopes | map | tools, skills ਅਤੇ plugins ਦੇ ਨਾਮਿਤ ਸਮੂਹ। ਜਦੋਂ ਕੋਈ ਸਕੋਪ ਸਰਗਰਮ ਹੁੰਦਾ ਹੈ, ਤਾਂ ਉਸਦੇ plugins ਦਾ ਵਰਣਨ ਕਰਮਚਾਰੀ ਨੂੰ ਦਿੱਤਾ ਜਾਂਦਾ ਹੈ। |
ਇਨਪੁਟ
ਇਨਪੁੱਟ ਇੱਕ ਸਵਾਲ ਹੈ ਜਿਸਦਾ ਜਵਾਬ ਮਾਲਕ ਨਿਯੁਕਤੀ ਵੇਲੇ ਦਿੰਦਾ ਹੈ। ਜਵਾਬ ਕਰਮਚਾਰੀ ਨੂੰ "Configured Inputs" ਹੇਠ ਦਿਖਾਈ ਦਿੰਦੇ ਹਨ ਅਤੇ ਵਾਚ ਅਤੇ ਫੋਲਡਰ ਟ੍ਰਿਗਰਾਂ ਵਿੱਚ {{key}} ਪਲੇਸਹੋਲਡਰ ਭਰਦੇ ਹਨ।
{
"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 | ਲਾਜ਼ਮੀ | ਪਲੇਸਹੋਲਡਰਾਂ ਵਿੱਚ ਵਰਤਿਆ ਜਾਣ ਵਾਲਾ ਨਾਮ। ਬਦਲ ਵਜੋਂ 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 | ਪੈਸੇ ਦੀ ਰਕਮ ਨੂੰ ਚਿੰਨ੍ਹਿਤ ਕਰਦਾ ਹੈ। ਪੈਸੇ ਵਾਲੇ ਸਵਾਲ ਦਾ ਡਿਫ਼ਾਲਟ ਨਹੀਂ ਹੋ ਸਕਦਾ। |
ਸਾਈਡਕਾਰ ਟੂਲ
ਸਾਈਡਕਾਰ ਵਾਲੀ ਐਪ ਆਪਣੇ ਕਰਮਚਾਰੀ ਨੂੰ HTTP ਐਂਡਪੁਆਇੰਟ ਟੂਲਾਂ ਵਜੋਂ ਦਿੰਦੀ ਹੈ। Nebo ਹਰ ਐਂਟਰੀ ਨੂੰ app__<app>__<name> ਵਜੋਂ ਦਰਜ ਕਰਦਾ ਹੈ ਅਤੇ ਕਾਲਾਂ ਨੂੰ ਸਾਈਡਕਾਰ ਕੋਲ method ਅਤੇ path ’ਤੇ ਭੇਜਦਾ ਹੈ। ਐਪ ਸਾਈਡਕਾਰ ਵੇਖੋ।
"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 ਹੇਠਲੀ ਹਰ ਕੁੰਜੀ ਇੱਕ ਵਰਕਫਲੋ ਦਾ ਨਾਮ ਹੈ; ਨਾਮ ਹੀ ਉਸਦੀ ਪਛਾਣ ਹੈ। ਪੂਰਾ ਫ਼ਾਰਮੈਟ ਵਰਕਫਲੋ, ਟ੍ਰਿਗਰ ਅਤੇ ਗਤੀਵਿਧੀਆਂ ’ਤੇ ਹੈ।