例
{
"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." }
]
}
}
} フィールド
| フィールド | 種類 | 意味 |
|---|---|---|
requires.interfaces | 文字列のリスト | 役割に必要な機能(mailやledgerなど)。雇用時に付与されます。承認が必要な操作は、それぞれ承認項目のままです。「機能と承認」を参照してください。 |
requires.plugins | 文字列のリスト | 社員と一緒にインストールされるプラグイン。役割が本当に1つのプラグインに依存する場合にだけ使い、できるだけ機能を指定してください。 |
requires.tools | 文字列のリスト | 社員のセッションに最初のターンから読み込まれるツール。これで承認が省略されることはありません。 |
skills | 文字列のリスト | インストールして使うマーケットプレイスのスキル: @org/skills/name(任意で@version)、またはSKIL-コード。パッケージ自身のskills/フォルダにあるスキルは記載不要です。 |
inputs | list | 雇用時にオーナーが答える質問。「入力」を参照してください。 |
memory | object | 会話とメモリの保ち方。「ペルソナとメモリ」を参照してください。 |
subscribes | 文字列のリスト | 変更があったときに社員が読み直す会社の情報領域(finance.ar.*など)。 |
ceiling | map | 操作から"approval"への対応。その操作は、この社員については常にオーナーに確認します。他の値は受け付けません。 |
workflows | map | ワークフロー名からワークフローへの対応。「ワークフロー」を参照してください。 |
tools | list | アプリのサイドカーが提供するHTTPツール。「サイドカーツール」を参照してください。 |
scopes | map | tools、skills、pluginsの名前付きグループ。スコープが有効なとき、そのスコープのpluginsが社員に説明されます。 |
入力
入力とは、オーナーが採用時に答える質問です。回答は「Configured Inputs」の下に社員向けに表示され、監視トリガーとフォルダートリガーの {{key}} プレースホルダーに入ります。
{
"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"
} | フィールド | デフォルト | 意味 |
|---|---|---|
key | 必須 | プレースホルダーで使う名前。代わりにnameも受け付けます。 |
label | keyから | オーナーに表示される質問。 |
type | text | text、textarea、number、select、checkbox、radioのいずれか。 |
required | false | オーナーが必ず答える質問であることを示します。 |
default | なし | あらかじめ入力された回答。金額の質問には使えません。 |
placeholder, description | なし | ヘルプテキスト。 |
options | なし | selectとradio用: {value, label}オブジェクト、またはただの文字列。 |
id | なし | その情報を表す、安定したドット区切りの名前(finance.ap.invoice_mailboxなど)。他の社員と共有できます。 |
scope | company | company: 会社で共有される情報。seat: この雇用だけ。 |
missing | なし | 質問が未回答の間に社員がすること。 |
money | false | 金額であることを示します。金額の質問にはデフォルト値を設定できません。 |
サイドカーツール
サイドカーを持つアプリは、HTTPエンドポイントをツールとして社員に公開します。Neboは各エントリーをapp__<app>__<name>として登録し、呼び出しをmethodとpathでサイドカーに送ります。アプリのサイドカーをご覧ください。
"tools": [
{
"name": "list_entries",
"description": "List journal entries for a date range.",
"method": "GET",
"path": "/entries",
"input_schema": { "type": "object", "properties": { "from": { "type": "string" } } }
}
] ワークフロー
workflowsの下の各キーが1つのワークフローを表し、その名前が識別子になります。完全な形式はワークフロー、トリガー、アクティビティにあります。