AI 聊天助手插件

插件简介

本插件将大语言模型能力集成到 Hertz System 中，为系统增加「会聊天的助手」，既可以回答通用问题，也可以基于企业知识库给出更准确的回答。

• 支持按会话上下文进行多轮对话；
• 可接入企业内部知识库，实现基于文档的问答；
• 预留工具调用接口，可扩展为“帮我创建工单”“帮我查某个任务”等自动化能力。

安装步骤

1. 后端安装（Django）

在部署 Hertz System 的后端虚拟环境中，通过公司私有 PyPI 源安装插件依赖：

pip install hertz-studio-django-ai -i https://username:password@hzpypi.hzsystems.cn/simple/

安装完成后，在项目的 settings.py 中注册应用：

INSTALLED_APPS += [
    "hertz_studio_django_ai",
]

保存配置并重新启动后端服务，使插件生效。

2. 前端集成

在管理端界面增加「AI 助手」入口（如右下角悬浮按钮或顶部导航菜单项），并挂载到聊天窗口页面。

前端通过调用后端提供的聊天接口，将用户输入和会话上下文转发给插件，实现对话能力。

3. 配置模型与知识库

在 .env 或后台配置中心中设置大模型 API 地址、访问密钥，以及知识库检索接口等参数。

根据需要为不同环境（开发 / 测试 / 生产）配置对应的模型与知识库，以保证回答质量和数据安全。

使用教程

1. 配置知识库来源

在后台配置中选择需要接入的知识库（如“知识文章管理插件”中的文档），并完成索引。

2. 设计常用问题入口

根据业务场景，为 AI 助手预设若干快捷问题或提示语，引导用户更好地提问。

3. 联通业务操作

如有需要，可为 AI 助手接入工单、任务等接口，实现通过聊天触发简单操作。