Wagtail 集成
在你的 Wagtail 网站上回答问题的 AI 助手
概述
Wagtail 包在你的网站上放一个 AI 助手。聊天按钮位于每个页面的角落，访客用自己的话提问，答案来自你自己的内容：你的网站、你上传的文档和你的帮助文章。
AI 声明： 你网站上的答案由 AI 生成。它们有时可能不准确或不完整。在依赖它们之前请先核实，尤其是做重要决定时。
工作原理
这个包添加一个中间件，在每个页面的结束 body 标签前放一段小脚本。脚本等页面加载完成后，再从 Asyntai 取聊天组件，因此你的网站先绘制，页面速度不变。你的服务器从不与 Asyntai 通信，只有访客的浏览器会。
你不需要改动任何模板。中间件不碰 Wagtail 后台，也不碰任何不是 HTML 页面的内容。
要求
- 一个 Asyntai 账户。免费套餐足以开始使用。
- Wagtail 网站，版本 5.2 或更新，运行 Django 4.2 或更新、Python 3.9 或更新。
- 对该网站代码的访问权限，因为你要安装一个 Python 包。
安装
按以下步骤把 Asyntai 添加到你的 Wagtail 网站：
安装这个包
从 Python Package Index 安装，装在与你网站相同的环境里：
pip install wagtail-ai-chatbot
把它加入设置
把应用和 Wagtail 设置模块加入 INSTALLED_APPS，把中间件放在 MIDDLEWARE 的最前面：
INSTALLED_APPS = ["wagtail_asyntai", "wagtail.contrib.settings", ...]
MIDDLEWARE = ["wagtail_asyntai.middleware.AsyntaiWidgetMiddleware", ...]
运行迁移
这会创建保存你设置的数据表：
python manage.py migrate wagtail_asyntai
粘贴您的小部件 ID
在 Wagtail 后台打开 Settings，然后是 Asyntai chat assistant。粘贴你的组件 ID 并选择 Save。你可以在 Asyntai 控制台的 Setup & Integration 部分找到这个 ID。你可以粘贴整段代码，包只保留 ID。
提示： 发布前，请在 Asyntai 后台添加你的文档、问答和说明，这样助手从第一位访客起就能答得准确。
设置
- 组件 ID：只要这个字段填有有效的 ID，聊天就开启；字段为空时关闭。
- 只向未登录访客显示聊天：已登录的用户看不到聊天。当助手是为尚未注册的人准备时，这很有用。
- 组件脚本地址：除非 Asyntai 支持团队要求你修改，否则请保持这个值不变。
设置按站点分开，因此从一个 Wagtail 安装提供多个站点的项目，可以给每个站点各自的助手。
在设置文件中的设置
把配置放在环境变量里的项目可以跳过后台，直接在代码中设定这些值。两边都填时，以后台为准。
ASYNTAI_WIDGET_ID = "asyntai_ab12cd34"
另外三个值是可选的：ASYNTAI_SHOW_TO_ANONYMOUS_ONLY、ASYNTAI_SCRIPT_URL 和 ASYNTAI_SKIP_PREFIXES。最后一个列出组件永不触碰的路径，当你的后台不在 /admin/ 时需要它。
手动放置组件
如果你想自己选位置，就不用中间件，把标签放进你的基础模板。标签和中间件从不同时生效，所以两者都保留也没问题。
{% load asyntai %} ... {% asyntai_widget %}
助手能做什么
- 立即回答访客的问题，全天候，在每个页面上
- 用 80 多种语言回答，语言由问题自动识别
- 访客在页面之间切换时保持打开
- 使用您上传的文档、常见问题和指令给出准确的回答
隐私
这个包只在页面上发布两个值：组件 ID 和脚本地址。关于你的页面或你的用户的任何内容都不会发送给 Asyntai。只有访客的浏览器与 Asyntai 通信，而且只在访客打开聊天时。
套餐与价格
Wagtail 集成在所有 Asyntai 套餐中都可用，包括免费套餐。每个套餐包含每月的消息额度，由你的所有渠道和集成共用。 查看定价.
卸载
清空组件 ID 字段即可关闭聊天。要移除这个包，把中间件和应用从设置中去掉，再用 pip 卸载。
源代码
这个包是自由并开源的，采用 MIT 许可证。你可以在 GitHub 上阅读每一行。
需要帮助？
如果您有任何问题或遇到困难，请通过 [email protected] 联系我们。