与 Docusaurus 集成
本页介绍如何将 FormAgent.ai 集成到 Docusaurus 网站。集成后，Docusaurus 站点访客可直接体验 AI 助手服务。
前提条件
- 已搭建好 Docusaurus 项目
- 已注册 FormAgent.ai 账号
- 已获取 Agent ID
集成步骤
1. 配置 docusaurus.config.js
打开 docusaurus.config.js 文件，添加或编辑 scripts 配置如下：
const config = {
title: 'Your Site',
scripts: [
{
id: 'formagent-script',
src: 'https://formagent.ai/embed.js',
async: true,
defer: true,
'data-agent-id': 'YOUR_AGENT_ID', // 从 FormAgent.ai 获取的 Agent ID
},
],
// 其他配置
presets: [
// ...
],
};
module.exports = config;
2. 配置说明
| 参数 | 说明 |
|---|---|
id | 脚本唯一标识 |
src | FormAgent.ai 嵌入脚本的URL |
async | 启用脚本异步加载 |
defer | 启用脚本延迟加载 |
data-agent-id | 从 FormAgent.ai 获取的 Agent ID |
功能验证
- 保存配置后，重新构建 Docusaurus 站点：
npm run build
- 启动开发服务器进行验证：
npm run start
- 在浏览器中打开站点，确认 FormAgent.ai 聊天组件是否正常显示。
故障排查
聊天组件未显示时
- 检查浏览器控制台是否有报错信息
- 确认 Agent ID 设置是否正确
- 在网络面板确认
embed.js是否加载成功
支持
如遇无法解决的问题，可通过以下方式获取支持：
- 邮箱：[email protected]
- 在线聊天：控制台内置聊天支持
- 文档：FormAgent.ai 文档