NeboAI
NeboAI
Začať

Balíky zamestnancov

Balík zamestnanca opisuje rolu, ktorú môže firma obsadiť: za čo zamestnanec zodpovedá, ako pracuje, aké druhy systémov potrebuje a čo robí sám. Píšete ho ako priečinok s AGENT.md a, keď rola potrebuje viac ako chat, aj s agent.json.

Balík

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
SúborPovinnéÚčel
AGENT.mdánoPersona: kto zamestnanec je, ako pracuje a jeho pravidlá. Pozri Persona a pamäť.
agent.jsonnieSchopnosti, ktoré vyžaduje, otázky pre vlastníka, pracovné postupy, nastavenia pamäte a stropy schvaľovania. Pozri Referencia agent.json.
skills/nieZručnosti v štandardnom formáte SKILL.md. Vidí ich len tento zamestnanec.
manifest.jsonlen aplikácieIdentita s "type": "app". Obchod pri balení zamestnanca zapíše vlastný manifest.
ui/len aplikácieStránka aplikácie. Pozri Aplikácie.

Napísanie balíka

Začnite personou. Frontmatter pomenuje zamestnanca a dá mu jednoriadkový popis; telo tvoria pokyny v obyčajnej próze.

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

Pridajte agent.json, keď rola potrebuje systém, nastavenie od vlastníka alebo prácu, ktorú robí bez požiadania. Tento vyžaduje schopnosť mail, pri prijatí položí jednu otázku a odpovedá na každú novú správu hneď, ako príde.

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

Sledovanie pomenúva schopnosť mail, nie produkt. Za behu sa preloží na doplnok, ktorý vlastník pripojil pre poštu. Spúšťače a aktivity nájdete v časti Pracovné postupy.

Načítanie na bota

Vložte priečinok do <data>/user/agents/<name>/. Nebo sleduje AGENT.md, agent.json a manifest.json a približne sekundu po zmene zamestnanca znova načíta. Odstránením priečinka sa zamestnanec deaktivuje, ale jeho záznam zostane.

Nebo načítava zamestnancov z troch zdrojov a neskoršie zdroje majú prednosť: zamestnanci vstavaní v Nebo, zapečatené balíky z obchodu v <data>/nebo/agents/ a priečinky v <data>/user/agents/. Zamestnanec môže pre vás balík aj vytvoriť alebo zmeniť pomocou svojich nástrojov create_employee a update_employee, ktoré zapisujú do toho istého priečinka.

Čo sa deje pri prijatí

Keď vlastník prijme vášho zamestnanca z obchodu alebo kódom AGNT-, Nebo:

  1. Prečíta potreby balíka bez pýtania sa modelu: každú schopnosť v requires.interfaces, každý doplnok v requires.plugins a každú schopnosť alebo doplnok, ktoré pomenúva sledovací spúšťač.
  2. Ukáže vlastníkovi jednu vetu so súhlasom s týmito potrebami a pri prijatí ich tomuto zamestnancovi udelí ako trvalé oprávnenia. Operácie, ktoré vyžadujú schválenie, ho vyžadujú aj naďalej. Pozri Schopnosti a schválenia.
  3. Nainštaluje závislosti: doplnky v requires.plugins, zručnosti z obchodu uvedené v skills a v aktivitách a závislosti deklarované pri publikovaní balíka.
  4. Položí vlastníkovi otázky z inputs a cez Doručené mu oznámi každú schopnosť, ktorá ešte nemá pripojenie.

Pracovný postup, ktorého schopnosť nemá pripojenie, sa zachová a označí ako obmedzený aj s dôvodom. Začne fungovať hneď, ako vlastník pripojí systém.

Čo Nebo kontroluje

Nebo číta agent.json zhovievavo. Neznáme kľúče sa ignorujú. Pracovný postup, ktorý nezodpovedá schéme, sa preskočí a vlastník dostane v Doručených upozornenie, že nepobeží; zvyšok zamestnanca sa aj tak načíta. Tieto problémy odmietnu celý súbor:

  • Spúšťač event s prázdnym zoznamom sources.
  • Dve aktivity s rovnakým id v jednom pracovnom postupe.
  • Vstup so scope iným ako company alebo seat, alebo finančná otázka s predvolenou hodnotou.
  • Hodnota ceiling iná ako "approval".
  • Strom telefonického hovoru bez práve jedného pozdravu a aspoň jedného pomenovaného zámeru.

Niektoré kontroly prebiehajú až pri spustení pracovného postupu, nie pri jeho načítaní, napríklad parametre, ktoré vyžaduje každý typ aktivity. Pozri Aktivity.

Píšte zodpovednosti, nie nástroje. Balík zamestnanca pomenúva schopnosti, napríklad ledger alebo mail, a nikdy nie konkrétny produkt, firmu ani odvetvie. O tom, ktorý systém naplní ktorú schopnosť, rozhoduje vlastník, takže jeden balík slúži každej firme, ktorá ho prijme.

Ďalej