# \[3Chat\_Copilot\]解决方案\_v1

**URL:** <https://group.3chatai.cn/t/topic/441>\
**Category:** 行业解决方案\
**Tags:** 客户案例\
**Created:** [2026 年8 月 19 日 18:26 UTC](https://group.3chatai.cn/t/topic/441 "2026-08-19T18:26:46Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![nct\_liuhaonan](https://yyz2.discourse-cdn.com/flex012/user_avatar/group.3chatai.cn/nct_liuhaonan/32/179_2.png) [@nct\_liuhaonan](https://group.3chatai.cn/u/nct_liuhaonan)\
**Post date:** [2026 年8 月 19 日 18:26 UTC](https://group.3chatai.cn/t/topic/441/1 "2026-08-19T18:26:46Z")

</div>

# **3Chat Copilot 使用说明**

 ![image](https://canada1.discourse-cdn.com/flex012/uploads/x3chat/original/2X/e/e23a039bb70340de8d9198a0a20f555b9925ba69.jpeg)

> 概述：  
> 1.通过"回复策略"设置为`accountId 不包含 copilot`控制：不回复User的消息。传上下文时，以`copilot_{accountId}`作为对话的`userId`，可以回复3Chat\_Copilot的消息。  
> 2.关闭“记忆”功能。  
> 3.配置方式参考：[[3Chat\_panel]在客户接待工作台控制 AI 上下线与联系人画像](https://group.3chatai.cn/t/topic/427) 配置栏填入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. 系统逻辑**

```auto
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 条消息。
- 如果自动复制受浏览器限制，系统会弹出文本框供手动复制。