深流AI-文档

渠道

管理面向访客的 Web SDK 渠道，绑定 Agent，配置会话页或嵌入式接入，并自定义访客端窗口样式。

简述

渠道当前提供 Web SDK 接入形态：每一条渠道对应一组访客可访问的会话能力，需绑定租户内可用的 Agent。配置完成后，可按 URL 模式分发独立会话页链接，或按嵌入 SDK 模式获取站点嵌入代码；同时支持自定义头部、气泡与配色等品牌样式。

功能位置

打开 系统管理 → 渠道，入口自动进入 Web SDK 渠道列表；页面标题为渠道。

渠道列表：Web SDK 表格与新建按钮

配置与规则

列表

表格列：名称、描述、操作。点击行任意位置进入编辑页；操作列提供编辑与删除图标。

  • 新建 Web SDK：跳转「新建 Web SDK」表单页。
  • 删除：弹出窗口「删除 Web SDK」，确认按钮文案为「确定删除」。成功后提示「已删除」。

新建 Web SDK

表单字段：

  • 名称：必填，最长 64 字符；
  • 描述：选填，最长 500 字符。

主按钮「下一步」创建成功后提示「已创建」，并进入该渠道的编辑页；「取消」返回列表。

编辑渠道

顶部展示返回列表与标题「编辑：{名称}」，右侧为保存按钮。未保存离开时若表单有改动会弹出确认。

渠道编辑：接入模式与 Agent 绑定示意

主要分区：

  1. 接入模式

    • URL 模式：展示会话页链接只读框与「复制链接」；链接随控制台当前访问域名自动生成。
    • 嵌入 SDK 模式：展示嵌入代码深色预览块与「复制代码」；脚本地址与初始化示例同样基于当前域名拼接。

  2. Agent 选择
    下拉「请选择 Agent」，选项来自当前租户可用 Agent 列表；保存时会写入绑定关系。

  3. 窗口外观
    URL 模式下额外提供网页图标与浏览器标签标题配置；两种模式均包含头部标题、PC / 移动端 Logo、配色、消息区背景、气泡圆角与颜色、空状态配图、侧栏底部公司与外链文案等字段，可通过上传或取色器逐项调整。

  4. 对话行为
    提供输入框占位文案等访客侧文案配置。

注意事项

  • 删除渠道会使既有会话入口失效，请先迁移流量再执行删除。
  • 更换绑定 Agent 会影响新会话使用的模型与工具配置；进行中的会话策略以实现为准，建议在低峰切换。
  • 嵌入代码依赖站点允许加载外部脚本；若使用内容安全策略，需将控制台同源脚本列入许可名单。

与其他功能的关系

  • Agent 列表：仅可选择处于启用状态的 Agent；停用 Agent 将影响访客侧可用性。
  • 会话记录：访客通过渠道发起的会话在列表中以对话窗口或嵌入式等来源展示，便于对照渠道配置。

业务场景示例

官网浮动客服窗

角色与目标
市场负责人希望在官网右下角挂载与 PC 站点视觉一致的聊天浮窗。

系统配置
创建 Web SDK 渠道并选用嵌入 SDK 模式，复制嵌入代码交给前端部署；在窗口外观分区上传 Logo、设置气泡颜色与浮层按钮配色以贴合品牌。

场景效果
访客无需跳转即可完成提问；运营可在 会话记录 中依据来源筛选复盘客服表现。

示意