hoanganh8389/bizcity-twin-ai

Make WordPress as an AI operating system, every plugin becomes an agentic tool The "online Claude" vision — natural language → classify → plan → multi-step execution across plugins, zero config

Bizcity Twin AI – WordPressベースのAI「デジタルツイン」プラットフォーム

すべてのチャネルに一つの脳 – このプロジェクトはWordPressサイトを、企業向けの統合的でAI対応の知識ハブに変換します。Facebook、Zalo、メール、ウェブチャット、Telegram、TikTokなど、さまざまな通信チャネルからのデータを受信し、知識グラフ（KG）ハブを構築し、マネージドコントロールプレーン（MCP） を通じて大規模言語モデルアシスタント（Claude、ChatGPTなど）にデータを公開します。コア機能は共有される「脳」（ID管理、KG、記憶、推論、ログ、自動化、権限）を提供します。機能は、ドメイン固有のアクション、新しいチャネルアダプタ、またはUIビューを追加するプラグインによって拡張され、コアコードを変更せずに実現されます。

機能概要

分野	コアが提供するもの	プラグインによる拡張方法
チャネルゲートウェイ	入出力メッセージを標準化し、テナント全体のIDに紐付け、CRMまたは推論エンジンにルーティング。	`channel`プラグインで新しいソース（例：TikTokのWebhook）やカスタムルーティングルールを追加。
TwinCRM	統合受信トレイ、連絡先、会話、キャンペーンレポート。	`act`プラグインで注文作成、レコード更新、通知送信などを実行。
TwinBrain / MPR	各ターンごとの多段階推論、ツール選択およびオーケストレーション。	`act`プラグインが型付きツール（例："create-invoice"）を公開し、脳が呼び出せるようにする。
KGハブ	エンティティ、文章、出典を保存し、引用付きのグラフ検索を提供。	`source`プラグインで新規ドキュメント（製品カタログ、法的文書、POSログ）をKGに供給。
自動化＆スケジューラ	ユーザーが設定可能なワークフロー（トリガー、条件、アクション）と承認ゲート。	`act`/`view`プラグインがワークフローで使用される具体的なアクションを提供。
MCP	ポリシー駆動型API。外部LLM（Claude、ChatGPT）がKGを照会したり、ツールを呼び出したりする際の厳格なアクセス制御を実現。	プラグインが同じポリシー層を尊重する追加エンドポイントを公開可能。
TwinShell / Twin GPT	組み込みチャットUI（`/gpt/`）と内部ユーザー用の管理コンソール。	`view`プラグインでダッシュボード、レポート、カスタム管理ページを追加。

キーとなるコンセプト（「三軸」アーキテクチャ）

水平軸 – チャネルゲートウェイ – すべての外部チャネルから生のメッセージを収集し、共通のデータパッケージに標準化。
垂直軸 – 特化プラグイン – 各プラグインがドメイン（営業、財務、法務、コンテンツなど）を提供し、コアサービスの重複を回避。
知識グラフレイヤー – すべての事実を出典付きで保存する単一のKGハブ。脳は証拠に基づいた回答を得るためにこれを照会する。

一般的なユースケース

ユースケース	フロー（簡略化）
マルチチャネル営業アシスタント	顧客メッセージ → チャネルゲートウェイ → TwinCRM受信トレイ → KG（製品＋顧客コンテキスト） → TwinBrainが返信ツールを選択 → （オプション）人間による承認 → 同じチャネル経由で応答を送信。
顧客インサイトダッシュボード	CRM/POSからの定期的ETL → `source`プラグインが文章をKGにプッシュ → アナリティクスツールが引用付きでKGを読み取り → `view`プラグインが信頼度スコア付きのインサイトをダッシュボード表示。
内部オペレーションボット（Telegram/Zalo）	管理者コマンド → チャネルゲートウェイ（ゾーン2） → ID確認 → TwinBrainがワークフロー（例：レポート生成、CI起動）を実行 → 結果をボットに返信。
TikTok向けコンテンツ作成	テンダーリサーチ → KGベースの取得 → 動画生成ツール → 承認ステップ → TikTok公開アダプタ（新規`channel`プラグイン）。

技術スタック

コンポーネント	技術
プラットフォーム	WordPress ≥ 6.0（PHP 7.4+） – コアは通常のWPプラグインなので、任意のWPホストで動作可能。
コア言語	PHP（オブジェクト指向、Composerによる依存関係管理）。
知識グラフ	WPデータベースに保存。文章は高速なベクトル/グラフ検索用にインデックス化（プラットフォームがインデックスと取得APIを提供）。
LLM統合	MCPがプロバイダを抽象化。組み込みクライアントクラスがHTTP経由でClaude、OpenAI ChatGPTなどと通信。
CLI / スケルトン	WP-CLIコマンド（`wp bizcity make:*`, `wp bizcity health`, `wp bizcity plugin lint`）。
ログ＆監査	中央の`bizcity_log_index`を持つJSONLファイル。ログには出典は含まれるが、生のシークレットやPIIは含まれない。
自動化	コアに組み込まれたDAGベースのワークフロー・エンジン。プラグインが入力・出力・恒等性・再試行ポリシーを宣言するブロックを提供。

プロジェクトの健全性と成熟度

バージョン: 1.3.7（バッジに表示）。
ライセンス: GPL-2.0-or-later – 完全にオープンソース。
ドキュメント: 詳細な開発者ガイド（docs/vibe/README.md）、貢献ガイド、および公開された開発チェックリスト。
デモインスタンス: 管理コンソール、GPT UI、CRM用のライブデモサイトが提供されています（libedemo.bizcity.vn）。
テスト: 組み込みのLint（wp bizcity plugin lint）、診断ツール、および「プローブ」コマンド（プラグインを狭いサンドボックスで実行し契約を検証）。
ロードマップ: コアからより多くの特化機能を分離する作業を継続中。選択的KGインジェストの改善、TikTok顧客メッセージアダプタの完成も進行中。

クイックスタート（初期設定手順）

# 1. WordPressサイトにインストール（6.0+ かつ PHP 7.4+ 必須）
cd wp-content/plugins
git clone https://github.com/hoanganh8389/bizcity-twin-ai.git
cd bizcity-twin-ai
composer install   # PHP依存関係を取得
wp plugin activate bizcity-twin-ai

# 2. WP管理パネルでLLM/APIキーを設定（BizCity AI → LLM設定）。

# 3. インストールを確認
wp bizcity health --format=json   # ヘルスチェック
wp bizcity sdk-check --format=json # コアSDK互換性チェック

# 4. 新しいプラグインのスケルトン作成（例：顧客インサイト）
wp bizcity make:plugin customer-insight --name="Customer Insight"
wp bizcity make:source crm --plugin=customer-insight
wp bizcity make:tool analyze-customer --plugin=customer-insight
wp bizcity make:event insight-created --plugin=customer-insight
wp bizcity make:diagnostic runtime --plugin=customer-insight

# 5. 生成されたTODOをビジネスロジックで埋め、LintとProbeを実行
wp bizcity plugin lint customer-insight --json --strict
wp bizcity probe --id=plugins.customer_insight.runtime --format=json

スケルトンはマニフェスト、型付き契約、診断、アンインストールガードを生成するため、開発者はドメイン固有のコードのみ実装すればよい。

どのような人・組織が使うべきか？

すでにWordPressを運用している中小企業や中堅企業で、営業、サポート、内部オペレーション向けの単一で監査可能なAI「脳」を求める人。
カスタムAI強化CRMを開発する開発者 – コアのKG、推論、セキュリティ層を再利用しながらドメインプラグインに集中できる。
外部LLMに内部データを公開する際、厳格な出典（グラフ引用、JSONL監査）を必要とするAIオペレーションチーム。

まとめ

Bizcity Twin AIは、マルチチャネルデータインジェスト、知識グラフベースの検索、LLM駆動の推論、プラグイン優先の拡張性をWordPress上に統合した本格的なオープンソースプラットフォームです。企業の「デジタルツイン」として位置づけられ、開発者がデータガバナンスと監査可能性を制御したまま、AI駆動のCRM、営業、サポート、自動化ツールを構築できるよう支援します。