Παράδειγμα
{
"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 που σερβίρονται από το sidecar μιας εφαρμογής. Βλ. Εργαλεία sidecar. |
scopes | map | Επώνυμες ομάδες από tools, skills και plugins. Τα plugins ενός scope περιγράφονται στον υπάλληλο όταν αυτό το scope είναι ενεργό. |
Είσοδοι
Ένα input είναι μια ερώτηση που απαντά ο κάτοχος κατά την πρόσληψη. Οι απαντήσεις εμφανίζονται στον υπάλληλο στην ενότητα «Configured Inputs» και συμπληρώνουν τα placeholders {{key}} στους triggers παρακολούθησης και φακέλων.
{
"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 εκθέτει endpoints HTTP στον υπάλληλό της ως εργαλεία. Το Nebo καταχωρίζει κάθε καταχώριση ως app__<app>__<name> και στέλνει τις κλήσεις στο sidecar στα method και path. Δείτε το 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 ονομάζει μία ροή εργασίας· το όνομα είναι το αναγνωριστικό της. Η πλήρης μορφή βρίσκεται στις σελίδες Ροές εργασίας, Εναύσματα και Δραστηριότητες.