[3Chat_Copilot]解决方案_v1

行业解决方案
1

3Chat Copilot 使用说明

image
image1647×1322 176 KB

概述：
1.通过"回复策略"设置为accountId 不包含 copilot控制：不回复User的消息。传上下文时，以copilot_{accountId}作为对话的userId，可以回复3Chat_Copilot的消息。
2.关闭“记忆”功能。
3.配置方式参考：[3Chat_panel]在客户接待工作台控制 AI 上下线与联系人画像 配置栏填入url为：https://assets.xinheyun.com/custom_html/3chat_copilot.html?oauth={Oauth_token}

1. 系统简介

3Chat Copilot 是一个用于私聊场景的 AI 回复辅助工具。

它会读取当前会话信息和最近聊天上下文，将有效的用户/客服消息提交给 Copilot Agent，生成回复建议，并展示在侧边栏中供用户复制使用。

主要能力：

  • 自动识别当前聊天对象和会话
  • 自动读取最近一次 Copilot 回复建议
  • 支持自定义上下文消息数（1～30 条，默认 30 条）
  • 一键生成新的 AI 回复建议
  • 支持复制单条建议回复
  • 保留最近 100 条接口执行日志，便于排查问题

当前仅支持私聊，暂不支持群聊。

2. 系统逻辑

flowchart TD
    A[打开 Copilot 侧边栏] --> B[读取当前聊天信息]
    B --> C{是否为私聊?}

    C -- 否 --> D[提示暂不支持群聊]
    C -- 是 --> E{OAuth / 会话信息是否完整?}

    E -- 否 --> F[提示配置或会话信息异常]
    E -- 是 --> G[查询 Copilot 会话]
    G --> H[读取最近 Copilot 历史]
    H --> I[展示最近用户消息及回复建议]

    I --> J{用户点击“生成建议回复”?}
    J -- 否 --> I
    J -- 是 --> K[读取当前会话最近 N 条消息]

    K --> L[整理 user / assistant 上下文]
    L --> M[提交给 Copilot Agent]
    M --> N{是否生成有效回复?}

    N -- 否 --> O[显示错误并记录日志]
    N -- 是 --> P[展示新的回复建议]
    P --> Q[用户复制回复使用]
    P --> R[同步刷新 Copilot 最新历史]

3. 使用方法

  1. 进入客户私聊会话，打开 3Chat Copilot 侧边栏。
  2. 系统会自动读取当前联系人、会话信息及最近的 Copilot 回复建议。
  3. 根据需要设置“上下文消息数”，建议保持默认值 30。
  4. 点击“生成建议回复”。
  5. 等待系统生成回复建议后，选择合适内容并点击“复制”。
  6. 如遇异常，可查看页面底部“接口执行日志”辅助排查。

4. 使用注意事项

  • 仅支持私聊，不支持群聊。
  • 页面必须携带有效的 oauth 参数，否则无法调用接口。
  • 回复质量会受到聊天上下文完整度影响。
  • 上下文最多读取 30 条消息。
  • 如果自动复制受浏览器限制，系统会弹出文本框供手动复制。