w8123/EnterpriseAgentFramework

ReachAI企业级智能体开发平台：快速、安全完成已有业务系统智能化改造，让 AI 在 OA、ERP、CRM 等原系统中查数据、填表单、办业务。ReachAI: Quickly and securely bring AI to existing enterprise systems, enabling AI to query data, fill out forms, and execute business tasks directly within OA, ERP, CRM, and other business applications.

ReachAI – 企业 Agent 框架 (w8123/EnterpriseAgentFramework)

它是什么 – 一个以 Java 为中心的平台，让公司能够为现有企业应用（OA、ERP、CRM、HR、采购等）改造添加 AI 驱动的助手。系统自动扫描遗留 Web 应用，将其页面、API 和业务逻辑注册为 Capabilities，然后生成并部署 AI Agents 和 Workflows，这些可以即时回答自然语言查询、填写表单和触发事务——同时保留原始 UI、身份验证和审计跟踪。

核心组件

组件	作用	关键技术
Capability SDK / Spring-Boot starter	开发者使用 `@ReachCapability` 注解 Java 服务方法，将其暴露给 AI 运行时。	兼容 Java 8，Spring Boot 2/3
Page Embed & Bridge	将聊天小部件注入现有 Web UI，并注册 Agent 可调用的显式页面操作（读取、过滤、写入）。	Vue 3, TypeScript, `eafPageBridge.ts`
AI Coding 流水线	扫描目标系统，建议最多三个具体的重构任务，并使用基于 LLM 的代码生成器（Codex、Claude-Code 等）在真实代码库中实现它们。	LLM 驱动的代码生成，带验收标准的任务协议
Workflow Studio	用于 GraphSpec 工作流的可视化编辑器，结合 AI 生成的步骤与已验证的业务 API。	LangGraph4j, GraphSpec, Vue-Flow
Agent Runtime	执行 Agent，选择授权的工作流，强制执行 ACL/guard 策略，记录完整跟踪以供审计。	AgentScope, Runtime Service, MySQL + Redis + Milvus
模型与知识服务	用于 LLM 聊天、嵌入、RAG 和向量搜索的集中式网关。	Spring AI, Milvus, 多个 LLM 提供商
运维控制台	用于运维、自动化、评估（EvalOps）和运行时治理（RunOps）的仪表板。	Vue UI, 跟踪回放, 指标聚合

典型升级如何工作

连接基于 Java 的业务系统到 ReachAI。
扫描 UI 和后端 API → 生成 capability map。
推荐最多三个低风险重构项（只读分析）。
AI Coding 将选定项转化为具体的工程任务；LLM 编写代码、运行测试并推送回来。
发布新的 Capability 和关联的 Workflow；Agent 现在可以调用它。
运行 – 用户在嵌入式聊天中输入自然语言命令；Agent 选择经过验证的工作流，调用 capability，UI 自动更新。
治理 – 每次调用都被记录，写入需要用户确认，并且可以从 RunOps 控制台回放。

谁使用哪个部分？

角色	交互
开发者	审查扫描结果，批准 AI 建议的重构，监控 AI Coding 任务，可能添加 `@ReachCapability` 注解。
业务用户	留在熟悉的 OA/CRM UI 中，输入如“创建 10 台显示器的采购请求”的请求。
经理 / 运维	查看显示 Agent 使用情况、令牌消耗、风险工单和整体 ROI 的仪表板。

ReachAI 与类似工具有何不同？

企业焦点 – 为多租户 Java SaaS 构建，尊重现有认证、角色和事务边界。
基于证据的重构 – 在编写任何代码之前，每个建议的更改都有代码引用和验收标准支持。
治理优先 – 显式 ACL、写入的用户确认、不可变跟踪，以及独立的评估循环（EvalOps）。
混合工作流 – 结合 LLM 生成的推理与预先批准、版本化的业务工作流，以提高可靠性。

入门（本地开发）

安装 JDK 17、Maven、Node ≥ 20 和 Docker-Compose。
docker compose … up -d 启动 MySQL、Redis、Milvus。
运行 mvn clean install -DskipTests，然后启动五个服务（model、knowledge、control、runtime、capability）——提供的 IntelliJ 运行配置可以一起启动它们。
启动 Vue 管理 UI（npm ci && npm run dev）。默认开发凭据为 admin / admin123。
按照文档使用 SDK 注册示例 Java 应用并嵌入聊天小部件。

许可证

根据 MIT 许可证开源。

底线 – ReachAI 是一个全栈、面向生产的框架，用于将遗留 Java 企业应用转变为 AI 增强的助手，强调安全性、可审计性和增量式、AI 辅助的代码现代化。