AGENT.md
O AGENT.md é Markdown simples. Comece com um frontmatter que dê nome ao funcionário e traga uma descrição de uma linha; a loja e a equipe de funcionários do proprietário usam os dois. Depois, escreva a persona na segunda pessoa: as responsabilidades do funcionário, como ele trabalha e quais são as regras dele.
--- name: Collections Specialist description: Follows up on every overdue invoice until it is paid, disputed, or handed to the owner. --- # Collections Specialist You keep receivables moving. Every overdue invoice gets a follow-up on schedule, in a tone that protects the customer relationship. ## How you work - Check the aging report before any follow-up so you never chase a paid invoice. - Escalate to the owner when a customer disputes an amount. ## Rules - Never threaten, and never mention collections agencies. - Never agree to a payment plan; propose it to the owner.
O Nebo entrega a persona ao funcionário no início de cada sessão, junto com o nome, a descrição e os gatilhos do frontmatter, além das configurações que o proprietário define para ele no Nebo: personalidade, regras e alma. A persona é exclusiva do funcionário; ela nunca é adicionada a um prompt compartilhado com outros funcionários.
Escreva pelo que a função é responsável e como ela decide. Deixe de fora nomes de ferramentas e de produtos: as ferramentas do funcionário vêm das capacidades e conexões dele, e a mesma persona precisa funcionar em todas as empresas que o contratam.
Memória
Todo funcionário lê as informações do próprio proprietário e só escreve na própria memória. Ele trabalha com a memória pelas ferramentas remember, recall e forget. Escolha como as conversas e a memória dele são mantidas com memory.mode no agent.json.
| Modo | Comportamento | Use para |
|---|---|---|
single | Uma conversa contínua e uma memória. O padrão. | A maioria das funções. |
separate | Muitas conversas compartilham a memória privada do funcionário. Uma conversa com alguém que não seja o proprietário, como quem liga ou um visitante, mantém a própria memória lacrada. | Funções que conversam com muitas pessoas. |
confidential | Cada conversa é um assunto lacrado. Nada do que se aprende em uma fica visível em outra, inclusive nas do proprietário. | Assuntos de clientes que precisam ficar separados. |
"memory": {
"mode": "separate",
"topics": [
{ "slug": "account", "description": "A customer account: balance, promises to pay, contacts, disputes" }
],
"write_bar": ["web", "external-email"],
"share_with": []
} | Campo | Significado |
|---|---|
mode | single, separate ou confidential. Um context_isolated: true antigo é lido como separate. |
topics | Até 8 pares {slug, description} que dizem ao funcionário que tipos de coisa lembrar. Os slugs usam letras minúsculas e hífens; as descrições têm de 1 a 120 caracteres. Slugs reservados: tacit, entity, daily, project, memory, style, artifact. |
write_bar | Uma execução que recebeu conteúdo de uma destas fontes não pode escrever na memória: web, external-email, channel, document, phone, coworker. Quando omitido, channel e phone ficam bloqueados nos modos separate e confidential. Uma lista vazia desativa o bloqueio. |
share_with | IDs de funcionários, ou *, que podem receber a memória deste funcionário nas respostas destinadas a eles. Vazio por padrão, o que não compartilha nada. |
A camada da empresa
A camada da empresa é o conhecimento que todos os funcionários compartilham: o vocabulário da empresa, as partes com quem ela se relaciona, suas regras, leis e padrões, e materiais de referência. Ela fica em pacotes no bot. Um pacote é uma pasta com exatamente um arquivo marcador, INDUSTRY.md, FRANCHISE.md ou COMPANY.md, e pastas tipadas ao lado dele. Quando as camadas divergem, a empresa prevalece sobre a franquia, e a franquia sobre o setor.
<data>/packs/example-co/ ├── COMPANY.md ├── vocabulary/ ├── parties/ ├── rules/ ├── laws/ │ └── refunds.md ├── standards/ ├── workflows/ └── reference/
Cada arquivo em uma pasta é Markdown com frontmatter opcional. O frontmatter carrega a estrutura, como o always de uma regra, o id e o value de um padrão ou o ceiling de uma lei; o corpo carrega o texto. Um pacote guarda conhecimento, nunca procedimentos, então um pacote que contenha uma skill é recusado.
Leis
O ceiling de uma lei lista operações que nenhum funcionário pode executar. Na camada da empresa, reserved_to: owner muda isso: as operações continuam possíveis, mas só com a aprovação do próprio proprietário, e essa aprovação nunca pode ser delegada.
--- ceiling: [ledger.refund.create] reserved_to: owner --- Refunds are issued only by the owner. Employees may prepare a refund and send it to the owner for approval.
Como os funcionários aprendem a camada
Os funcionários não consultam a camada enquanto trabalham. Quando uma camada muda, cada funcionário lê a mudança uma vez e reescreve as próprias regras. O proprietário sempre pode editar o COMPANY.md e todas as pastas da empresa; salvar uma alteração é a forma de o proprietário declarar o que é verdade.