ProcureFlow Agent

DeepAgents / LangGraph に基づくマルチエージェントスマート調達システム。調達分析、注文実行、ERPデータサービス、MCPツール、長期記憶、サンドボックス実行を、監査可能な業務チェーンとして統合します。

プロジェクトのハイライト

• マルチエージェント連携: メインエージェントが意図認識とタスクルーティングを担当し、procurement-analyst が調達分析を、procurement-order が注文照会と書き込み操作を担当します。プロンプト、ツール、スキル、ミドルウェアはすべてYAML/モジュール構成で分離されています。

• 標準化された業務ツール: MCPを通じてサプライヤー、部品、在庫、調達注文の機能をカプセル化し、合計8つのツールを提供。価格比較、在庫警告、注文明細照会、調達提案、可視化レポート生成をサポートします。

• Human-in-the-Loop: 注文の作成または変更の前に、エージェントが材料、サプライヤー、システム単価を自動的に解析し、欠落したフィールドを構造的に補完し、最終書き込み前に人間の承認を要求します。

• 長いチェーンのコンテキスト管理: MongoDBチェックポイントがセッション状態を保存し、長期記憶はユーザーごとに分離されます。コンテキスト要約、ツール結果のオフロード、スキルの段階的読み込みにより、コンテキストのオーバーヘッドを制御します。

• 隔離実行と復旧: OpenSandboxがファイルとコード実行を担当し、ヘルスチェック、ライフサイクル更新、無効化時の再構築、スキル復旧をサポートします。

• ERPのPython移行: FastAPI + SQLAlchemyを使用して元のSpring Boot ERP層を再構築し、54のRESTインターフェースパス、8つのMCPツール、元の応答プロトコルの互換性を維持しています。

Related MCP server: ECOUNT MCP Server

システムアーキテクチャ

flowchart LR
    UI[Vue 3 对话前端] --> CHAT[FastAPI Chat API]
    CHAT --> MAIN[主 Agent\n意图识别 / 路由]
    MAIN --> ANALYST[采购分析 Agent]
    MAIN --> ORDER[采购订单 Agent]
    ANALYST --> MCP[MCP 工具层\n8 tools]
    ORDER --> HITL[字段补充 / 人工审批]
    HITL --> MCP
    MCP --> ERP[FastAPI ERP\n54 REST APIs]
    ERP --> MYSQL[(MySQL)]
    MAIN --> MONGO[(MongoDB\nCheckpoint / Store)]
    ANALYST --> SANDBOX[OpenSandbox\nSkills / 文件 / 代码]
    ORDER --> SANDBOX

インターフェース表示

マルチエージェントスマート調達ワークベンチ

セッション履歴、ストリーミング応答、ツール呼び出し、エージェントの業務能力を統一的に表示します。

在庫分析と可視化レポート

調達分析エージェントが在庫MCPツールを呼び出し、在庫警告表、棒グラフ、調達提案を出力します。

注文検証と人間による承認

注文エージェントが材料、数量、システム単価、納期の検証を完了した後、人間による承認境界で停止します。承認なしでは書き込みは実行されません。

コアフロー

調達分析

用户需求 → 主 Agent 路由 → 采购分析 Agent
        → MCP 查询 ERP 数据 → 按需加载分析 Skill
        → 沙箱生成报告/图表 → 主 Agent 汇总结论与建议

調達注文

用户下单/改单 → 主 Agent 路由 → 采购订单 Agent
        → 查询物料、供应商和系统单价
        → 校验 Schema → 结构化补充缺失字段
        → Human-in-the-Loop 最终审批 → MCP 写入 ERP

プロジェクト構造

procureflow-agent/
├─ src/
│  ├─ agent/          # 主 Agent、子 Agent、中间件、记忆、HITL 与沙箱后端
│  ├─ skills/         # 主 Agent、采购分析与订单扩展 Skills
│  ├─ mcp_server/     # 8 个 ERP MCP 工具
│  ├─ erp_api/        # FastAPI + SQLAlchemy ERP 服务
│  └─ api_view/       # 对话、历史记录与流式事件 API
├─ frontend/          # Vue 3 对话前端
├─ tests/             # ERP 流程、54 接口与 8 MCP 工具契约测试
├─ migrations/        # Alembic 基线迁移
├─ database/          # 已匿名化的本地演示数据
├─ demo_data/         # 采购网页抓取的最小可复现报价页面
├─ docs/              # 架构迁移与等价性说明
└─ start_web.py       # ERP、MCP、Agent API、前端统一启动器

クイックスタート

1. 環境の作成

Condaの使用を推奨し、Python 3.11とNode.js 22を同時に管理します:

git clone https://github.com/Running-hue/procureflow-agent.git
cd procureflow-agent
conda env create -f environment.yml
conda activate procureflow-agent
Copy-Item .env.example .env

.env でMySQL、MongoDB、モデルサービス、OpenSandboxを設定します。リポジトリには実際のキーは含まれません。

2. データベースの初期化

空のテーブルを作成:

alembic upgrade head

またはサンプルデータをインポート:

python scripts\import_original_sql.py --yes-recreate

サンプルインポートは関連テーブルを再構築するため、本番データベースでは実行しないでください。

3. オプションの見積もりデモページを起動

調達分析スキルの3つの見積もりページはリポジトリに含まれています。OpenSandboxがDockerで実行されている場合、host.docker.internal からアクセスできます:

python -m http.server 5173 --directory demo_data\quote_pages

4. 完全なサービスを起動

python start_web.py

検証

python -m pytest -q
ruff check src\erp_api src\mcp_server tests start_web.py scripts
cd frontend
npm ci
npm run build

現在の自動化検証の対象:

• 54のERP RESTインターフェースパス契約;

• 8つのMCPツール登録契約;

• サプライヤー、部品、在庫、注文トランザクションと明細フロー;

• OpenSandboxの無効化復旧ロジック;

• Vue 3本番ビルド。

モデル、MongoDB、MySQL、OpenSandboxの実際のエンドツーエンド対話には、ローカルサービスと個人キーが必要です。このリポジトリは外部統合の結果を偽装しません。

セキュリティ設計

• .env、ローカルキーディレクトリ、ログ、キャッシュ、生成ファイル、フロントエンドビルド成果物はすべてGitで無視されます。

• 調達注文の書き込み操作は注文サブエージェントのみが実行し、MCP書き込みツールを実際に呼び出す前に人間の承認を要求します。

• 未検証のスキルはOpenSandboxで実行されます。ユーザー記憶は user_id ごとに分離して永続化されます。

• ツールの大きな結果は自動的にオフロードされ、コンテキストがしきい値に近づくと自動的に要約され、長いチェーンの失敗リスクを低減します。

移行範囲とインターフェースの等価性は 移行レポート を参照してください。セキュリティ境界は SECURITY.md を参照してください。