故障排查官方文档3 分钟阅读聚合导航页

FastGPT 对外分享:链接与嵌入怎么选

依据 FastGPT v4.17.2 官方文档,梳理分享链接、免登录窗口与 iframe 嵌入的适用场景,并给出三列比较表,列出选择前需要核对的配置项。

FastGPT 应用发布后,对外提供访问主要有分享链接、免登录窗口和 iframe 嵌入三种方式。分享链接适合把对话页直接交给外部用户,免登录窗口适合在已有页面里弹出对话,iframe 嵌入适合把对话作为页面的一部分长期存在。三者都来自同一套发布配置,选择时先看访问入口在哪里,再核对登录、域名与权限相关设置。

分享链接:把对话页直接给外部用户

分享链接是发布渠道中最直接的一种。在 FastGPT 的发布配置里,应用可以生成一个对外可访问的地址,把该地址发给外部用户,对方在浏览器中打开即可进入对话页。这种方式适合把应用当作一个独立页面来使用,例如把地址放在通知、文档或即时通讯工具里,让用户自行打开。它的特点是入口单一,用户看到的就是完整的对话界面,不需要宿主页面承载。使用前需要核对应用的发布状态,确认该渠道已经开启,并检查访问权限相关的设置,避免地址被非预期的人拿到。分享链接不涉及宿主页面的改造,因此对外分享时改动最小。若应用需要区分不同用户,还要确认登录方式与身份识别是否已经配置,否则所有访问者会以同一身份进入对话,影响后续的会话管理。

免登录窗口与 iframe 嵌入的差别

免登录窗口和 iframe 嵌入都发生在宿主页面里,差别在于对话以什么形态出现。免登录窗口通常由页面上的按钮或浮层触发,用户点击后在当前页面弹出对话区域,不需要跳转到新地址,也不需要单独完成登录流程。它适合把对话作为辅助功能放在页面角落,用户在有疑问时随手唤起。iframe 嵌入则是把对话页作为一个内嵌区域放进宿主页面,页面布局需要为它预留位置,用户看到的是页面的一部分。它适合对话本身就是页面主要内容的场景,例如帮助中心或产品说明页。两者都需要核对宿主页面与 FastGPT 之间的配合:免登录窗口要确认触发方式与窗口挂载位置,iframe 嵌入要确认允许嵌入的域名以及页面宽高、滚动行为。跨域与登录态传递在两种方式中都需要提前验证,避免出现对话加载失败或身份不一致的情况。

选择时先定入口再核对配置

判断用哪种方式,可以先回答一个问题:用户从哪里进入对话。如果用户拿到的是一个独立地址,分享链接最合适;如果用户已经在某个页面里,只是需要随手唤起对话,免登录窗口更贴合;如果对话需要长期占据页面的一块区域,iframe 嵌入更自然。确定入口之后,再回到发布配置逐项核对。需要核对的内容包括渠道是否开启、访问权限如何设置、登录与身份识别是否配置、允许嵌入的域名是否填写、宿主页面的宽高与滚动是否合适。同一应用也可以同时配置多种渠道,分别服务不同入口,但要确认各渠道的权限设置保持一致,避免出现某个入口可以访问、另一个入口被拦截的情况。对外分享前,建议先用一个外部账号实际打开一次,确认加载、登录与对话流程都能走通,再正式分发地址或上线嵌入页面。

References