O pacote
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 | Ficheiro | Obrigatório | Finalidade |
|---|---|---|
AGENT.md | sim | A persona: quem é o funcionário, como trabalha e as suas regras. Ver Persona e memória. |
agent.json | não | As capacidades de que precisa, as perguntas para o proprietário, os fluxos de trabalho, as definições de memória e os limites de aprovação. Ver Referência do agent.json. |
skills/ | não | Skills no formato padrão SKILL.md. Só este funcionário as vê. |
manifest.json | só apps | Identidade com "type": "app". A loja escreve o seu próprio manifesto quando empacota um funcionário. |
ui/ | só apps | A página da app. Ver Apps. |
Escrever um pacote
Comece pela persona. O frontmatter dá o nome do funcionário e uma descrição de uma linha; o corpo são instruções em texto simples.
--- 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.
Adicione o agent.json quando a função precisa de um sistema, de uma definição do proprietário ou de trabalho que faz sem que lho peçam. Este exige a capacidade mail, faz uma pergunta na contratação e responde a cada nova mensagem à medida que chega.
{
"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."
}
]
}
}
} A vigilância indica a capacidade mail, não um produto. Em tempo de execução, resolve-se no plugin que o proprietário ligou para o email. Ver Fluxos de trabalho para gatilhos e atividades.
Carregá-lo num bot
Coloque a pasta em <data>/user/agents/<name>/. O Nebo vigia o AGENT.md, o agent.json e o manifest.json e recarrega o funcionário cerca de um segundo depois de uma alteração. Remover a pasta desativa o funcionário, mas mantém o seu registo.
O Nebo carrega funcionários de três origens, e as posteriores prevalecem: funcionários integrados no Nebo, pacotes selados da loja em <data>/nebo/agents/ e pastas em <data>/user/agents/. Um funcionário também pode criar ou alterar um pacote por si com as ferramentas create_employee e update_employee, que escrevem a mesma pasta.
O que acontece na contratação
Quando um proprietário contrata o seu funcionário a partir da loja ou com um código AGNT-, o Nebo:
- Lê as necessidades do pacote sem consultar um modelo: todas as capacidades em
requires.interfaces, todos os plugins emrequires.pluginse todas as capacidades ou plugins indicados num gatilho de vigilância. - Mostra ao proprietário uma única frase de consentimento para essas necessidades e, na contratação, concede-as a este funcionário como permissões permanentes. As operações que precisam de aprovação continuam a precisar. Ver Capacidades e aprovações.
- Instala as dependências: plugins em
requires.plugins, skills da loja indicadas emskillse nas atividades, e as dependências declaradas quando o pacote foi publicado. - Faz ao proprietário as perguntas de
inputse avisa-o, através da Caixa de entrada, de qualquer capacidade que ainda não tenha ligação.
Um fluxo de trabalho cuja capacidade não tem ligação é mantido e marcado como degradado, com o motivo. Começa a funcionar assim que o proprietário ligar um sistema.
O que o Nebo verifica
O Nebo lê o agent.json com tolerância. As chaves desconhecidas são ignoradas. Um fluxo de trabalho que não corresponda ao esquema é ignorado e o proprietário recebe um aviso na Caixa de entrada de que não vai correr; o resto do funcionário continua a carregar. Estes problemas rejeitam o ficheiro inteiro:
- Um gatilho
eventcom uma listasourcesvazia. - Duas atividades com o mesmo
idnum só fluxo de trabalho. - Uma entrada com um
scopeque não sejacompanynemseat, ou uma pergunta sobre dinheiro com valor predefinido. - Um valor de
ceilingque não seja"approval". - Uma árvore de chamadas telefónicas sem exatamente uma saudação e pelo menos uma intenção com nome.
Algumas verificações são feitas quando um fluxo de trabalho arranca e não quando é carregado, como os parâmetros que cada tipo de atividade exige. Ver Atividades.
Escreva responsabilidades, não ferramentas. Um pacote de funcionário indica capacidades, como ledger ou mail, e nunca um produto, uma empresa ou um setor específico. É o proprietário que decide que sistema preenche cada capacidade, por isso um só pacote serve todas as empresas que o contratam.
A seguir
- Referência do agent.json
- Persona e memória
- Publicação: ponha o funcionário na loja.