NeboAI
NeboAI
Zacznij

Pakiety pracowników

Pakiet pracownika opisuje rolę, na którą firma może kogoś zatrudnić: za co pracownik odpowiada, jak pracuje, jakich systemów potrzebuje i co robi samodzielnie. Zapisujesz go jako folder z plikiem AGENT.md, a gdy rola potrzebuje czegoś więcej niż czat — także z plikiem agent.json.

Pakiet

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
PlikWymaganyPrzeznaczenie
AGENT.mdtakPersona: kim jest pracownik, jak pracuje i jakie ma zasady. Zobacz Persona i pamięć.
agent.jsonnieWymagane funkcje, pytania do właściciela, przepływy pracy, ustawienia pamięci i limity zatwierdzeń. Zobacz Dokumentacja agent.json.
skills/nieUmiejętności w standardowym formacie SKILL.md. Widzi je tylko ten pracownik.
manifest.jsontylko aplikacjeTożsamość z "type": "app". Sklep zapisuje własny manifest, gdy pakuje pracownika.
ui/tylko aplikacjeStrona aplikacji. Zobacz Aplikacje.

Napisz pakiet

Zacznij od persony. Nagłówek (frontmatter) nadaje pracownikowi nazwę i jednowierszowy opis; treść to instrukcje pisane zwykłą prozą.

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

Dodaj agent.json, gdy rola potrzebuje systemu, ustawienia od właściciela albo pracy wykonywanej bez proszenia. Ten przykład wymaga funkcji mail, zadaje jedno pytanie przy zatrudnieniu i odpowiada na każdą nową wiadomość, gdy tylko przyjdzie.

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

Obserwacja wskazuje funkcję mail, a nie produkt. W trakcie działania jest ona przypisywana do wtyczki, którą właściciel podłączył do poczty. Wyzwalacze i aktywności opisuje strona Przepływy pracy.

Załaduj go na bota

Umieść folder w <data>/user/agents/<name>/. Nebo obserwuje AGENT.md, agent.json i manifest.json i przeładowuje pracownika mniej więcej sekundę po zmianie. Usunięcie folderu wyłącza pracownika, ale zachowuje jego rekord.

Nebo ładuje pracowników z trzech źródeł, a późniejsze mają pierwszeństwo: pracownicy wbudowani w Nebo, zapieczętowane pakiety ze sklepu w <data>/nebo/agents/ oraz foldery w <data>/user/agents/. Pracownik może też utworzyć lub zmienić pakiet za Ciebie narzędziami create_employee i update_employee, które zapisują ten sam folder.

Co się dzieje przy zatrudnieniu

Gdy właściciel zatrudnia Twojego pracownika ze sklepu lub kodem AGNT-, Nebo:

  1. Odczytuje potrzeby pakietu bez pytania modelu: każdą funkcję z requires.interfaces, każdą wtyczkę z requires.plugins oraz każdą funkcję lub wtyczkę wskazaną przez wyzwalacz obserwacji.
  2. Pokazuje właścicielowi jedno zdanie z prośbą o zgodę na te potrzeby i przy zatrudnieniu przyznaje je temu pracownikowi jako stałe uprawnienia. Operacje wymagające zatwierdzenia nadal go wymagają. Zobacz Funkcje i zatwierdzenia.
  3. Instaluje zależności: wtyczki z requires.plugins, umiejętności ze sklepu wymienione w skills i w aktywnościach oraz zależności zadeklarowane przy publikacji pakietu.
  4. Zadaje właścicielowi pytania z inputs i informuje go przez Skrzynkę odbiorczą o każdej funkcji, która nie ma jeszcze połączenia.

Przepływ pracy, którego funkcja nie ma połączenia, zostaje zachowany i oznaczony jako ograniczony, z podaniem powodu. Zaczyna działać, gdy tylko właściciel podłączy system.

Co sprawdza Nebo

Nebo odczytuje agent.json łagodnie. Nieznane klucze są ignorowane. Przepływ pracy niezgodny ze schematem jest pomijany, a właściciel dostaje w Skrzynce odbiorczej informację, że nie zostanie uruchomiony; reszta pracownika i tak się ładuje. Te problemy powodują odrzucenie całego pliku:

  • Wyzwalacz event z pustą listą sources.
  • Dwie aktywności z tym samym id w jednym przepływie pracy.
  • Dane wejściowe z scope innym niż company lub seat albo pytanie o kwotę z wartością domyślną.
  • Wartość ceiling inna niż "approval".
  • Drzewo połączeń telefonicznych, które nie ma dokładnie jednego powitania i co najmniej jednej nazwanej intencji.

Niektóre sprawdzenia odbywają się przy starcie przepływu pracy, a nie przy jego ładowaniu, na przykład parametry wymagane przez każdy typ aktywności. Zobacz Aktywności.

Opisuj obowiązki, nie narzędzia. Pakiet pracownika wskazuje funkcje, takie jak ledger czy mail, a nigdy konkretny produkt, firmę ani branżę. To właściciel decyduje, który system pełni każdą funkcję, więc jeden pakiet służy każdej firmie, która go zatrudni.

Dalej