Il pacchetto
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 | File | Obbligatorio | Scopo |
|---|---|---|
AGENT.md | sì | La persona: chi è il dipendente, come lavora e le sue regole. Vedi Persona e memoria. |
agent.json | no | Capability richieste, domande per il titolare, flussi di lavoro, impostazioni della memoria e limiti di approvazione. Vedi Riferimento di agent.json. |
skills/ | no | Skill nel formato standard SKILL.md. Le vede solo questo dipendente. |
manifest.json | solo app | Identità con "type": "app". Il marketplace scrive il proprio manifest quando crea il pacchetto di un dipendente. |
ui/ | solo app | La pagina dell’app. Vedi App. |
Scrivi un pacchetto
Inizia dalla persona. Il frontmatter dà il nome al dipendente e una descrizione di una riga; il corpo contiene istruzioni in prosa semplice.
--- 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.
Aggiungi agent.json quando il ruolo ha bisogno di un sistema, di un’impostazione del titolare o di lavoro da fare senza che gli venga chiesto. Questo richiede la capability mail, fa una domanda al momento dell’assunzione e risponde a ogni nuovo messaggio appena arriva.
{
"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."
}
]
}
}
} Il monitoraggio indica la capability mail, non un prodotto. Durante l’esecuzione corrisponde al plugin che il titolare ha collegato per la posta. Vedi Flussi di lavoro per trigger e attività.
Caricalo su un bot
Metti la cartella in <data>/user/agents/<name>/. Nebo monitora AGENT.md, agent.json e manifest.json e ricarica il dipendente circa un secondo dopo una modifica. Togliere la cartella disattiva il dipendente ma ne conserva la scheda.
Nebo carica i dipendenti da tre fonti, e le ultime hanno la precedenza: i dipendenti integrati in Nebo, i pacchetti sigillati del marketplace in <data>/nebo/agents/ e le cartelle in <data>/user/agents/. Un dipendente può anche creare o modificare un pacchetto per te con i suoi strumenti create_employee e update_employee, che scrivono nella stessa cartella.
Cosa succede all’assunzione
Quando un titolare assume il tuo dipendente dal marketplace o con un codice AGNT-, Nebo:
- Legge i requisiti del pacchetto senza interpellare un modello: ogni capability in
requires.interfaces, ogni plugin inrequires.pluginse ogni capability o plugin indicato da un trigger di monitoraggio. - Mostra al titolare una sola frase di consenso per quei requisiti e, all’assunzione, li concede a questo dipendente come permessi permanenti. Le operazioni che richiedono approvazione restano tali. Vedi Capability e approvazioni.
- Installa le dipendenze: i plugin in
requires.plugins, le skill del marketplace indicate inskillse nelle attività, e le dipendenze dichiarate al momento della pubblicazione del pacchetto. - Pone al titolare le domande di
inputse lo avvisa tramite la Posta in arrivo di ogni capability che non ha ancora una connessione.
Un flusso di lavoro la cui capability non ha una connessione viene conservato e segnato come limitato, con il motivo. Inizia a funzionare appena il titolare collega un sistema.
Cosa verifica Nebo
Nebo legge agent.json con tolleranza. Le chiavi sconosciute vengono ignorate. Un flusso di lavoro che non rispetta lo schema viene saltato e il titolare riceve un avviso nella Posta in arrivo che non verrà eseguito; il resto del dipendente si carica comunque. Questi problemi fanno rifiutare l’intero file:
- Un trigger
eventcon un elencosourcesvuoto. - Due attività con lo stesso
idnello stesso flusso di lavoro. - Un input con uno
scopediverso dacompanyoseat, oppure una domanda su un importo con un valore predefinito. - Un valore di
ceilingdiverso da"approval". - Un albero di chiamate telefoniche che non ha esattamente un saluto e almeno un intento con nome.
Alcune verifiche avvengono quando un flusso di lavoro si avvia anziché quando si carica, come i parametri richiesti da ogni tipo di attività. Vedi Attività.
Scrivi responsabilità, non strumenti. Un pacchetto dipendente indica capability, come ledger o mail, e mai un prodotto, un’azienda o un settore specifico. È il titolare a decidere quale sistema copre ogni capability, così un solo pacchetto va bene per ogni azienda che lo assume.
Avanti
- Riferimento di agent.json
- Persona e memoria
- Pubblicazione: metti il dipendente nel marketplace.