パッケージ
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 | ファイル | 必須 | 目的 |
|---|---|---|
AGENT.md | はい | ペルソナ: 社員が何者か、どう働くか、そのルール。「ペルソナとメモリ」を参照してください。 |
agent.json | いいえ | 必要な機能、オーナーへの質問、ワークフロー、メモリの設定、承認の上限。「agent.jsonリファレンス」を参照してください。 |
skills/ | いいえ | 標準のSKILL.md形式のスキル。この社員だけが参照できます。 |
manifest.json | アプリのみ | "type": "app"を持つ身元情報。マーケットプレイスは社員をパッケージするとき、独自のマニフェストを書き込みます。 |
ui/ | アプリのみ | アプリのページ。「アプリ」を参照してください。 |
パッケージを書く
まずはペルソナから。フロントマターで社員に名前を付けて1行の説明を書き、本文には平易な文章で指示を書きます。
--- 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.
役割にシステムやオーナーからの設定が必要な場合、または頼まれなくてもこなす仕事がある場合は、agent.jsonを追加します。この例では、mail機能を必要とし、雇用時に1つ質問し、新しいメッセージが届くたびに返信します。
{
"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."
}
]
}
}
} ウォッチが指定しているのは製品ではなく、mailという機能です。実行時には、オーナーがメール用につないだプラグインに解決されます。トリガーとアクティビティについてはワークフローをご覧ください。
ボットに読み込む
フォルダを<data>/user/agents/<name>/に置きます。NeboはAGENT.md、agent.json、manifest.jsonを監視しており、変更から約1秒後に社員を再読み込みします。フォルダを削除すると社員は無効になりますが、記録は残ります。
Neboは3つのソースから社員を読み込み、後のソースが優先されます。Neboに組み込まれた社員、<data>/nebo/agents/にある封印されたマーケットプレイスのパッケージ、そして<data>/user/agents/にあるフォルダです。社員はcreate_employeeツールとupdate_employeeツールを使って、あなたの代わりにパッケージを作成・変更することもできます。どちらも同じフォルダに書き込みます。
雇用時に起きること
オーナーがマーケットプレイスから、またはAGNT-コードであなたの社員を雇うと、Neboは次のことを行います:
- モデルに問い合わせずにパッケージの要件を読み取ります。
requires.interfacesにあるすべての機能、requires.pluginsにあるすべてのプラグイン、そしてウォッチトリガーが指定するすべての機能またはプラグインです。 - それらの要件について1文の同意文をオーナーに示し、雇用時にこの社員への常設の権限として付与します。承認が必要な操作は、承認が必要なままです。機能と承認をご覧ください。
- 依存関係をインストールします。
requires.pluginsのプラグイン、skillsとアクティビティで指定されたマーケットプレイスのスキル、そしてパッケージの公開時に宣言された依存関係です。 inputsの質問をオーナーに尋ね、まだ接続のない機能があれば受信トレイでオーナーに知らせます。
機能に接続がないワークフローは残され、理由とともに機能低下として表示されます。オーナーがシステムをつなぐとすぐに動き始めます。
Neboがチェックする内容
Neboはagent.jsonを寛容に読み込みます。未知のキーは無視されます。スキーマに合わないワークフローはスキップされ、実行されない旨の通知がオーナーの受信トレイに届きますが、社員の残りの部分は読み込まれます。次の問題があると、ファイル全体が拒否されます:
sourcesリストが空のeventトリガー。- 1つのワークフロー内で同じ
idを持つ2つのアクティビティ。 scopeがcompanyでもseatでもない入力、またはデフォルト値を持つ金額の質問。"approval"以外のceiling値。- あいさつがちょうど1つ、名前付きの意図が1つ以上、という条件を満たさない電話の応答ツリー。
一部のチェックは、読み込み時ではなくワークフローの開始時に行われます。たとえば、各アクティビティの種類に必要なパラメーターです。アクティビティをご覧ください。
ツールではなく、責任を書きましょう。社員パッケージが指定するのはledgerやmailのような機能であり、特定の製品、会社、業種を指定することはありません。各機能をどのシステムで満たすかはオーナーが決めるので、1つのパッケージで、それを雇うすべての会社に対応できます。
次へ
- agent.jsonリファレンス
- ペルソナとメモリ
- 公開: 社員をマーケットプレイスに出す。