NeboAI
NeboAI
Commencer

Paquets d’employés

Un package d'employé décrit un poste qu'une entreprise peut pourvoir : ce dont l'employé est responsable, sa façon de travailler, les types de systèmes dont il a besoin et ce qu'il fait de lui-même. Vous l'écrivez sous forme de dossier contenant un AGENT.md et, lorsque le poste demande plus que la discussion, un agent.json.

Le package

support-coordinator/
├── AGENT.md        # required: who the employee is and how it works
├── agent.json      # optional: capabilities, inputs, workflows, memory
└── skills/         # optional: skills only this employee uses
    └── reply-drafting/
        └── SKILL.md
FichierObligatoireRôle
AGENT.mdouiLe persona : qui est l'employé, sa façon de travailler et ses règles. Voir Persona et mémoire.
agent.jsonnonLes capacités requises, les questions pour le propriétaire, les workflows, les paramètres de mémoire et les plafonds d'approbation. Voir Référence agent.json.
skills/nonDes skills au format standard SKILL.md. Seul cet employé les voit.
manifest.jsonapplications uniquementIdentité avec "type": "app". La boutique écrit son propre manifeste lorsqu'elle empaquette un employé.
ui/applications uniquementLa page de l'application. Voir Applications.

Écrire un package

Commencez par le persona. L'en-tête nomme l'employé et donne une description d'une ligne ; le corps contient les instructions, en prose simple.

---
name: Support Coordinator
description: Answers every customer message the day it arrives and escalates what it cannot settle.
---

# Support Coordinator

You answer customer email for the company. Reply within the configured window,
in the company's voice, and keep every thread moving until the customer has an answer.

## How you work
- Read the whole thread before you reply.
- Use the reply-drafting skill for every customer reply.
- When a message is about money, draft a proposal for the owner instead of promising anything.

## Rules
- Never promise a refund, a discount or a date you cannot confirm.

Ajoutez agent.json lorsque le poste a besoin d'un système, d'un réglage fourni par le propriétaire ou d'un travail effectué sans qu'on le demande. Celui-ci requiert la capacité mail, pose une question à l'embauche et répond à chaque nouveau message dès son arrivée.

{
  "requires": { "interfaces": ["mail"] },
  "inputs": [
    {
      "key": "reply_window_hours",
      "label": "Reply within (hours)",
      "type": "number",
      "id": "support.reply_window_hours",
      "scope": "company",
      "default": 24
    }
  ],
  "workflows": {
    "new-mail": {
      "trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
      "description": "Handle each customer message as it arrives.",
      "activities": [
        {
          "id": "reply",
          "intent": "Read the message in _watch_payload, draft a reply within reply_window_hours, and escalate anything about money to the owner."
        }
      ]
    }
  }
}

La surveillance nomme la capacité mail, pas un produit. À l'exécution, elle se résout vers le plugin que le propriétaire a connecté pour le courrier. Voir Workflows pour les déclencheurs et les activités.

Le charger sur un bot

Placez le dossier dans <data>/user/agents/<name>/. Nebo surveille AGENT.md, agent.json et manifest.json et recharge l'employé environ une seconde après une modification. Supprimer le dossier désactive l'employé mais conserve sa fiche.

Nebo charge les employés depuis trois sources, et les dernières l'emportent : les employés intégrés à Nebo, les packages scellés de la boutique dans <data>/nebo/agents/, et les dossiers de <data>/user/agents/. Un employé peut aussi créer ou modifier un package pour vous avec ses outils create_employee et update_employee, qui écrivent le même dossier.

Ce qui se passe à l'embauche

Lorsqu'un propriétaire embauche votre employé depuis la boutique ou avec un code AGNT-, Nebo :

  1. Lit les besoins du package sans interroger de modèle : chaque capacité de requires.interfaces, chaque plugin de requires.plugins, et chaque capacité ou plugin nommé par un déclencheur de surveillance.
  2. Présente au propriétaire une seule phrase de consentement pour ces besoins et, à l'embauche, les accorde à cet employé sous forme d'autorisations permanentes. Les opérations qui nécessitent une approbation la nécessitent toujours. Voir Capacités et approbations.
  3. Installe les dépendances : les plugins de requires.plugins, les skills de la boutique nommés dans skills et dans les activités, et les dépendances déclarées lors de la publication du package.
  4. Pose au propriétaire les questions inputs, et l'informe via la Boîte de réception de toute capacité qui n'a pas encore de connexion.

Un workflow dont la capacité n'a pas de connexion est conservé et marqué comme dégradé, avec la raison. Il se met à fonctionner dès que le propriétaire connecte un système.

Ce que Nebo vérifie

Nebo lit agent.json avec souplesse. Les clés inconnues sont ignorées. Un workflow qui ne correspond pas au schéma est ignoré, et le propriétaire reçoit un avis dans la Boîte de réception indiquant qu'il ne s'exécutera pas ; le reste de l'employé se charge quand même. Les problèmes suivants entraînent le rejet du fichier entier :

  • Un déclencheur event avec une liste sources vide.
  • Deux activités avec le même id dans un même workflow.
  • Une entrée avec un scope autre que company ou seat, ou une question de montant avec une valeur par défaut.
  • Une valeur de ceiling autre que "approval".
  • Une arborescence d'appel téléphonique qui n'a pas exactement un message d'accueil et au moins une intention nommée.

Certaines vérifications ont lieu au démarrage d'un workflow plutôt qu'à son chargement, comme les paramètres requis par chaque type d'activité. Voir Activités.

Décrivez des responsabilités, pas des outils. Un package d'employé nomme des capacités, comme ledger ou mail, et jamais un produit, une entreprise ou un secteur précis. Le propriétaire décide quel système remplit chaque capacité, si bien qu'un seul package convient à toutes les entreprises qui l'embauchent.

Suite