ఉదాహరణ
{
"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ల పేరున్న సమూహాలు. ఒక scope యాక్టివ్గా ఉన్నప్పుడు దాని plugins ఉద్యోగికి వివరించబడతాయి. |
ఇన్పుట్లు
ఇన్పుట్ అనేది నియమించుకునేటప్పుడు యజమాని జవాబిచ్చే ప్రశ్న. సమాధానాలు ఉద్యోగికి "Configured Inputs" కింద కనిపిస్తాయి, మరియు watch, folder ట్రిగ్గర్లలోని {{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 వద్ద సైడ్కార్కు పంపుతుంది. App సైడ్కార్ చూడండి.
"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 కింద ప్రతి కీ ఒక వర్క్ఫ్లోకు పేరు పెడుతుంది; ఆ పేరే దాని ఐడెంటిఫైయర్. పూర్తి ఫార్మాట్ వర్క్ఫ్లోలు, ట్రిగ్గర్లు, యాక్టివిటీలు పేజీలలో ఉంది.