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 | Fichier | Obligatoire | Rôle |
|---|---|---|
AGENT.md | oui | Le persona : qui est l'employé, sa façon de travailler et ses règles. Voir Persona et mémoire. |
agent.json | non | Les 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/ | non | Des skills au format standard SKILL.md. Seul cet employé les voit. |
manifest.json | applications uniquement | Identité avec "type": "app". La boutique écrit son propre manifeste lorsqu'elle empaquette un employé. |
ui/ | applications uniquement | La 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 :
- Lit les besoins du package sans interroger de modèle : chaque capacité de
requires.interfaces, chaque plugin derequires.plugins, et chaque capacité ou plugin nommé par un déclencheur de surveillance. - 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.
- Installe les dépendances : les plugins de
requires.plugins, les skills de la boutique nommés dansskillset dans les activités, et les dépendances déclarées lors de la publication du package. - 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
eventavec une listesourcesvide. - Deux activités avec le même
iddans un même workflow. - Une entrée avec un
scopeautre quecompanyouseat, ou une question de montant avec une valeur par défaut. - Une valeur de
ceilingautre 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
- Référence agent.json
- Persona et mémoire
- Publication : mettre l'employé sur la boutique.