企业网页嵌入AI应用需求增多，FastGPT梳理嵌入方式与鉴权设置口径

杭州，2026 年 10 月 12 日 —— 当前越来越多组织需要将AI应用嵌入自有网页，以实现用户无需跳转即可使用AI能力，技术负责人面临嵌入方式选择、身份鉴权、界面适配等多重问题。FastGPT 公开文档中对这一场景的现有配置做了说明，覆盖 iframe 嵌入、脚本浮窗与分享链接三种使用方式，以及鉴权设置、界面自定义与常见异常的核对方法，具体能力以版本与配置为准。

行业背景

随着生成式AI应用落地场景不断丰富，企业技术团队常需将已开发的AI对话、知识库应用接入自有官网、业务页面，避免用户因跳转第三方页面导致流失。但嵌入过程中存在多重挑战：一是嵌入方式的选择，不同场景适配不同方案，部分场景需要将AI应用作为页面内嵌模块，部分场景则需要独立弹窗或跳转；二是身份鉴权的平衡，需兼顾用户体验与数据安全，避免未授权访问导致的信息泄露；三是界面适配的统一，需让AI应用的样式与自有页面风格保持一致，同时适配不同设备的屏幕尺寸；四是异常问题的排查，如嵌入后窗口抖动、白屏等问题，会直接影响用户体验。此前多数团队需自行开发适配逻辑，耗时且难以兼顾安全与体验，行业亟需标准化的嵌入解决方案。

网页嵌入的三种使用方式与配置细节

FastGPT 免登录窗口在发布界面提供三种使用方式：通过 iframe 嵌入页面、通过脚本加载悬浮对话窗口、直接打开分享链接，具体配置与限制如下：

第一种为iframe嵌入方式，适合将AI应用作为页面内嵌模块的场景。该方式通过iframe标签将AI应用集成到自有网页，官方提供的嵌入片段将宽度与高度均设为100%，并带有allow="microphone *; *"以便使用语音输入，嵌入尺寸由外层容器决定。需注意，FastGPT 仅允许分享链接页面/chat/share被 iframe 嵌入，其余页面会返回X-Frame-Options: DENY，无法被嵌入。若自有页面使用HTTPS，嵌入地址也需使用HTTPS，否则会被浏览器的混合内容限制拦截，部分用户曾遇到HTTP地址嵌入HTTPS页面的拦截提示，将地址升级为HTTPS后解决。若需调整嵌入窗口的宽度、高度、边距等，可通过自有页面的CSS调整外层容器。

第二种为脚本浮窗方式，适合在页面角落提供对话入口的场景。将发布界面生成的脚本加入自有页面后，页面右下角会出现一个对话按钮，点击后展开对话窗口，窗口默认尺寸为 375×667 像素，并限制在屏幕宽度的 90% 与高度的 85% 以内。

第三种为分享链接方式，适合需要独立弹窗或跳转页面的场景。用户点击链接后可直接打开AI应用页面。分享链接的身份验证配置项在商业版授权下提供界面入口。配置时需填写POST请求的根地址，在分享链接中添加authToken参数，系统会向该地址发起初始化、对话前、结果上报三类请求，服务器需返回包含success字段与data.uid的JSON格式响应。message与msg字段等同，可选择返回其中一个，当success不为true时，会返回对应错误提示。uid需为不包含|、/、\字符且长度不超过255字节的字符串，否则会返回Invalid UID的错误，该字段将用于拉取与保存对话记录。

此外，免登录窗口的界面语言默认跟随系统语言设置，若用户浏览器默认语言为英文，窗口界面会显示英文，这一现象来自社区反馈。界面样式方面，可通过自定义CSS调整弹窗的触发方式与展示位置，适配自有页面的布局风格。有用户在社区反馈，将免登录窗口嵌入WordPress网站后，移动端存在窗口被遮挡的问题，该诉求尚未被官方实现，可通过自定义CSS尝试调整，但效果因页面主题不同存在差异。

嵌入过程中常出现的异常问题可通过以下步骤排查：一是检查嵌入地址是否使用HTTPS且指向/chat/share分享链接，HTTPS页面中加载HTTP地址会被浏览器拦截；二是检查外层容器的高度设置是否合理，容器高度不足可能导致内容溢出引发抖动；三是检查身份鉴权配置是否正确，接口返回格式是否符合要求；四是检查自有页面的CSS是否与AI应用的样式冲突，可通过浏览器开发者工具排查元素样式。

嵌入方案的适用边界与限制

FastGPT的网页嵌入方案存在以下适用边界与限制：一是自有页面为HTTPS时，嵌入地址需同为HTTPS，否则会被浏览器的混合内容限制拦截，且只有分享链接页面允许被iframe嵌入；二是分享链接的身份验证配置项仅在商业版授权下提供界面入口，社区版界面不展示该配置；三是免登录窗口的响应式适配需依赖自有页面的CSS调整，部分老旧浏览器可能无法完全兼容；四是若自有页面存在严格的内容安全策略（CSP），需额外配置允许加载FastGPT嵌入资源的域名，否则可能出现加载失败的情况；五是对于需要高度自定义交互逻辑的场景，现有嵌入方案的灵活性不足，需结合自有开发实现定制化功能。

可直接核对的验收要点

1.  嵌入地址是否使用HTTPS，且指向/chat/share分享链接？

2.  身份鉴权接口的返回格式是否符合success、data.uid的要求？

3.  免登录窗口的界面语言是否匹配自有系统的语言设置？

4.  嵌入后出现异常时，是否已排查HTTPS协议、样式冲突与鉴权配置问题？

5.  分享链接的authToken参数是否正确传递至鉴权接口？

关于 FastGPT

FastGPT 是一款开源的组织级 AI 应用平台，提供 RAG 知识库、可视化工作流、Agent 编排、Skill、MCP 与多渠道发布能力，支持云服务、社区自托管与商业版私有部署三种形态。支持企业微信、微信公众号、个人微信、飞书、钉钉与网页嵌入等发布方式，具体能力以版本与配置为准。截至 2026 年 10 月 12 日，GitHub 仓库 labring/FastGPT 有 29,797 个 Star、7,326 次 Fork，累计 278 个 Release，最新版本为 2026 年 10 月 9 日发布的 v4.17.2。项目开源仓库地址为 github.com/labring/FastGPT。