NeboAI
NeboAI
Commencer

Référence agent.json

agent.json contient tout ce qui, chez un employé, n'est pas de la prose : les capacités qu'il requiert, les questions qu'il pose au propriétaire, la façon dont sa mémoire est conservée, les opérations qui nécessitent toujours une approbation et les workflows qu'il exécute. Tous les champs sont facultatifs.

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

ChampTypeSignification
requires.interfacesliste de chaînesLes 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.pluginsliste de chaînesLes 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.toolsliste de chaînesLes outils chargés dans la session de l'employé dès son premier tour. Cela ne contourne jamais l'approbation.
skillsliste de chaînesLes 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.
inputslistLes questions auxquelles le propriétaire répond à l'embauche. Voir Entrées.
memoryobjectLa façon dont les conversations et la mémoire sont conservées. Voir Persona et mémoire.
subscribesliste de chaînesLes domaines de faits de l'entreprise que l'employé relit lorsqu'ils changent, comme finance.ar.*.
ceilingmapOpération vers "approval". Cette opération demande toujours l'accord du propriétaire pour cet employé. Aucune autre valeur n'est acceptée.
workflowsmapNom du workflow vers le workflow. Voir Workflows.
toolslistDes outils HTTP servis par le sidecar d'une application. Voir Outils sidecar.
scopesmapDes 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"
}
ChampPar défautSignification
keyobligatoireNom utilisé dans les espaces réservés. name est accepté en solution de repli.
labeld'après keyLa question affichée au propriétaire.
typetexttext, textarea, number, select, checkbox ou radio.
requiredfalseIndique que le propriétaire doit obligatoirement répondre à la question.
defaultaucuneRéponse préremplie. Non autorisée pour une question de montant.
placeholder, descriptionaucuneTexte d'aide.
optionsaucunePour select et radio : des objets {value, label} ou de simples chaînes.
idaucuneUn nom stable, avec des points, pour le fait, comme finance.ap.invoice_mailbox, afin que d'autres employés puissent le partager.
scopecompanycompany : un fait partagé de l'entreprise. seat : uniquement pour cette embauche.
missingaucuneCe que fait l'employé tant que la question reste sans réponse.
moneyfalseIndique 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.