NeboAI
NeboAI
Inizia

Pacchetti dei dipendenti

Un pacchetto dipendente descrive un ruolo che un’azienda può assumere: di cosa è responsabile il dipendente, come lavora, di quali tipi di sistemi ha bisogno e cosa fa da solo. Lo scrivi come una cartella con un AGENT.md e, quando il ruolo richiede più della chat, un agent.json.

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
FileObbligatorioScopo
AGENT.mdsìLa persona: chi è il dipendente, come lavora e le sue regole. Vedi Persona e memoria.
agent.jsonnoCapability richieste, domande per il titolare, flussi di lavoro, impostazioni della memoria e limiti di approvazione. Vedi Riferimento di agent.json.
skills/noSkill nel formato standard SKILL.md. Le vede solo questo dipendente.
manifest.jsonsolo appIdentità con "type": "app". Il marketplace scrive il proprio manifest quando crea il pacchetto di un dipendente.
ui/solo appLa 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:

  1. Legge i requisiti del pacchetto senza interpellare un modello: ogni capability in requires.interfaces, ogni plugin in requires.plugins e ogni capability o plugin indicato da un trigger di monitoraggio.
  2. 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.
  3. Installa le dipendenze: i plugin in requires.plugins, le skill del marketplace indicate in skills e nelle attività, e le dipendenze dichiarate al momento della pubblicazione del pacchetto.
  4. Pone al titolare le domande di inputs e 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 event con un elenco sources vuoto.
  • Due attività con lo stesso id nello stesso flusso di lavoro.
  • Un input con uno scope diverso da company o seat, oppure una domanda su un importo con un valore predefinito.
  • Un valore di ceiling diverso 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