本章主要结介绍如何部署AIChat引擎, 升级AIChat引擎请查看文档：自然语言分析引擎版本升级AIChat引擎版本升级。
1.安装环境要求
1.1. 环境检查
1.1.1 CPU架构以及指令集确认
...
出现如下信息则在Smartbi服务器访问NLA服务是正常的。
安装权限要求：
安装时用root用户运行或使用具有sudo权限的用户执行，推荐使用root用户安装，如果是普通用户有sudo权限的，在命令前加上sudo。
2.安装
(1) 解压安装包
| 代码块 | ||||
|---|---|---|---|---|
| ||||
cd /<安装包路径>
tar -xvf nla-setup.tar.gz |
...
| 代码块 | ||||
|---|---|---|---|---|
| ||||
sudo chmod 777 -R * |
创建AIChat安装目录(以下以/data/admin/smartbi-nla为例)
| 代码块 | ||||
|---|---|---|---|---|
| ||||
mkdir /data/admin/smartbi-nla |
进入安装包解压目录
| 代码块 | ||||
|---|---|---|---|---|
| ||||
cd /<安装包解压目录> |
使用install.sh脚本进行安装：
| 代码块 | ||||
|---|---|---|---|---|
| ||||
sudo bash install.sh |
...
输入创建的AIChat安装目录的绝对路径:
当出现如下字样则说明安装完成：
（3）修改docker本地存储地址（可选择）
原因：通常docker安装后，默认的本地存储地址是根目录，根目录通常都不大，需要将仓库迁移到容量较大的目录
方法：
1、停止AIChat和docker cd /data/admin/smartbi- |
|---|
...
nla #停止AIChat ./stop.sh systemctl stop docker #停止docker 2、创建存储目录（假设你的存储目录是：/data/docker-data） mkdir /data/docker-data 3、在 /etc/docker目录下创建daemon.json文件；如果存在该文件则修改： cd /etc/docker vim /etc/docker/daemon.json |
|---|
（4）更改了docker本地存储地址后需要重新安装
进入AIChat安装目录
| 代码块 | ||||
|---|---|---|---|---|
| ||||
cd /<AIChat安装目录> |
删除AIChat目录下文件
| 代码块 | ||||
|---|---|---|---|---|
| ||||
rm -rf * |
进入安装包解压目录
| 代码块 | ||||
|---|---|---|---|---|
| ||||
cd /<安装包解压目录> |
使用install.sh脚本进行安装：
| 代码块 | ||||
|---|---|---|---|---|
| ||||
sudo bash install.sh |
输入创建的AIChat安装目录的绝对路径:
当出现如下字样则说明安装完成：
(3) 配置服务设置
进入Smartbi服务，进入系统运维--系统选项找到 服务器地址-- Smartbi服务器URL地址 配置项，设置Smartbi集群的地址：配置项，设置Smartbi的地址：
这里以 http://10.10.202.100:8080/smartbi为例。
...
进入“系统运维--自然语言配置“中设置“使用大模型的版本”
配置大模型调用参数的信息
Local_llm/Local
适用于所有OpenAI接口的大模型，例如deepseek
...
Xunfei/Spark-general 3.5
Qwen/Qwen
（5）验证自然语言配置是否正常
浏览器中访问部署好的地址出现以下页面如：http://10.10.202.100:9060/aiweb
进入后根据构建的知识图谱来输入对话，出现以下内容则配置正常
3.常见问题（FAQ）
1. selinux导致daemon的OCI runtime create failed
...
使用docker logs 进入容器查看，出现如下日志：
|
当前服务器的 CPU 不支持TensorFlow所需要的指令集 avx 和 avx2。
...
问题可能的原因2：Smartbi服务器地址没有填，或者NLA服务无法访问smartbi服务的地址。请在NLA服务器上用curl -L <Smartbi地址>来测试连通性。
4
...
原因：通常docker安装后，默认的本地存储地址是根目录，根目录通常都不大，需要将仓库迁移到容量较大的目录
方法：
1、在 /etc/docker目录下创建daemon.json；如果存在该文件则修改：
vi /etc/docker/daemon.json
2、daemon.json文件的内容如下（假设你的存储目录是：/docker-data）：
{
"data-root": "/docker-data"
}
3、复制旧数据存储目录到新的数据存储目录下
sudo rsync -aP /var/lib/docker/ /docker-data
4、重启docker
sudo systemctl restart docker
5. 启动报NLA服务 iptables failed问题
...
