安装指南

如何在 WordPress 安装 Kedo AI 客服挂件

使用全站挂件代码把 Kedo 安装到 WordPress 网站，验证加载和问答是否正常，并排查脚本、缓存、权限、内容安全策略与安装位置等常见问题，适用于区块主题和开发者维护的子主题。

更新日期：2026 年 8 月 30 日

每个已发布的 Kedo 应用都会生成一段嵌入代码。将它添加到网站全局页脚一次，然后在无痕窗口检查入口，并测试一条能够从知识库找到来源的回答。

开始之前

需要一个已发布的 Kedo 应用、修改 WordPress 全站代码的权限，以及清理页面缓存或 CDN 缓存的权限。

客服挂件通常应在所有目标页面加载。可以使用可信的页眉/页脚代码工具、允许脚本的区块主题页脚，或由开发者通过 WordPress wp_footer hook 添加。

从 Kedo 完整复制，不要修改 token、Agent 标识、脚本地址、引号或加载顺序。

有预发布环境时先在那里验证。生产环境尽量选择低流量时段，并保留能够立即移除代码的回滚方式。

01
发布 Kedo 应用
在 Kedo Console 打开“应用”，选择助手，检查知识库和 Agent 设置，然后发布。
02
复制安装代码
进入应用的安装或部署区域，复制 Kedo 显示的完整挂件代码。
03
添加到 WordPress 全局页脚
把代码粘贴到网站可信的全站代码位置。开发者维护的子主题可通过 wp_footer hook 输出；Custom HTML 区块只有具备 unfiltered_html 权限的用户才能保留 script。
04
清缓存并验证
清理 WordPress、优化插件、CDN 和浏览器缓存。在无痕窗口访问多个页面，打开挂件，并询问一个知识库明确包含答案的问题。
05
在 Kedo 检查会话
返回 Kedo 收件箱，确认测试会话、语言、回答和来源信息都已正常记录。

看不到挂件入口

确认应用已发布，在最终页面源码中搜索代码，清理全部缓存，并检查浏览器控制台和 CSP 拦截。

WordPress 自动删除脚本

账号可能缺少 unfiltered_html 权限，或安全工具进行了清理。改用管理员批准的全站代码方式，或请开发者通过 wp_footer 添加。

只有一个页面显示

代码可能被放进了单页正文。请移动到全局页脚或全站模板。

挂件出现但无法回答

检查应用状态、知识同步、域名限制和套餐 credits 是否仍然可用。

连接文档、发布应用，并把 Kedo 生成的代码安装到网站。