Exemple
{
"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." }
]
}
}
} Champs
| Champ | Type | Signification |
|---|---|---|
requires.interfaces | liste de chaînes | Les capacités dont le poste a besoin, comme mail ou ledger. Accordées à l'embauche ; chaque opération soumise à approbation reste un élément à approuver. Voir Capacités et approbations. |
requires.plugins | liste de chaînes | Les plugins installés avec l'employé. À utiliser uniquement lorsque le poste dépend vraiment d'un plugin précis ; préférez une capacité. |
requires.tools | liste de chaînes | Les outils chargés dans la session de l'employé dès son premier tour. Cela ne contourne jamais l'approbation. |
skills | liste de chaînes | Les skills de la boutique à installer et utiliser : @org/skills/name, éventuellement @version, ou un code SKIL-. Les skills du dossier skills/ du package n'ont pas besoin d'entrée. |
inputs | list | Les questions auxquelles le propriétaire répond à l'embauche. Voir Entrées. |
memory | object | La façon dont les conversations et la mémoire sont conservées. Voir Persona et mémoire. |
subscribes | liste de chaînes | Les domaines de faits de l'entreprise que l'employé relit lorsqu'ils changent, comme finance.ar.*. |
ceiling | map | Opération vers "approval". Cette opération demande toujours l'accord du propriétaire pour cet employé. Aucune autre valeur n'est acceptée. |
workflows | map | Nom du workflow vers le workflow. Voir Workflows. |
tools | list | Des outils HTTP servis par le sidecar d'une application. Voir Outils sidecar. |
scopes | map | Des groupes nommés de tools, skills et plugins. Les plugins d'un scope sont décrits à l'employé lorsque ce scope est actif. |
Entrées
Une entrée est une question à laquelle le propriétaire répond lors du recrutement. Les réponses apparaissent pour l'employé sous « Configured Inputs » et remplissent les espaces réservés {{key}} dans les déclencheurs de surveillance et de dossier.
{
"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"
} | Champ | Par défaut | Signification |
|---|---|---|
key | obligatoire | Nom utilisé dans les espaces réservés. name est accepté en solution de repli. |
label | d'après key | La question affichée au propriétaire. |
type | text | text, textarea, number, select, checkbox ou radio. |
required | false | Indique que le propriétaire doit obligatoirement répondre à la question. |
default | aucune | Réponse préremplie. Non autorisée pour une question de montant. |
placeholder, description | aucune | Texte d'aide. |
options | aucune | Pour select et radio : des objets {value, label} ou de simples chaînes. |
id | aucune | Un nom stable, avec des points, pour le fait, comme finance.ap.invoice_mailbox, afin que d'autres employés puissent le partager. |
scope | company | company : un fait partagé de l'entreprise. seat : uniquement pour cette embauche. |
missing | aucune | Ce que fait l'employé tant que la question reste sans réponse. |
money | false | Indique un montant d'argent. Une question de montant ne peut pas avoir de valeur par défaut. |
Outils sidecar
Une application dotée d'un sidecar expose des points de terminaison HTTP à son employé sous forme d'outils. Nebo enregistre chaque entrée sous le nom app__<app>__<name> et envoie les appels au sidecar selon method et path. Voir Sidecar d'application.
"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
Chaque clé sous workflows nomme un workflow ; ce nom est son identifiant. Le format complet est décrit dans Workflows, Déclencheurs et Activités.