NeboAI
NeboAI
はじめる

社員パッケージ

社員パッケージは、会社が雇える役割を記述したものです。その社員が何に責任を持ち、どう働き、どんな種類のシステムを必要とし、自分から何をするかを表します。AGENT.mdと、役割にチャット以上のものが必要な場合はagent.jsonを含むフォルダとして書きます。

パッケージ

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は次のことを行います:

  1. モデルに問い合わせずにパッケージの要件を読み取ります。requires.interfacesにあるすべての機能、requires.pluginsにあるすべてのプラグイン、そしてウォッチトリガーが指定するすべての機能またはプラグインです。
  2. それらの要件について1文の同意文をオーナーに示し、雇用時にこの社員への常設の権限として付与します。承認が必要な操作は、承認が必要なままです。機能と承認をご覧ください。
  3. 依存関係をインストールします。requires.pluginsのプラグイン、skillsとアクティビティで指定されたマーケットプレイスのスキル、そしてパッケージの公開時に宣言された依存関係です。
  4. inputsの質問をオーナーに尋ね、まだ接続のない機能があれば受信トレイでオーナーに知らせます。

機能に接続がないワークフローは残され、理由とともに機能低下として表示されます。オーナーがシステムをつなぐとすぐに動き始めます。

Neboがチェックする内容

Neboはagent.jsonを寛容に読み込みます。未知のキーは無視されます。スキーマに合わないワークフローはスキップされ、実行されない旨の通知がオーナーの受信トレイに届きますが、社員の残りの部分は読み込まれます。次の問題があると、ファイル全体が拒否されます:

  • sourcesリストが空のeventトリガー。
  • 1つのワークフロー内で同じidを持つ2つのアクティビティ。
  • scopeがcompanyでもseatでもない入力、またはデフォルト値を持つ金額の質問。
  • "approval"以外のceiling値。
  • あいさつがちょうど1つ、名前付きの意図が1つ以上、という条件を満たさない電話の応答ツリー。

一部のチェックは、読み込み時ではなくワークフローの開始時に行われます。たとえば、各アクティビティの種類に必要なパラメーターです。アクティビティをご覧ください。

ツールではなく、責任を書きましょう。社員パッケージが指定するのはledgerやmailのような機能であり、特定の製品、会社、業種を指定することはありません。各機能をどのシステムで満たすかはオーナーが決めるので、1つのパッケージで、それを雇うすべての会社に対応できます。

次へ