常见问题

问题解答

本文档收集整理了智能体问数使用过程中的常见问题和解决方案，涵盖数据源配置、术语配置、数据查询、可视化展示等各个环节。通过这些问答可以帮助用户快速解决使用中遇到的问题，提升智能体问数的使用效率和效果。

🗃️ 一、数据源配置相关问题

❓ Q1：数据源连接测试失败应该如何处理？

A： 连接测试失败的常见原因和解决方案：

网络连通性问题：

• 确认数据库服务器地址和端口是否正确
• 通过 telnet 地址 端口 测试网络连通性
• 检查数据库服务是否正常运行

账号权限问题：

• 确认用户名和密码是否正确
• 检查账号是否被锁定或过期
• 验证账号是否有数据库SELECT权限

访问控制问题：

• 检查数据库是否允许远程连接
• 确认服务器防火墙规则已放通
• 验证数据库白名单配置是否包含当前服务器IP

❓ Q2：选择数据源后数据表列表显示为空？

A： 数据表列表为空通常是因为数据源未配置结构信息：

原因分析：

• 数据源创建后未进行结构配置
• 结构配置信息未保存或保存失败
• 数据库用户缺少information_schema的访问权限

解决方法：

1. 在数据源列表中点击该数据源的【配置】按钮
2. 进入数据源结构配置页面，系统会自动读取表结构
3. 完善表和字段的业务说明后点击保存
4. 返回智能体配置页面重新选择数据源

❓ Q3：AI模型列表为空无法选择？

A： 模型列表为空的常见原因和解决方案：

模型配置问题：

• 确认系统中已配置可用的对话模型（在【模型管理】中检查）
• 检查模型的API密钥是否有效且未过期
• 确认模型服务是否正常运行

权限问题：

• 确认当前用户有使用AI模型的权限
• 检查用户角色是否包含模型访问权限
• 联系管理员分配相应权限

📚 二、术语配置相关问题

❓ Q4：配置的术语在问数时不生效？

A： 术语不生效的常见原因和解决方案：

配置保存问题：

• 术语添加后需点击【保存】按钮，确认出现保存成功提示
• 刷新页面确认术语已正确保存

未关联到智能体：

• 在术语配置页面，需要勾选术语卡片将其关联到当前智能体
• 仅添加到术语库不会自动生效，必须在智能体中选中才能使用

术语内容问题：

• 检查术语内容中的表名.字段名拼写是否与数据库一致
• 术语的内容说明应包含具体的字段映射或计算公式，避免模糊描述
• 建议为常用术语配置多个同义词，覆盖不同问法

📊 三、数据查询相关问题

❓ Q5：AI生成的SQL不正确如何优化？

A： SQL生成不准确的优化策略：

提问方式优化：

• 严格使用已配置的业务术语提问，如用"销售额"而非"卖了多少钱"
• 明确指定时间范围（"本月"）、统计维度（"按地区"）、排序方式（"降序前10"）
• 将复杂查询拆分为多个简单问题，利用多轮对话逐步追问

术语配置优化：

• 如果某类问题持续出错，检查并补充相关术语的字段映射和说明
• 为常见表达配置同义词术语，覆盖不同问法
• 参考推荐问题的表述方式优化自己的提问

❓ Q6：查询执行超时如何解决？

A： 查询超时的常见原因和解决方案：

查询优化：

• 明确指定时间范围，避免全表扫描
• 使用聚合查询代替明细查询
• 增加筛选条件减少数据量

数据库优化：

• 联系DBA检查相关字段是否有索引
• 确认数据库服务器负载是否正常
• 考虑对大表进行数据归档

❓ Q7：查询结果数据不准确如何验证？

A： 数据准确性的验证方法：

SQL验证：

• 展开查看生成的SQL语句，确认查询逻辑是否符合预期
• 复制SQL到数据库工具中直接执行，对比结果是否一致

配置验证：

• 确认术语映射的字段和计算公式是否正确
• 检查时间范围和筛选条件是否准确
• 验证数据源中的数据本身是否准确和最新

❓ Q8：查询被系统阻止是什么原因？

A： 这是正常的安全机制：

安全策略说明：

• 系统只允许SELECT查询，会自动阻止INSERT、UPDATE、DELETE等写操作
• 这是为了防止通过自然语言查询误修改或删除数据
• SQL白名单机制确保数据库数据安全

排查建议：

• 检查问题表述中是否包含可能被误判为写操作的关键词
• 确认用户账号是否有数据查询权限
• 如确认是误拦截，联系管理员检查安全规则配置

🎨 四、可视化展示相关问题

❓ Q9：图表显示不出来或显示异常？

A： 图表异常的常见原因和解决方案：

数据问题：

• 确认查询确实返回了数据（查看数据表格区域）
• 检查数据是否包含异常值（NULL、超大数值等）
• 验证数据格式是否适合当前图表类型

浏览器问题：

• 刷新页面重新发起查询
• 查看浏览器控制台（F12）是否有错误信息
• 尝试更换浏览器或清除缓存后重试