这个品类的数据长什么样
多应用路由的数据主要来源于平台内已配置的子应用元数据、流量分配规则、会话透传配置三类。数据更新节奏为按需触发，当子应用上下线、流量规则调整或会话透传字段变更时同步更新。单条路由数据的文档结构包含路由唯一标识、绑定的子应用ID列表、流量分配比例数组、会话透传字段集合、权限范围配置。其中route_id为字符串类型，app_ids为字符串数组，traffic_split为数值数组，session_expire单位为秒。
这些特征在「分享与嵌入」这一环带来什么约束
由于多应用路由绑定多份子应用元数据，分享与嵌入环节需传递路由唯一标识，不应使用单个子应用ID，否则无法触发预设的流量分配逻辑。会话透传字段的存在要求嵌入代码需携带对应参数，否则跨子应用的会话流转会出现上下文丢失。流量分配规则的动态更新特性，要求嵌入配置不能硬编码子应用，需始终绑定路由标识以适配规则变更。权限范围配置则限制了分享嵌入的访问边界，免登录页面的权限需与路由配置的权限范围保持一致，否则会出现访问拦截。会话过期时间的配置会直接影响嵌入后会话的有效时长，需与业务场景的会话周期匹配。
配置怎么定
| 配置项 | 建议取法 | 这样取的依据 |
|---|---|---|
route_id | 平台生成的唯一路由标识字符串 | 绑定目标路由配置，确保流量分配与会话透传逻辑正常触发 |
enable_session_pass | true（跨应用会话场景）或false（单应用临时场景） | 开启后可传递会话上下文至所有绑定子应用，避免上下文丢失 |
share_expire_time | 3600 秒（或按业务场景调整） | 控制分享链接的有效时长，匹配业务会话周期 |
force_language | zh-CN、en或按实测标定 | 统一嵌入页面的显示语言，避免多语言适配偏差 |
disable_voice_input | false（按需开启） | 控制免登录页面的语音输入功能，适配业务场景的交互需求 |
本页给出的参数取值均为常规建议，用于确定配置的起点。实际取值受材料形态、数据量与业务规则影响，具体问题需具体分析，建议在自有样本上实测后再定。
容易做错的三处
- 现象：嵌入后无法触发多应用流量分配，仅跳转至单个子应用。原因：嵌入代码中使用了子应用ID，未使用
route_id作为绑定参数，未正确关联路由配置。 - 现象：免登录页面的语音输入无响应或秒数显示为00:00。原因：未正确配置
disable_voice_input参数，或嵌入代码未携带路由权限相关的校验参数，导致语音输入功能被拦截。 - 现象：跨子应用会话上下文丢失，无法延续对话逻辑。原因：未开启
enable_session_pass参数，或嵌入代码未传递会话透传字段，导致上下文无法在子应用间流转。
怎么确认配好了
- 打开嵌入后的页面，检查地址栏中的路由参数是否包含
route_id，确认绑定的是目标路由配置。 - 发起跨子应用的对话，检查会话上下文是否在不同子应用间正常延续，确认
enable_session_pass配置生效。 - 调整
force_language参数后刷新页面，检查页面显示语言是否符合预设值，确认语言配置生效。 - 测试语音输入功能，检查是否能正常触发并显示输入时长，确认语音输入配置符合业务需求。
问题素材取自公开社区提问（2026-09-11 去重 4,834 条）。文中的配置项名称与取值区间需以所用版本的实际界面与文档为准；本页核验日 2026-09-14，当时的最新发布版本为 FastGPT v4.17.0。