DedeBIZ智能助手使用手册

DedeBIZ智能助手(DedeBIZ AI Assistant)以下简称“AI助手”,是DedeBIZ系统实现站点智能化搭建的核心工具,支持OpenAI标准接口协议,可无缝接入 deepseek、通义千问、豆包等多种AI大模型。系统采用 PHP + Go 技术架构,兼顾高效性与用户体验,帮助用户快速构建智能化站点,提高站点内容生产与优化效率。

安装

安装准备

在使用AI助手之前,请确保已经安装并配置了DedeBIZ系统,并确保DedeBIZ系统版本为v6.5及以上。

如果您是DedeBIZ老版本用户,请升级到v6.5及以上版本,以保证兼容性,并进入[系统设置]-[智能设置],确保正确的设置了通信密钥(cfg_ai_apikey)。

我们建议AI助手被安装在DedeBIZ同一个服务器上,以避免跨服务器通信的额外开销。

目前AI助手支持Windows和Linux系统,推荐使用Windows系统,Linux系统请根据实际情况进行适配。当然如果您有其他环境部署需求,也可以跟官方取得联系,我们很乐意为您服务。

安装步骤

下载

下载最新版本:DedeBIZ AI Assistant,选择对应平台的二进制文件。

初始化

解压文件,进入解压目录,执行命令:

./dedebizaia

命令执行后,系统会启动AI助手

[DedeBIZ AI Assistant]v1.0.0 server listen on 0.0.0.0:8087

默认监听端口为8087,如果当前端口已经被占用,则可以执行-p参数指定端口:

./dedebizaia s -p 8888

访问http://localhost:8087/,如果出现如下页面,则表示安装成功。

图1

根据页面提示,进行AI助手的配置。“数据库设置”这里需要填写您DedeBIZ系统安装数据库信息,可以查看站点文件:data/common.inc.php中对应的配置信息。

配置完成后,可以点击检查按钮,查看是否正常和DedeBIZ系统数据库连接。

“服务设置”查看站点[系统设置]-[智能设置]中对应配置信息(cfg_ai_server)

同意许可协议后点击“初始化”按钮,进行AI助手服务的初始化。成功后将提示初始化成功的信息,这时候则重启AI助手服务,即可完成AI助手服务的安装。

图1

启动

一般的情况下,您只需要进入AI助手所在目录通过命令行./dedebizaia直接启动服务,但也可以将其添加到系统服务中,以实现开机自启。

在安装包scripts/systemd目录中,提供了AI助手的systemd服务配置文件,将文件复制到/etc/systemd/system目录下,按照您自己的系统情况进行修改,并执行命令systemctl daemon-reload,然后执行命令systemctl enable dedebizaia.service,即可实现开机自启。

如果是Windows,可以采用Windows内置服务命令或NSSM等工具进行服务管理,以实现开机自启。

内置服务命令

要注册为Windows服务,首先以Administrator身份运行cmd,然后执行以下命令:

sc.exe create dedebizaia start= auto binPath= "\"C:\dedebiz\dedebizaia.exe\" s -c \"C:\dedebiz\dedebiz.toml\""

C:\dedebiz替换成你的AI助手安装目录。

之后在控制面板打开 "Windows Services",搜索 "dedebizaia",右键选择 "Run"。在浏览器打开 http://localhost:8087 就可以访问了。(如果你修改了端口,请访问对应的端口,8087是默认端口)。

据观察,在启动期间加载的系统上,AI助手服务可能无法启动,并在 Windows 事件日志中记录超时。 在这种情况下,将启动类型更改为Automatic-Delayed。这可以在服务创建期间完成,或者通过运行配置命令来完成。sc.exe config dedebizaia start= delayed-auto,要将启动依赖项添加到 DedeBIZAIA Windows 服务(例如 Mysql、Mariadb),作为管理员,然后运行以下命令:sc.exe config dedebizaia depend= mariadb,如果要删除服务,则执行以下命令:sc.exe delete dedebizaia

NSSM

详见:《Windows下采用NSSM方式部署DedeBIZ智能助手

开启DedeBIZ智能助手

默认DedeBIZ系统中AI助手是关闭的,您需要进入[系统设置]-[智能设置]中开启这个功能。

图3

点击“检测”按钮,可以确定是否正常连接了AI助手服务。

部署

我们也支持采用Nginx反向代理的方式对AI助手进行部署,您可以查看scripts/nginx中的文件,并根据自己的需要调整后部署。

使用

目前AI助手支持以下功能:

  • 大模型管理:支持自定义接入各类AI大模型及不同版本,轻松适配新兴大模型,确保系统持续优化升级。
  • 内容智能化:支持智能添加栏目、批量构建站点结构、智能生成和优化文档,助力高效内容管理。
  • 提示词管理:内置智能助手功能,可优化或新增提示词,深度挖掘AI能力,提高站点构建质量。
  • 调用日志:提供详细AI调用记录,包括操作日志和Token消耗,方便分析优化AI使用策略。

以管理员身份登录DedeBIZ(V6.5及以上版本)系统后台,在左侧菜单中可以看到[智能管理]模块,这里包含了对模型、模型版本、提示词、调用日志等进行管理。

DedeBIZ智能助手

大模型管理

查看已有模型:可浏览已接入的大模型,如通义千问、Ollama、Moonshot 模型等,包括模型名称、描述、隶属公司、官网等信息。

大模型管理

操作按钮

  • 添加大模型:点击可进行大模型添加,兼容OpenAI接口格式的大模型。
  • 模型版本:管理模型的不同版本。
  • 模型优选:官方推荐的一些最新的大模型。
  • 操作栏:可对单个模型进行编辑和删除操作。

添加大模型

添加大模型

进入添加界面后,需填写以下信息:

  • 名称:输入大模型名称。
  • 描述:简要介绍模型特点。
  • 公司名称:模型所属公司。
  • 官方网址:模型官网地址。
  • API Key:访问模型 API 的密钥。
  • 接口地址:需兼容 OpenAI 接口标准。

填写完成后点击 “保存”,或 “重置” 清空内容。

修改大模型

修改大模型

选中需修改的模型进入修改页面,可修改除模型名称外的信息,如描述、公司名称、官网等。还可进行模型版本管理,如添加新版本、编辑或删除已有版本信息。完成修改后点击 “保存”,“重置” 则放弃修改。

模型版本管理

大模型版本管理功能用于对已接入大模型的不同版本进行添加、修改和查看等操作,帮助用户更好地管理和使用不同版本的大模型,满足多样化的业务需求,提升站点智能化建设效果。 模型版本管理

添加模型版本

模型版本管理

  1. 点击“添加模型版本”,进入 “添加模型版本” 界面。
  2. 在 “隶属模型” 下拉框中选择目标模型,如 “Doubao 家族模型”。
  3. 依次填写 “Model”(模型标识)、“名称”(版本名称)、“排序”(由低到高,用于确定展示顺序 )、“描述”(版本特性说明)等信息。
  4. 点击 “保存” 完成添加;点击 “重置” 清空已填信息;点击 “返回” 回到上一级界面。

修改模型版本

模型版本管理

  1. 在 “模型版本管理” 列表中,点击对应版本操作栏的编辑按钮,进入 “后台面板 / 大模型管理 / [具体模型] / 修改模型版本” 界面。 可对 “Model”“名称”“排序”“描述” 等信息进行修改。
  2. 修改完成后,点击 “保存” 应用更改;点击 “重置” 放弃修改,恢复原有内容;点击 “返回” 回到模型版本管理列表。

注意

  • 排序数值将影响模型版本在相关列表中的展示顺序,合理设置有助于快速定位所需版本。
  • 删除模型版本操作需谨慎,以免影响依赖该版本的业务功能。

提示词管理

提示词管理功能,支持用户对用于与 AI 交互的提示词进行添加、修改、预览和管理,方便用户根据不同业务场景定制 AI 指令,提升站点智能化交互效果和内容生成质量。

目前支持创建栏目、批量添加栏目、栏目修改、添加文档、文档修改、智能翻译官等功能,用户可以方便根据自己的业务场景进行定制,提高站点智能化建设效果。

提示词管理

添加提示词

添加提示词

  1. 进入“后台面板 / 提示词管理 / 添加提示词” 界面。
  2. 标识:输入由英文和数字组成的唯一标识。
  3. 名称:填写提示词的名称,便于识别。
  4. 描述:简要说明提示词的用途。
  5. 系统提示词:输入 AI 系统相关的指令提示。
  6. 默认提示词:设置当用户不提交内容时默认采用的提示内容。
  7. 点击 “保存”完成添加;点击“重置”清空已填信息;点击“返回”回到提示词管理列表。

修改提示词

修改提示词

  1. 在“后台面板 / 提示词管理” 列表中,点击对应提示词操作栏的编辑按钮,进入修改界面。
  2. 可对名称、描述、系统提示词、默认提示词等进行修改。系统提示词虽可修改,但不建议随意变动。注意提示词中支持 “~typelist~”(栏目列表)和 “~articleInfo~”(原文档信息)等变量。
  3. 点击“保存” 应用更改;点击 “重置” 放弃修改;点击 “返回” 回到提示词管理列表。

预览提示词

修改提示词

  1. 点击提示词操作栏的预览按钮,进入 “后台面板 / 提示词管理 / 预览提示词” 界面。
  2. 名称:显示提示词名称。
  3. 提示词:可输入或查看默认的提示内容。
  4. 选择模型:从下拉框中选择用于生成结果的 AI 大模型,如 “qwen - plus (通义千问)” 。
  5. 点击 “AI 生成” 获取结果,结果将显示在下方 “结果” 框内;点击 “返回” 回到提示词管理列表。

注意

  • 添加提示词标识时,需遵循英文和数字组成的规则,确保其唯一性。
  • 删除提示词操作需谨慎,避免影响相关业务功能的正常使用。

调用日志管理

调用日志列表功能,用于记录和管理智能助手的使用情况,帮助管理员查看每次调用的相关信息,便于分析使用状况、排查问题和进行数据统计。

调用日志管理

查看调用日志

进入 “后台面板 / 调用日志列表” 界面,可查看调用日志列表,每条日志包含以下信息:

  1. 选择:复选框,可勾选单个或多个日志条目。
  2. 管理员:执行调用操作的管理员账号。
  3. 标识:提示词的标识,如 “tools_translate”“article_edit” 等。
  4. 模型版本:调用所使用的 AI 大模型版本,如 “qwen-plus”。
  5. 提示词:本次调用输入的提示词内容。
  6. 地址:发起调用的 IP 地址,格式如 “::1” 。
  7. 时间:调用发生的具体时间,格式为 “年月日 时分秒”。
  8. 提示:可能代表提示相关的计数或数据(具体含义可根据系统进一步确认)。
  9. 补全:可能表示补全内容相关的计数或数据。
  10. 消耗:此次调用所消耗的资源数值(如计算资源、 tokens等。

搜索功能

  1. 在“请输入ip地址”输入框中输入IP地址,可按IP筛选相关日志。
  2. 旁边的两个下拉框可分别选择筛选条件(当前显示为“全部”),具体筛选内容未完全明确,推测可按管理员、标识等进行筛选。
  3. 点击“搜索”按钮执行筛选操作;点击“重置”按钮清空输入和筛选条件,恢复显示全部日志。

日志操作

  1. 反选:点击 “反选” 按钮,可反向选择当前列表中的日志条目。
  2. 删除:勾选需要删除的日志条目后,点击 “删除” 按钮,可删除选中的日志。
  3. 清空:点击 “清空” 按钮,可删除列表中的所有日志。

注意

  • 执行删除或清空操作时请谨慎确认,避免误删重要日志信息。
  • 对于 “提示”“补全”“消耗” 等数据的具体含义,可进一步参考系统详细说明或咨询技术支持人员。

内容生成

目前我们可以在添加栏目、修改栏目、批量添加栏目、添加文档、修改文档这几个地方可以进行AI内容生成,具体可以参考下图:

内容生成

您只需要填写提示词即可,系统会自动生成内容,您只需要填写好提示词,然后点击生成即可。当然也可以结合上面提示词管理来对生成效果优化,以达到您最希望的效果。