NeboAI
NeboAI
Začít

Balíčky zaměstnanců

Balíček zaměstnance popisuje roli, kterou firma může obsadit: za co zaměstnanec odpovídá, jak pracuje, jaké druhy systémů potřebuje a co dělá sám. Píšete ho jako složku s AGENT.md a, když role potřebuje víc než chat, s agent.json.

Balíček

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
SouborPovinnéÚčel
AGENT.mdanoPersona: kdo zaměstnanec je, jak pracuje a jaká má pravidla. Viz Persona a paměť.
agent.jsonneSchopnosti, které vyžaduje, otázky pro vlastníka, pracovní postupy, nastavení paměti a stropy schvalování. Viz Reference agent.json.
skills/neDovednosti ve standardním formátu SKILL.md. Vidí je jen tento zaměstnanec.
manifest.jsonjen aplikaceIdentita s "type": "app". Obchod si při balení zaměstnance zapisuje vlastní manifest.
ui/jen aplikaceStránka aplikace. Viz Aplikace.

Napište balíček

Začněte personou. Úvodní blok pojmenuje zaměstnance a dá mu jednořádkový popis; tělo tvoří pokyny v prostém textu.

---
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.

Přidejte agent.json, když role potřebuje systém, nastavení od vlastníka nebo práci, kterou dělá, aniž by o ni byl požádán. Tento vyžaduje schopnost mail, při přijetí položí jednu otázku a odpovídá na každou novou zprávu, jakmile dorazí.

{
  "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."
        }
      ]
    }
  }
}

Sledování uvádí schopnost mail, ne produkt. Za běhu se přeloží na plugin, který vlastník připojil pro poštu. Spouštěče a aktivity najdete v části Pracovní postupy.

Načtení do bota

Vložte složku do <data>/user/agents/<name>/. Nebo sleduje AGENT.md, agent.json a manifest.json a zaměstnance po změně asi za sekundu znovu načte. Odstraněním složky se zaměstnanec deaktivuje, ale jeho záznam zůstane.

Nebo načítá zaměstnance ze tří zdrojů a pozdější zdroje mají přednost: zaměstnanci vestavění v Nebo, zapečetěné balíčky z obchodu v <data>/nebo/agents/ a složky v <data>/user/agents/. Balíček za vás může vytvořit nebo změnit i zaměstnanec pomocí svých nástrojů create_employee a update_employee, které zapisují do stejné složky.

Co se děje při přijetí

Když vlastník přijme vašeho zaměstnance z obchodu nebo pomocí kódu AGNT-, Nebo:

  1. Přečte potřeby balíčku bez dotazu na model: každou schopnost v requires.interfaces, každý plugin v requires.plugins a každou schopnost nebo plugin, které uvádí sledovací spouštěč.
  2. Ukáže vlastníkovi k těmto potřebám jednu větu se souhlasem a při přijetí je tomuto zaměstnanci udělí jako trvalá oprávnění. Operace, které vyžadují schválení, ho vyžadují i nadále. Viz Schopnosti a schvalování.
  3. Nainstaluje závislosti: pluginy v requires.plugins, dovednosti z obchodu uvedené v skills a v aktivitách a závislosti deklarované při publikování balíčku.
  4. Položí vlastníkovi otázky z inputs a přes Doručené mu oznámí každou schopnost, která zatím nemá propojení.

Pracovní postup, jehož schopnost nemá propojení, se ponechá a označí jako omezený i s důvodem. Začne fungovat, jakmile vlastník připojí systém.

Co Nebo kontroluje

Nebo čte agent.json shovívavě. Neznámé klíče se ignorují. Pracovní postup, který neodpovídá schématu, se přeskočí a vlastník dostane do Doručených upozornění, že nepoběží; zbytek zaměstnance se přesto načte. Celý soubor odmítnou tyto problémy:

  • Spouštěč event s prázdným seznamem sources.
  • Dvě aktivity se stejným id v jednom pracovním postupu.
  • Vstup se scope jiným než company nebo seat, nebo otázka na peníze s výchozí hodnotou.
  • Hodnota ceiling jiná než "approval".
  • Strom telefonního hovoru, který nemá právě jeden pozdrav a alespoň jeden pojmenovaný záměr.

Některé kontroly proběhnou až při spuštění pracovního postupu, ne při jeho načtení, například parametry, které vyžaduje každý typ aktivity. Viz Aktivity.

Pište odpovědnosti, ne nástroje. Balíček zaměstnance uvádí schopnosti, jako je ledger nebo mail, a nikdy konkrétní produkt, firmu nebo odvětví. Který systém kterou schopnost naplní, rozhoduje vlastník, takže jeden balíček poslouží každé firmě, která zaměstnance přijme.

Dále