AGENT.md
AGENT.mdは普通のMarkdownです。社員の名前と1行の説明を書いたフロントマターから始めます。マーケットプレイスとオーナーのワークフォースはその両方を使います。続いて、ペルソナを二人称で書きます。社員の責任、働き方、そのルールです。
--- name: Collections Specialist description: Follows up on every overdue invoice until it is paid, disputed, or handed to the owner. --- # Collections Specialist You keep receivables moving. Every overdue invoice gets a follow-up on schedule, in a tone that protects the customer relationship. ## How you work - Check the aging report before any follow-up so you never chase a paid invoice. - Escalate to the owner when a customer disputes an amount. ## Rules - Never threaten, and never mention collections agencies. - Never agree to a payment plan; propose it to the owner.
Neboは各セッションの開始時に、ペルソナを社員に渡します。名前、説明、フロントマターのトリガー、そしてオーナーがNeboで設定した性格、ルール、ソウルも一緒です。ペルソナはその社員だけのもので、他の社員と共有するプロンプトに追加されることはありません。
役割が何に責任を持ち、どう判断するかを書きましょう。ツール名や製品名は書かないでください。社員のツールは機能と接続から決まり、同じペルソナが、それを雇うすべての会社で機能する必要があるからです。
メモリ
どの社員もオーナー自身の情報を読み、書き込むのは自分のメモリだけです。メモリはremember、recall、forgetツールで扱います。会話とメモリの保ち方は、agent.jsonのmemory.modeで選びます。
| モード | 動作 | 用途 |
|---|---|---|
single | 続いていく1つの会話と1つのメモリ。デフォルトです。 | ほとんどの役割。 |
separate | 多くの会話が社員のプライベートなメモリを共有します。電話をかけてきた人や訪問者など、オーナー以外の人との会話は、それぞれ封印された専用のメモリを持ちます。 | 多くの人と話す役割。 |
confidential | 会話ごとに封印された案件になります。ある会話で学んだことは、オーナーの会話も含め、他の会話からは見えません。 | 互いに切り離しておく必要があるクライアントの案件。 |
"memory": {
"mode": "separate",
"topics": [
{ "slug": "account", "description": "A customer account: balance, promises to pay, contacts, disputes" }
],
"write_bar": ["web", "external-email"],
"share_with": []
} | フィールド | 意味 |
|---|---|
mode | single、separate、confidentialのいずれか。古いcontext_isolated: trueはseparateとして読み込まれます。 |
topics | 何を覚えておくべきかを社員に伝える、最大8つの{slug, description}のペア。スラッグは小文字とハイフンで、説明は1〜120文字です。予約済みのスラッグ: tacit、entity、daily、project、memory、style、artifact。 |
write_bar | 次のソースからの内容を取り込んだ実行は、メモリに書き込めません: web、external-email、channel、document、phone、coworker。省略した場合、separateとconfidentialモードではchannelとphoneが禁止されます。空のリストにすると禁止が解除されます。 |
share_with | この社員からの返信で、この社員のメモリを受け取ることを許可された社員のID、または*。デフォルトは空で、何も共有しません。 |
会社レイヤー
会社レイヤーは、すべての社員が共有する知識です。会社の用語、取引相手、ルール、法令と基準、参考資料です。これはボット上のパックに入っています。パックとは、INDUSTRY.md、FRANCHISE.md、COMPANY.mdのいずれか1つのマーカーファイルと、その横に置かれた種類別のフォルダからなるフォルダです。レイヤー同士で食い違う場合は、会社がフランチャイズより、フランチャイズが業種より優先されます。
<data>/packs/example-co/ ├── COMPANY.md ├── vocabulary/ ├── parties/ ├── rules/ ├── laws/ │ └── refunds.md ├── standards/ ├── workflows/ └── reference/
フォルダ内のファイルはすべて、任意のフロントマター付きのMarkdownです。フロントマターは構造を持ちます。たとえば、ルールのalways、基準のidとvalue、法令のceilingです。本文には文章が入ります。パックに入れるのは知識であって手順ではないため、スキルを含むパックは拒否されます。
法令
法令のceilingには、どの社員も実行してはならない操作を列挙します。会社レイヤーでは、reserved_to: ownerによってこれが変わります。その操作は可能なままですが、オーナー自身の承認があるときに限られ、その承認を他に譲ることは決してできません。
--- ceiling: [ledger.refund.create] reserved_to: owner --- Refunds are issued only by the owner. Employees may prepare a refund and send it to the owner for approval.
社員がレイヤーを学ぶ仕組み
社員は、作業中にレイヤーを調べたりはしません。レイヤーが変わると、各社員はその変更を一度読み、自分のルールを書き直します。オーナーはCOMPANY.mdとすべての会社フォルダをいつでも編集できます。変更を保存することが、オーナーが何を事実とするかを示す方法です。