# robot-ai

**Repository Path**: Marthew01/robot-ai

## Basic Information

- **Project Name**: robot-ai
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-17
- **Last Updated**: 2025-04-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Robot AI 智能语音助手

基于MCP（多智能体协作协议）的智能语音助手系统，用于处理与项目信息相关的语音查询。

## 功能特点

- **语音唤醒**：通过关键词"小智"唤醒系统
- **自然语言理解**：理解用户的意图和关键信息
- **多智能体协作**：基于MCP的多个智能体协同工作
- **业务数据查询**：查询如"某单位火警次数"、"维保情况"等业务数据
- **语音交互界面**：友好的语音和可视化交互界面

## 技术栈

- 前端：Vue 2 + Vuex + Vue Router + Element UI
- 后端：SpringBoot 2
- MCP智能体协作框架

## 项目结构

```
robot-ai/
├── src/
│   ├── api/             # API接口
│   ├── assets/          # 静态资源
│   ├── components/      # 组件
│   ├── plugins/         # 插件
│   ├── router/          # 路由
│   ├── store/           # Vuex状态管理
│   ├── utils/           # 工具函数
│   ├── views/           # 页面
│   ├── App.vue          # 根组件
│   └── main.js          # 入口文件
├── public/              # 静态文件
├── babel.config.js      # Babel配置
├── package.json         # 项目依赖
├── webpack.config.js    # Webpack配置
└── README.md            # 项目说明
```

## 安装和运行

```bash
# 安装依赖
npm install

# 开发运行
npm run dev

# 构建生产版本
npm run build
```

## 智能体架构

本项目实现了以下智能体：

1. **语音处理智能体**：负责语音唤醒、识别和合成
2. **理解智能体**：负责自然语言理解和意图识别
3. **规划智能体**：根据用户意图规划查询策略
4. **知识查询智能体**：连接数据源，执行查询
5. **响应生成智能体**：将查询结果组织成自然语言
6. **对话管理智能体**：维护对话上下文

## 使用示例

- 说"小智"唤醒系统
- 询问"一分公司五月份火警次数是多少？"
- 询问"二分公司12月的维保情况"

## 后端API要求

本前端应用需要连接到 robot-business 后端服务，后端需提供以下API：

- `/api/voice/process`: 处理语音数据
- `/api/voice/recognize`: 语音识别
- `/api/voice/synthesize`: 文本转语音
- `/api/mcp/process`: 处理用户意图
- `/api/mcp/query`: 查询数据
- `/api/mcp/agent-status`: 获取智能体状态