部署与使用手册

本手册只讲智能问数。装的是问数，不是 AI 合同智审。命令随当前门户地址生成；脚本尚未挂上时，复制后执行失败属预期。

产品是什么

智能问数是一套通用的智能数据分析产品：直连业务库、注入企业口径，让业务人员用自然语言完成取数、归因和报告。一句话：问的是业务话，回的是库里的数。

盘活数据资产，每个人都能用的智能分析平台——从自然语言提问到完整报告交付，准确、可信、敢用的决策依据。

• 准确：统一口径，同问同答；数据不足时说实话，不编数字。
• 可信：结论可回看 SQL 与行数，过程可复核。
• 敢用：建议按企业规范，输出能交付，不替代业务终审。

登录与账号

打开哪里

装好后浏览器打开 http://服务器IP（问数对外是 80，不要加智审那套 :8080）。本机预览门户用当前页地址；内网演示当前常用 http://192.168.10.170/。

用哪个账号

账号口令以交付清单为准。基线会预置管理员等角色，首次登录后请改密。本手册不写演示口令，避免门户公开后泄密。

演示环境一般有管理员、业务岗等角色。不同角色看到的推荐问题和数据行可能不同（千人千面）。

怎么提问

1. 登录后先选一个 Agent（按业务场景封装的问数助手，例如「抽检」）。
2. 用业务话提问，不要自己写 SQL。
3. 等图表和结论出来后，可以追问「为什么」「按档口看」。
4. 需要固定格式时，选报告模版出月报，不必再问一遍。

Agent 和数据源不是一回事。Agent 是按岗/场景封装的助手；数据源是对接的业务库。官网数字不要把两者混着写。

提问习惯

• 带上时间与范围：「本月」「肉品市场」「近 7 日」比「看一下数据」更容易对准。
• 一次问一件事。要对比，就明确「各市场合格率」。
• 空结果或「没有这张表」是系统在说实话，先查数据源和训练，不要反复换说法硬问。

抽检示例

冒烟约定问句：肉品市场的抽检情况。在真实系统里选「抽检」Agent 再问。

宣传册里的「1044 批 / 98.47%」是场景示意。库是空的时候，系统应说明缺表或缺数，不要编造。门户首页的拆解区也是示意，不是连库查询。

出报告

固定周期、固定栏目的材料（例如抽检月报）走模版：选模版、选周期、生成。历史报告也可以提炼成新模版。生成结果仍是 AI 辅助，业务终审在人。

权限与审计

• 行级过滤：同一句问，不同角色可能看到不同行。
• 列级脱敏：敏感字段按角色打码或不返回。
• 问答与操作留痕，便于复核。
• 应用和数据部署在客户机房；大模型走配置的 API（需服务器能访问对应 HTTPS）。

环境要求

机器

栈里有什么

浏览器 → 前端(80)
         → 后端
         → vanna 引擎（自然语言 → SQL）
         → vanna-permission（行列权限 / 训练扩展）
         → MySQL（系统库） / Redis
         → ClickHouse（业务分析库） / PostgreSQL+pgvector（引擎存储）

这是一套问数，不要和智审容器、智审安装源、智审门户端口混用。

安装与升级

完整命令在 安装页。首页底部也有同一条安装命令。命令始终跟当前门户 origin走。

复制curl -fsSL https://chatbi.horzits.com/install.sh | bash -s

• 重复执行 = 升级，默认不清库。
• 清库重装、干净卸载见安装页，确认环境后再做。
• 一键脚本还没挂到本门户时，HEAD /install.sh 失败，页面会提示，不要当成产品坏了。
• 装完打开服务器 IP，不要加 :8080。

当前推荐版：待发布。版本文件就绪后自动填。

常见问题

问了没数 / 说没有表

引擎已经连上分析库，但库里还没有业务表或口径。先灌 ClickHouse（或所接数据源），在系统里配好数据源和 Agent，再问。空库空转很多轮也问不出数，这是预期。

登录页能开，登不进去

先确认打开的是问数地址，账号来自本套基线。不要拿智审账号去登问数，也不要拿问数账号去登智审。

安装命令失败

先看是不是在本机 file:// 或预览端口上复制的命令——脚本还没发布时本来就会失败。等门户正式挂上 install.sh 后再装。

会不会把智审一起装上

不会。本门户、本命令只装智能问数。智审有自己的官网和安装源，两套产品一门一产品。

说明

系统输出为 AI 辅助分析，不替代业务终审与合规判断。截图与互动 Demo 在数据未就绪前使用示意，正式环境以库中实数为准。

西安禾智数融信息技术有限公司