# GgAgent

**Repository Path**: zeron2022/gg-agent

## Basic Information

- **Project Name**: GgAgent
- **Description**: 智能医疗体，让ai帮助我们进行挂号预约
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2025-08-07
- **Last Updated**: 2025-08-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# GG-Agent

这是一个基于 LangChain4j 的智能助手项目，集成了 Qwen 大模型和多种实用工具，支持对话交互、预约挂号、取消预约、号源查询等功能。

## 功能特性

- **智能对话**：基于 Qwen 大模型的自然语言处理能力，实现流畅的人机对话。
- **预约挂号**：支持根据科室、医生、日期等信息进行挂号预约。
- **取消预约**：提供取消已预约挂号的功能。
- **号源查询**：可查询特定科室、医生在指定时间的号源情况。
- **记忆存储**：使用 MongoDB 存储对话历史，实现上下文记忆功能。
- **向量检索**：集成向量数据库，支持基于知识库的问答。

## 技术栈

- Java 17
- Spring Boot
- LangChain4j
- Qwen 大模型
- MongoDB
- MyBatis Plus
- Redis（可选）

## 安装与运行

### 环境要求

- JDK 17+
- Maven 3.8+
- MongoDB 5.0+
- Node.js（用于前端 UI）

### 快速启动

1. **克隆项目**

   ```bash
   git clone https://gitee.com/We1fare/gg-agent.git
   cd gg-agent
   ```

2. **配置环境变量**

   修改 `application.yaml` 文件，配置 MongoDB、Qwen API Key 等信息。

3. **构建并运行后端**

   ```bash
   mvn clean install
   mvn spring-boot:run
   ```

4. **运行前端 UI（可选）**

   ```bash
   cd src/main/resources/web/xiaozhi-ui
   npm install
   npm run dev
   ```

## 使用示例

### 对话接口

发送 POST 请求至 `/xiaozhi/chat`，示例：

```json
{
  "message": "我想预约明天上午的神经内科专家号"
}
```

### 功能演示

- **预约挂号**：输入“预约神经内科张医生明天上午的号”
- **取消预约**：输入“取消预约张医生明天上午的号”
- **查询号源**：输入“明天上午神经内科还有号吗？”

## 项目结构

- `src/main/java/com/atguigu/java/ai/langchain4j`：核心业务逻辑
- `src/main/resources`：配置文件、前端 UI、Prompt 模板等
- `src/test/java`：单元测试与集成测试

## 贡献指南

欢迎贡献代码！请遵循以下步骤：

1. Fork 项目
2. 创建新分支 (`git checkout -b feature/new-feature`)
3. 提交更改 (`git commit -am 'Add new feature'`)
4. 推送分支 (`git push origin feature/new-feature`)
5. 创建 Pull Request

## 许可证

本项目采用 Apache-2.0 许可证，详情请参见 [LICENSE](LICENSE) 文件。

---

如有任何问题或建议，请提交 Issue 或联系项目维护者。