Meta が 2026 年 9 月に出した個人向けエージェント Muse は、予定やできごとをきっかけに自分から動き、前の会話を覚え、大事な操作の前には承認カードで本人に確かめます。
Biz AI(Biz Assistant Framework、Apache-2.0)は、同じことを会社の業務システムの中で、職員一人ひとりの権限でやるためのオープンソースです。違いは一つ。AI は提案まで。確定・承認・金額は必ず人が決めます。(Meta とは関係ありません)
設計の考え方は Zenn に書きました:Meta Muse の「自分から動く AI エージェント」を、業務システムに
この記事は手を動かす編です。休暇申請の小さな業務システム(1 ファイル約 300 行、DB なし)を手元で動かし、AI 社員とつなぐための約束(Bridge v1)を 52 項目の適合性テストで確かめ、最後にわざとルールを破って、テストが止めてくれるところまで見ます。所要 15 分ほどです。
この記事でやること
- 例のシステムをリポジトリの外にコピーして、npm のパッケージだけで動かす
- テストを流す(業務ルール+適合性 52 項目)
- curl で「未回答の申請」を検出させ、AI 社員に渡る event を見る
- コードの中身:業務システムが書くのは何か
- わざと個人情報を event に入れて、テストが赤くなるのを見る
- 自分の業務に書き換えるときの順番
必要なもの:Node.js 22.19 以上、npm、git。
1. コピーして動かす
git clone https://github.com/ITC-cloud-soft/biz-ai.git
cp -r biz-ai/examples/leave-requests ./my-system && cd my-system
# リポジトリ内の参照(workspace:*)を、npm 公開版に差し替える
npm pkg set dependencies.@dsh-bridge/protocol=^0.1.1 dependencies.@dsh-bridge/server-kit=^0.1.1
npm install
@dsh-bridge/server-kit が、AI 社員とつなぐための共通部分(認可のゲート、チャット連携、委託、event の outbox、承認カード、提案、報告、manifest の配信)を全部持っています。業務システム側に残るのは「業務を知っているコード」だけです。
2. テストを流す
npm test
# conformance: 52 / 52 checks passed
ℹ tests 57
ℹ pass 57
ℹ fail 0
57 のうち、4 つが休暇申請の業務ルール、52 が Bridge v1 の適合性テスト、最後の 1 つが「全項目が合格し、スキップも既知の未対応もない」ことの確認です。適合性テストは、このシステムを HTTP の外側から叩いて、たとえば次のことを確かめます。
- AI 社員の委託トークンでは書き込めない(
403 delegation_not_permitted) - AI が呼べる読み取りは、manifest に書いた役割の分だけ
- 承認カードは承認できる人にだけ届き、誰かが決めたら他のカードも閉じる
- event には manifest で許可したキーしか入らず、個人情報が入っていない
- チャット連携のコードは発行した本人にしか結び付かない、使い回せない、総当たりは止まる
3. 動かして、event を見る
npm start # http://127.0.0.1:19750
架空の職員 4 人(admin / manager / staff1 / staff2、パスワード leave-dev)と、3 日間決まっていない休暇申請が 1 件入った状態で起動します。別のターミナルで:
# 責任者としてログイン
curl -c jar -H 'content-type: application/json' \
-d '{"loginId":"manager","password":"leave-dev"}' http://127.0.0.1:19750/api/auth/login
# 「2 日以上決まっていない申請」を探す(本物のシステムではスケジューラが回す)
curl -b jar -H 'content-type: application/json' -d '{}' http://127.0.0.1:19750/api/admin/unanswered-scan
# AI 社員の側から event を読む(サービストークン)
curl -H 'x-service-token: leave-dev-service-token-000000000000' \
'http://127.0.0.1:19750/bridge/v1/events?after=0'
leave.unanswered という event が出てきます。payload は leaveRequestId・requesterUserId・startsOn・daysWaiting の 4 つだけ。名前は入っていません。 誰に知らせるか(申請した本人と責任者)も、この業務システムが答えます。AI 社員はそれを受けて、チャットをつないだ人に「休暇申請が 3 日決まっていません」と知らせます(責任者への承認カードは、申請された時点で approval.requested からもう届いています)。
4. 業務システムが書くのは何か
src/app.mjs は 4 つの部分でできています。
| 部分 | 中身 |
|---|---|
| データとログイン | 素の Map、パスワードのハッシュ、セッション(キットはパスワードを見ない) |
| hooks |
employees(誰がいて、どの役割か)、authenticate / isSessionLive、recipientsFor(誰に知らせるか)、approvals(誰が決めるか、カードに何を出すか、決定をどう反映するか)、proposalKinds(AI が何を提案してよいか)、reports、piiScan
|
| Web API | AI が呼べる読み取りは kit.readToolPolicy を通す。書き込みは人だけ |
| 業務の変更+event |
kit.tx と kit.emitEvent を同じトランザクションで |
たとえば「誰に知らせるか」はこう書きます。
recipientsFor: async (event) => {
if (event.type !== 'leave.unanswered') return null
const l = data.leave.get(event.payload.leaveRequestId)
if (!l) return { stale: 'deleted' }
if (l.status !== 'pending') return { stale: 'decided' } // もう決まっていたら知らせない
const users = [...data.users.values()]
.filter((u) => u.active && (MANAGERS.includes(u.role) || u.id === l.requesterUserId))
.map(employee)
return { users, dedupeKey: `leave.unanswered:${l.id}`, /* … */ }
}
宛先を AI が推測することはありません。業務システムの画面と同じ判定で、業務システムが答えます。
5. わざとルールを破ってみる
event に申請者の名前を足してみます(src/app.mjs の scanUnanswered)。
- payload: { leaveRequestId: l.id, requesterUserId: l.requesterUserId, startsOn: l.startsOn, daysWaiting: daysSince(l.createdAt) },
+ payload: { leaveRequestId: l.id, requesterUserId: l.requesterUserId, requesterName: data.users.get(l.requesterUserId)?.displayName, startsOn: l.startsOn, daysWaiting: daysSince(l.createdAt) },
npm test
✖ the unanswered scan tells the requester and the managers, once, with numbers and dates only
✖ E2 every event is declared in the manifest, carries only its whitelisted payload keys and no personal data
✖ leave-requests passes EVERY conformance check: no failure, no skip, no known gap
ℹ pass 51
ℹ fail 6
requesterName は manifest の許可リスト(payload: [leaveRequestId, requesterUserId, startsOn, daysWaiting])にないので、kit.emitEvent が書き込みを拒否し、スキャンは失敗します。個人情報が AI 側へ流れる前に、テストが止めてくれるわけです。元に戻せば 57 / 57 に戻ります。
6. 自分の業務に書き換える順番
-
bridge.manifest.yamlを書き換える:システム名、役割、event と payload の許可リスト、メッセージの雛形、AI が呼べる tools、承認の対象、報告。npm run validateで確かめる -
src/app.mjsのデータと Web API を自分の業務にする - hooks を自分の業務の判定にする(とくに
recipientsForとapprovals) - Map を自分のテーブルに、メモリストアを
createPostgresStore/createMysqlStore(TiDB も可)に -
ずっと
npm testを緑のまま進める
既存のシステムに足す場合は、同梱の導入 skill(docs/skill/biz-assistant-integration)を Claude Code などのコーディングエージェントに読ませると、診断 → 計画 → 実装 → 検証の順に進めてくれます。
AI 社員の側
ここまでは業務システム側だけです。AI 社員として実際にチャットで話させるには、AI 面(Biz AI のプラグインを入れたエージェント実行環境、モデルの鍵、チャットのボット)が要ります。API キー無しで全体を見たいときは、リポジトリのルートで:
pnpm install
pnpm demo # 本物のエージェント実行環境 + 台本どおりに答えるモデル + モックの LINE + Docker の使い捨て PostgreSQL
設備点検の例で、AI 社員が期限切れに気づき、点検員に頼み、修理依頼を承認カードで回し、ワンタップで業務システムに記録されるまでが会話として出てきます。