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 | Arquivo | Obrigatório | Finalidade |
|---|---|---|
AGENT.md | sim | A persona: quem o funcionário é, como trabalha e quais são as regras dele. Veja Persona e memória. |
agent.json | não | As capacidades que ele exige, perguntas para o proprietário, fluxos de trabalho, configurações de memória e limites de aprovação. Veja 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 próprio manifesto quando empacota um funcionário. |
ui/ | só apps | A página do app. Veja Apps. |
Escreva um pacote
Comece pela persona. O frontmatter dá nome ao funcionário e traz 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 precisar de um sistema, de uma configuração vinda do proprietário ou de trabalho que ela faz sem que ninguém peça. Este aqui exige a capacidade mail, faz uma pergunta na contratação e responde cada nova mensagem assim que ela 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."
}
]
}
}
} O monitoramento nomeia a capacidade mail, não um produto. Na hora da execução, ela é resolvida para o plugin que o proprietário conectou para e-mail. Veja Fluxos de trabalho para gatilhos e atividades.
Carregue em um bot
Coloque a pasta em <data>/user/agents/<name>/. O Nebo monitora AGENT.md, agent.json e 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 registro dele.
O Nebo carrega funcionários de três fontes, e as fontes posteriores prevalecem: funcionários que vêm com o Nebo, pacotes lacrados da loja em <data>/nebo/agents/ e pastas em <data>/user/agents/. Um funcionário também pode criar ou alterar um pacote para você com as ferramentas create_employee e update_employee, que escrevem a mesma pasta.
O que acontece na contratação
Quando um proprietário contrata seu funcionário pela loja ou com um código AGNT-, o Nebo:
- Lê as necessidades do pacote sem consultar um modelo: cada capacidade em
requires.interfaces, cada plugin emrequires.pluginse cada capacidade ou plugin que um gatilho de monitoramento nomeia. - Mostra ao proprietário uma única frase de consentimento para essas necessidades e, na contratação, as concede a este funcionário como permissões permanentes. As operações que exigem aprovação continuam exigindo. Veja 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 pela Caixa de entrada sobre qualquer capacidade que ainda não tenha conexão.
Um fluxo de trabalho cuja capacidade não tem conexão é mantido e marcado como degradado, com o motivo. Ele começa a funcionar assim que o proprietário conecta um sistema.
O que o Nebo verifica
O Nebo lê o agent.json com tolerância. Chaves desconhecidas são ignoradas. Um fluxo de trabalho que não segue o esquema é ignorado, e o proprietário recebe um aviso na Caixa de entrada de que ele não vai rodar; o restante do funcionário é carregado normalmente. Estes problemas fazem o arquivo inteiro ser recusado:
- Um gatilho
eventcom a listasourcesvazia. - Duas atividades com o mesmo
idem um fluxo de trabalho. - Uma entrada com
scopediferente decompanyouseat, ou uma pergunta de valor monetário com um padrão. - Um valor de
ceilingdiferente de"approval". - Uma árvore de atendimento telefônico sem exatamente uma saudação e pelo menos uma intenção nomeada.
Algumas verificações rodam quando um fluxo de trabalho começa, e não quando ele é carregado, como os parâmetros que cada tipo de atividade exige. Veja Atividades.
Escreva responsabilidades, não ferramentas. Um pacote de funcionário nomeia capacidades, como ledger ou mail, e nunca um produto, empresa ou setor específico. O proprietário decide qual sistema preenche cada capacidade, então um único pacote atende todas as empresas que o contratam.
Próximo
- Referência do agent.json
- Persona e memória
- Publicação: coloque o funcionário na loja.