🚀 代理人工智能演示-智能商业平台
用AI驱动的自动化改变您的业务运营!
欢迎来到AI代理如何与真实业务应用程序无缝集成的前沿演示。该平台展示了一个完整的微服务生态系统,人工智能助手(如Claude或GitHub Copilot)可以通过自然对话直接管理订单、处理付款和处理事件。
✨ 是什么让这个特别?
🤖 与您的业务系统对话:使用自然语言管理订单、付款和事件\ ⚡ 实时操作:人工智能代理执行实际的业务操作,而不仅仅是模拟数据\ 🔧 生产准备就绪:采用企业级技术和最佳实践构建\ 🎯 即插即用:使用Docker轻松设置-几分钟内即可运行\ 🌐 现代堆栈:Vue.js前端、Spring Boot API和智能MCP服务器
📋 快速概览
| 服务 | 它做什么 | 前端 | API |
|---|---|---|---|
| 📦 订单 | 管理客户订单和生命周期 | 本地主机:5173 | 本地主机:8081 |
| 💳 支付 | 处理付款和交易 | 本地主机:5174 | 本地主机:8082 |
| 🚨 事件 | 跟踪问题和解决方案 | 本地主机:5175 | 本地主机:8083 |
| 🧠 AI助手 | 智能自动化层 | - | 本地主机:8085 |
🏗️ 系统架构
🖥️ Frontend Apps (Vue.js + TypeScript)
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ Orders │ │ Payments │ │ Incidents │
│ :5173 │ │ :5174 │ │ :5175 │
└─────────────┘ └─────────────┘ └─────────────┘
│ │ │
⚡ REST APIs (Spring Boot + Java)
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ Order API │ │Payment API │ │Incident API │
│ :8081 │ │ :8082 │ │ :8083 │
└─────────────┘ └─────────────┘ └─────────────┘
│ │ │
└────────────────┼───────────────┘
│
🤖 AI Integration Layer
┌─────────────────────────┐
│ MCP Servers │
│ (AI ↔ Business) │
│ :8085 │
└─────────────────────────┘
│
💾 Data Layer
┌─────────────────────────┐
│ MongoDB │
│ (Document Store) │
│ :27017 │
└─────────────────────────┘🚀 3分钟后开始!
先决条件✅
- 已安装并正在运行
- 可用端口:
5173-5175,8081-8083,8085,27017
1.️⃣ 启动一切
# Navigate to project directory
cd agentic-ai-demo
# 🚀 Start all services (this might take 2-3 minutes first time)
docker-compose up --build -d
# ✅ Check everything is running
docker-compose ps2.️⃣ 验证它是否正常工作
打开以下链接以确认服务已启动:
3.️⃣ 探索样本数据
该平台预装了真实的业务数据:
- 8个样品订单 在不同阶段(新→ 处理→ 已发货→ 交付)
- 4条付款记录 具有不同的状态
- 5张事故票 优先级各不相同
🎉 你准备好了! 您的完整业务平台现在正在运行!
🛠️ 管理命令
基本操作
# 🛑 Stop everything
docker-compose down
# 🔄 Restart a specific service
docker-compose restart order-backend
# 📜 View logs for debugging
docker-compose logs -f [service-name]
# 🧹 Clean slate (removes all data)
docker-compose down --volumes
# 🗑️ Complete cleanup (removes images too)
docker-compose down --volumes --rmi all健康监测
所有服务都包括智能健康检查:
- ✅ 自动修复:不健康的容器会自动重新启动
- ⏱️ 快速检测:在30秒内检测到问题
- 🔄 重试逻辑:3次尝试后标记为失败
检查健康状况: docker-compose ps
🧰 技术栈
🖥️ Frontend Technologies
- Vue.js 3 -具有组合API的现代反应框架
- TypeScript -具有出色IDE支持的类型安全开发
- 快 -闪电般快速构建工具和热重载
- CSS3 -现代风格与响应式设计
⚙️ Backend Technologies
- Spring Boot -具有自动配置功能的企业Java框架
- H2数据库 -用于快速开发的嵌入式SQL数据库
- MongoDB -用于灵活数据结构的文档数据库
- Gradle -高级构建自动化和依赖关系管理
🚀 Infrastructure & DevOps
- 码头工人 -用于一致环境的容器化
- Docker Compose -多容器编排
- 健康检查 -内置监控和自动恢复功能
- 多阶段建筑 -优化的容器图像
🤖 AI Integration
- 模型上下文协议(MCP) -AI应用集成标准
- REST API -基于HTTP的服务通信
- 弹簧靴执行器 -生产监控端点
🤖 连接您的AI助手
真正的魔法发生在你连接人工智能助手通过对话控制你的业务运营时!
🔧 VS代码的快速设置
- 构建MCP服务器 (一次性设置):
# Build both MCP server JAR files
./gradlew :mcp-servers:oms-mcp-server:build
./gradlew :mcp-servers:incident-mcp-server:build- 配置VS代码 -添加到您的
settings.json:
{
"mcp": {
"servers": {
"oms-mcp-server": {
"type": "stdio",
"command": "java",
"args": ["-jar", "YOUR_PROJECT_PATH/mcp-servers/oms-mcp-server/build/libs/oms-mcp-server-0.0.1-SNAPSHOT.jar"]
},
"incident-mcp-server": {
"type": "stdio",
"command": "java",
"args": ["-jar", "YOUR_PROJECT_PATH/mcp-servers/incident-mcp-server/build/libs/incident-mcp-server-0.0.1-SNAPSHOT.jar"]
}
}
},
"chat.mcp.discovery.enabled": true
}- 替换
YOUR_PROJECT_PATH根据您的实际项目路径。
💬 与您的业务系统对话
连接后,尝试以下自然语言命令:
| 你说什么 | 发生了什么 |
|---|---|
| *“显示所有待处理订单”* | 📋 列出等待处理的订单 |
| *“为订单#1001创建150美元的付款”* | 💳 处理新的支付交易 |
| *“哪些高优先级事件尚未解决?”* | 🚨 过滤需要注意的关键问题 |
| *“将订单#1001移至下一阶段”* | ⚡ 通过工作流推进订单 |
| *“显示所有失败的付款”* | 💸 显示需要重试的事务 |
💡 专业提示:AI维护完整的业务上下文并验证操作,因此您可以就复杂的业务工作流程进行自然对话!
❓ 故障排除
🚨 Services won't start
问题: docker-compose up 故障或服务显示不健康
解决方案:
# Check if ports are already in use
lsof -i :5173 -i :8081 -i :8082 -i :8083 -i :8085 -i :27017
# Clean up any existing containers
docker-compose down --volumes
docker system prune -f
# Restart Docker Desktop and try again
docker-compose up --build -d🔌 Can't connect to AI assistants
问题:VS Code或Claude无法识别MCP服务器
解决方案:
- 验证JAR文件是否存在:
ls -la mcp-servers/*/build/libs/*.jar- 如果丢失,请重建:
./gradlew :mcp-servers:oms-mcp-server:build
./gradlew :mcp-servers:incident-mcp-server:build- 检查VS代码设置路径 -在settings.json中使用绝对路径
- 重新启动VS代码 配置更改后
💾 Data not persisting
问题:重新启动后示例数据消失
解决方案:这是预期的行为。H2数据库在内存中用于演示目的。MongoDB数据保存在Docker卷中。
🎯 接下来是什么?
准备好扩展这个平台了吗?以下是一些想法:
- 🔐 添加身份验证 -实现用户登录和基于角色的访问
- 📧 电子邮件通知 -发送订单状态更改警报
- 📊 分析仪表板 -添加商业智能和报告
- 🔄 事件流 -为实时事件实现Apache Kafka
- 🧪 测试套件 -添加全面的集成测试
- 🌍 多租户技术 -支持多个组织
📞 支持与贡献
- 🐛 发现bug了吗? 打开一个包含详细复制步骤的问题
- 💡 有主意吗? 我们很乐意听取您的建议
- 🤝 想贡献吗? 查看我们的贡献指南
- 📚 需要帮助? 加入我们的社区讨论
______________________________________________________________________
🌟 如果你觉得这个repo有用,请将其标记为星号!
*内置于❤️ 面向人工智能开发社区*
