AGENT.md
O AGENT.md é Markdown simples. Comece com um frontmatter que dê o nome do funcionário e uma descrição de uma linha; a loja e o pessoal do proprietário usam ambos. Depois escreva a persona na segunda pessoa: as responsabilidades do funcionário, como trabalha e as suas regras.
--- 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 dá ao funcionário a sua persona no início de cada sessão, juntamente com o nome, a descrição e os gatilhos do frontmatter, e as definições que o proprietário lhe atribui no Nebo: a personalidade, as regras e a alma. A persona é privada do funcionário; nunca é acrescentada a um prompt partilhado por outros funcionários.
Escreva pelo que a função é responsável e como decide. Não inclua nomes de ferramentas nem de produtos: as ferramentas do funcionário vêm das suas capacidades e ligações, e a mesma persona tem de funcionar em todas as empresas que o contratam.
Memória
Todos os funcionários leem os factos do próprio proprietário e escrevem apenas na sua própria memória. Trabalham com a memória através das ferramentas remember, recall e forget. Escolha como as conversas e a memória são mantidas com memory.mode no agent.json.
| Modo | Comportamento | Use para |
|---|---|---|
single | Uma conversa contínua e uma memória. A predefinição. | A maioria das funções. |
separate | Muitas conversas partilham 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 sua própria memória selada. | Funções que falam com muitas pessoas. |
confidential | Cada conversa é um assunto selado. Nada do que se aprende numa é visível noutra, incluindo nas do proprietário. | Assuntos de clientes que têm de 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 coisas lembrar. Os slugs são em minúsculas com hífenes; as descrições têm de 1 a 120 carateres. Slugs reservados: tacit, entity, daily, project, memory, style, artifact. |
write_bar | Uma execução que tenha recebido conteúdo de uma destas origens 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 *, autorizados a receber a memória deste funcionário nas respostas que lhes são dadas. Vazio por predefinição, o que não partilha nada. |
A camada da empresa
A camada da empresa é conhecimento que todos os funcionários partilham: o vocabulário da empresa, as entidades com que trabalha, as suas regras, leis e normas, e material de referência. Vive em packs no bot. Um pack é uma pasta com exatamente um ficheiro marcador, INDUSTRY.md, FRANCHISE.md ou COMPANY.md, e pastas tipificadas ao lado. Quando as camadas discordam, a empresa prevalece sobre o franchising e o franchising sobre o setor.
<data>/packs/example-co/ ├── COMPANY.md ├── vocabulary/ ├── parties/ ├── rules/ ├── laws/ │ └── refunds.md ├── standards/ ├── workflows/ └── reference/
Cada ficheiro de uma pasta é Markdown com frontmatter opcional. O frontmatter contém a estrutura, como o always de uma regra, o id e o value de uma norma ou o ceiling de uma lei; o corpo contém o texto. Um pack guarda conhecimento, nunca procedimentos, por isso um pack que contenha uma skill é recusado.
Leis
O ceiling de uma lei lista as 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 alteração uma vez e reescreve as suas próprias regras. O proprietário pode sempre editar o COMPANY.md e todas as pastas da empresa; guardar uma alteração é a forma de o proprietário declarar o que é verdade.