IntelliQ

介绍

IntelliQ 是一个开源项目，旨在提供一个基于大型语言模型（LLM）的多轮问答系统。该系统结合了先进的意图识别和词槽填充（Slot Filling）技术，致力于提升对话系统的理解深度和响应精确度。本项目为开发者社区提供了一个灵活、高效的解决方案，用于构建和优化各类对话型应用。

工作流程

特性

1. 多轮对话管理：能够处理复杂的对话场景，支持连续多轮交互。
2. 意图识别：准确判定用户输入的意图，支持自定义意图扩展。
3. 词槽填充：动态识别并填充关键信息（如时间、地点、对象等）。
4. 接口槽技术：直接与外部APIs对接，实现数据的实时获取和处理。
5. 前后端分离：React前端 + Flask后端，支持现代化Web开发模式。
6. 流式AI聊天：支持Server-Sent Events (SSE)，实现实时聊天体验。
7. 跨域支持：内置CORS配置，支持本地开发和生产部署。
8. 环境配置：灵活的环境变量配置，支持开发/生产环境切换。
9. 一键启动：提供跨平台启动脚本，团队成员无需手动配置。
10. 易于集成：提供了详细的API文档，支持多种编程语言和平台集成。

安装和使用

🌏环境要求

• Python 3.8+
• Node.js 16+ (包含npm包管理器)
• npm 7+ (随Node.js自动安装)

注意: npm是Node.js的包管理器，安装Node.js时会自动包含npm。如果您还没有安装Node.js，请访问 Node.js官网 下载安装。

🔧修改配置

配置项在 config/init.py

• GPT_URL: AI平台的URL
• API_KEY: 修改为自己的API密钥
• API_BASE_URL: 修改为查询/办理的接口

📋 安装步骤

确保您已安装 git、python3、node.js。然后执行以下步骤：

1. 克隆代码

git clone https://github.com/answerlink/IntelliQ.git
cd IntelliQ

2. 后端配置

# 创建Python虚拟环境
python3 -m venv venv
source venv/bin/activate  # Linux/macOS
# venv\Scripts\activate   # Windows

# 安装Python依赖
pip install -r requirements.txt

3. 前端配置

cd frontend
npm install
cd ..

4. 环境配置

• 复制 .env.example 为 .env 并根据需要修改配置
• 复制 frontend/.env.example 为 frontend/.env 并根据需要修改配置

5. 启动服务

启动后端服务：

python app.py

启动前端服务（新开一个终端窗口）：

cd frontend && npm start

访问地址：

• 前端界面：http://localhost:3000
• 后端API：http://localhost:5050
• API健康检查：http://localhost:5050/api/health

🔗 API接口

健康检查

GET /api/health

流式AI聊天

POST /api/llm_chat
Content-Type: application/json
Accept: text/event-stream

{
  "messages": [],
  "user_input": "用户输入",
  "session_id": "可选的会话ID"
}

获取模拟槽位

GET /api/mock_slots

重置会话

POST /api/reset_session
{
  "session_id": "会话ID"
}

更多详细信息请查看 前后端联调说明。

贡献

非常欢迎和鼓励社区贡献。如果您想贡献代码，请遵循以下步骤：

Fork 仓库
创建新的特性分支 (git checkout -b feature/AmazingFeature)
提交更改 (git commit -m 'Add some AmazingFeature')
推送到分支 (git push origin feature/AmazingFeature)
开启Pull Request

查看 CONTRIBUTING.md 了解更多信息。

All Thanks To Our Contributors:

License

Apache License, Version 2.0

版本更新

v2.0 2025-7-17 实现真实的API的对接；优化流程；升级前端

v1.3 2024-1-15 集成通义千问线上模型

v1.2 2023-12-24 支持Qwen私有化模型

v1.1 2023-12-21 改造通用场景处理器；完成高度抽象封装；提示词调优

v1.0 2023-12-17 首次可用更新；框架完成

v0.1 2023-11-23 首次更新；流程设计

IntelliQ 快速上手指南

IntelliQ 是一个基于大型语言模型（LLM）的开源多轮问答系统，集成了意图识别、词槽填充及流式对话能力。本指南将帮助开发者在几分钟内完成本地部署并运行。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Linux / macOS / Windows
• Python：版本 3.8 或更高
• Node.js：版本 16 或更高（安装时会自动包含 npm 7+）
• 其他工具：Git

提示：国内用户安装 Node.js 若遇网络问题，可访问 Node.js 中文镜像站 下载。

安装步骤

1. 克隆项目代码

git clone https://github.com/answerlink/IntelliQ.git
cd IntelliQ

2. 配置后端环境

创建并激活 Python 虚拟环境，安装依赖：

# 创建虚拟环境
python3 -m venv venv

# 激活环境 (Linux/macOS)
source venv/bin/activate
# 激活环境 (Windows)
# venv\Scripts\activate

# 安装依赖 (推荐使用国内镜像源加速)
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

3. 配置前端环境

cd frontend
# 安装依赖 (推荐使用淘宝镜像源加速)
npm install --registry=https://registry.npmmirror.com
cd ..

4. 修改配置文件

编辑 config/__init__.py 文件，填入您的 AI 服务配置：

• GPT_URL: 填写 AI 平台接口地址
• API_KEY: 填写您的 API 密钥
• API_BASE_URL: 填写业务查询或办理的接口地址

同时，复制环境变量模板：

cp .env.example .env
cp frontend/.env.example frontend/.env

(如有需要，可根据实际场景微调 .env 中的配置)

基本使用

完成上述步骤后，通过两个终端窗口分别启动后端和前端服务。

第一步：启动后端服务 在当前目录（已激活 Python 虚拟环境）执行：

python app.py

后端默认运行在：http://localhost:5050

第二步：启动前端服务 打开一个新的终端窗口，进入 frontend 目录并启动：

cd frontend && npm start

前端默认运行在：http://localhost:3000

第三步：体验对话 在浏览器中访问 http://localhost:3000，即可开始与 IntelliQ 进行多轮交互测试。

---

API 快速测试示例 您也可以通过命令行直接测试流式聊天接口：

curl -X POST http://localhost:5050/api/llm_chat \
  -H "Content-Type: application/json" \
  -H "Accept: text/event-stream" \
  -d '{"messages": [], "user_input": "你好，请介绍一下你自己", "session_id": "test_001"}'