Przykład
{
"requires": {
"interfaces": ["ledger", "mail"],
"plugins": [],
"tools": []
},
"skills": ["@example/skills/receipt-capture"],
"inputs": [
{
"key": "invoice_mailbox",
"label": "Mailbox that receives vendor invoices",
"type": "text",
"id": "finance.ap.invoice_mailbox",
"scope": "company",
"required": true,
"missing": "Ask the owner which mailbox to watch before processing invoices."
}
],
"memory": {
"mode": "separate",
"topics": [
{ "slug": "vendor", "description": "A supplier: terms, usual amounts, contacts, open disputes" }
]
},
"subscribes": ["finance.ap.*"],
"ceiling": { "ledger.bill.create": "approval" },
"workflows": {
"invoice-intake": {
"trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
"activities": [
{ "id": "record", "intent": "If the message in _watch_payload is a vendor invoice, record it as a bill." }
]
}
}
} Pola
| Pole | Typ | Znaczenie |
|---|---|---|
requires.interfaces | lista ciągów znaków | Funkcje potrzebne roli, takie jak mail czy ledger. Przyznawane przy zatrudnieniu; każda operacja wymagająca zatwierdzenia nadal pozostaje pozycją do zatwierdzenia. Zobacz Funkcje i zatwierdzenia. |
requires.plugins | lista ciągów znaków | Wtyczki instalowane razem z pracownikiem. Używaj tylko wtedy, gdy rola naprawdę zależy od jednej wtyczki; lepiej wskazać funkcję. |
requires.tools | lista ciągów znaków | Narzędzia ładowane do sesji pracownika od pierwszej tury. Nigdy nie pomija to zatwierdzania. |
skills | lista ciągów znaków | Umiejętności ze sklepu do zainstalowania i używania: @org/skills/name, opcjonalnie z @version, albo kod SKIL-. Umiejętności z własnego folderu skills/ pakietu nie wymagają wpisu. |
inputs | list | Pytania, na które właściciel odpowiada przy zatrudnieniu. Zobacz Dane wejściowe. |
memory | object | Jak przechowywane są rozmowy i pamięć. Zobacz Persona i pamięć. |
subscribes | lista ciągów znaków | Obszary faktów firmowych, które pracownik odczytuje ponownie, gdy się zmienią, np. finance.ar.*. |
ceiling | map | Operacja → "approval". Ta operacja zawsze wymaga zgody właściciela dla tego pracownika. Żadna inna wartość nie jest akceptowana. |
workflows | map | Nazwa przepływu pracy → przepływ pracy. Zobacz Przepływy pracy. |
tools | list | Narzędzia HTTP serwowane przez sidecar aplikacji. Zobacz Narzędzia sidecar. |
scopes | map | Nazwane grupy tools, skills i plugins. Wtyczki (plugins) danego zakresu są opisywane pracownikowi, gdy ten zakres jest aktywny. |
Dane wejściowe
Pole wejściowe to pytanie, na które właściciel odpowiada przy zatrudnianiu. Odpowiedzi są widoczne dla pracownika w sekcji „Configured Inputs” i wypełniają symbole zastępcze {{key}} w wyzwalaczach obserwowania i folderów.
{
"key": "close_day",
"label": "Business day to finish the close",
"type": "select",
"options": [
{ "value": "3", "label": "Third business day" },
{ "value": "5", "label": "Fifth business day" }
],
"default": "5",
"scope": "company",
"id": "finance.close.day"
} | Pole | Domyślnie | Znaczenie |
|---|---|---|
key | wymagane | Nazwa używana w symbolach zastępczych. name jest akceptowane jako zamiennik. |
label | z key | Pytanie wyświetlane właścicielowi. |
type | text | text, textarea, number, select, checkbox lub radio. |
required | false | Oznacza pytanie, na które właściciel musi odpowiedzieć. |
default | brak | Wstępnie wypełniona odpowiedź. Niedozwolona przy pytaniu o kwotę. |
placeholder, description | brak | Tekst pomocy. |
options | brak | Dla select i radio: obiekty {value, label} lub zwykłe ciągi znaków. |
id | brak | Stała nazwa faktu z kropkami, np. finance.ap.invoice_mailbox, aby inni pracownicy mogli z niego korzystać. |
scope | company | company: wspólny fakt firmowy. seat: tylko to zatrudnienie. |
missing | brak | Co pracownik robi, dopóki pytanie nie ma odpowiedzi. |
money | false | Oznacza kwotę pieniędzy. Pytanie o kwotę nie może mieć wartości domyślnej. |
Narzędzia sidecar
Aplikacja z sidecarem udostępnia swojemu pracownikowi punkty końcowe HTTP jako narzędzia. Nebo rejestruje każdy wpis jako app__<app>__<name> i wysyła wywołania do sidecara pod method i path. Zobacz Sidecar aplikacji.
"tools": [
{
"name": "list_entries",
"description": "List journal entries for a date range.",
"method": "GET",
"path": "/entries",
"input_schema": { "type": "object", "properties": { "from": { "type": "string" } } }
}
] Przepływy pracy
Każdy klucz w workflows nazywa jeden przepływ pracy; nazwa jest jego identyfikatorem. Pełny format opisują strony Przepływy pracy, Wyzwalacze i Aktywności.