NeboAI
NeboAI
Começar

Pacotes de funcionários

Um pacote de funcionário descreve uma função que uma empresa pode contratar: pelo que o funcionário é responsável, como trabalha, de que tipos de sistemas precisa e o que faz por iniciativa própria. Escreve-o como uma pasta com um AGENT.md e, quando a função precisa de mais do que conversa, um agent.json.

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
FicheiroObrigatórioFinalidade
AGENT.mdsimA persona: quem é o funcionário, como trabalha e as suas regras. Ver Persona e memória.
agent.jsonnãoAs 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ãoSkills no formato padrão SKILL.md. Só este funcionário as vê.
manifest.jsonsó appsIdentidade com "type": "app". A loja escreve o seu próprio manifesto quando empacota um funcionário.
ui/só appsA 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:

  1. Lê as necessidades do pacote sem consultar um modelo: todas as capacidades em requires.interfaces, todos os plugins em requires.plugins e todas as capacidades ou plugins indicados num gatilho de vigilância.
  2. 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.
  3. Instala as dependências: plugins em requires.plugins, skills da loja indicadas em skills e nas atividades, e as dependências declaradas quando o pacote foi publicado.
  4. Faz ao proprietário as perguntas de inputs e 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 event com uma lista sources vazia.
  • Duas atividades com o mesmo id num só fluxo de trabalho.
  • Uma entrada com um scope que não seja company nem seat, ou uma pergunta sobre dinheiro com valor predefinido.
  • Um valor de ceiling que 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