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 | Plik | Wymagany | Przeznaczenie |
|---|---|---|
AGENT.md | tak | Persona: kim jest pracownik, jak pracuje i jakie ma zasady. Zobacz Persona i pamięć. |
agent.json | nie | Wymagane funkcje, pytania do właściciela, przepływy pracy, ustawienia pamięci i limity zatwierdzeń. Zobacz Dokumentacja agent.json. |
skills/ | nie | Umiejętności w standardowym formacie SKILL.md. Widzi je tylko ten pracownik. |
manifest.json | tylko aplikacje | Tożsamość z "type": "app". Sklep zapisuje własny manifest, gdy pakuje pracownika. |
ui/ | tylko aplikacje | Strona 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:
- Odczytuje potrzeby pakietu bez pytania modelu: każdą funkcję z
requires.interfaces, każdą wtyczkę zrequires.pluginsoraz każdą funkcję lub wtyczkę wskazaną przez wyzwalacz obserwacji. - 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.
- Instaluje zależności: wtyczki z
requires.plugins, umiejętności ze sklepu wymienione wskillsi w aktywnościach oraz zależności zadeklarowane przy publikacji pakietu. - Zadaje właścicielowi pytania z
inputsi 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
eventz pustą listąsources. - Dwie aktywności z tym samym
idw jednym przepływie pracy. - Dane wejściowe z
scopeinnym niżcompanylubseatalbo pytanie o kwotę z wartością domyślną. - Wartość
ceilinginna 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
- Dokumentacja agent.json
- Persona i pamięć
- Publikowanie: umieść pracownika w sklepie.