ADP Chat Client 简介

概览

ADP-Chat-Client 是一款开源的智能体对话端解决方案。提供​​开箱即用的前端界面（支持灵活定制）​​与​​稳定可靠的后端服务​​。您可以使用该项目将由腾讯云智能体开发平台（Tencent Cloud ADP）开发的智能体应用快速部署为 ​​Web 应用​​，或无缝嵌入 ​​小程序、Android、iOS 等多端场景​​，直接复用平台已有的流程与架构，无需重复开发基础功能。

系统内置实时对话、对话历史、语音输入、图片理解等能力，并支持第三方身份体系对接（OAuth / URL 跳转）。前端采用 TDesign 组件体系，支持主题和交互自定义；后端支持通过 Docker 快速部署，降低集成与运维门槛。

为什么选择 ADP-Chat-Client

• 5 分钟上线：Docker 一键部署，免去繁琐的环境与模块对接流程，加速从研发走向上线。
• 零门槛复用 ADP 能力：直接对接 ADP 的成熟能力（自然语言处理、多模态交互、知识库/RAG、工作流等），无需重复造轮子。
• 企业级全链路：账户体系、审计合规、对话数据持久化与检索、HTTPS/反代部署——覆盖从体验到治理的完整链路。

核心能力

• 多端交付：Web 首发，可嵌入小程序 / Android / iOS。
• 实时对话：稳定连接 ADP 智能体，支持文本、图文混合交互。
• 对话管理：自动持久化，按用户 / 应用 / 时间分维度管理，可检索和导出（支持对接 PostgreSQL 等数据库）。
• 语音输入：接入腾讯云 ASR（WebSocket），提供 < 800 ms 级别的低延迟体验。
• 图片理解：对话中上传并解析图片，实现自然的多模态对话。
• 账户体系对接：支持 GitHub、Microsoft Entra ID（OAuth），或通过 URL 跳转轻量接入自建账号系统。
• 主题与 UI：基于 TDesign，快速换肤与组件扩展。
• 容器化部署：Docker 封装，环境可复用、易迁移，方便灰度与回滚。

核心组成

1. 前端

• 技术栈：Vue 3（Composition API）+ TypeScript + TDesign
• 特点：
  • 高复用的组件体系，易维护、可拓展
  • 支持主题色、字号、交互行为等个性化设置
  • 适配企业内嵌场景（iFrame / WebView / 小程序 Web 化容器等）

2. 后端

• 技术栈：Python（Sanic）
• 职责：
  • 统一 router 对外暴露 HTTP 接口
  • core 封装对 ADP 及第三方服务的调用
  • middleware 处理鉴权、审计、限流、日志等治理能力
  • config 统一管理密钥与多环境参数
  • 持久化：对话记录、用户态可接入 PostgreSQL 等数据库

账户体系对接

两种登录方案帮助你适配不同的企业 IT 环境：

1. OAuth

GitHub OAuth 与 Microsoft Entra ID OAuth 免改造接入，在 .env 中配置即可。需要扩展其他 OAuth 平台，可参照 server/core/oauth.py 的适配逻辑。
优势： 改造成本低，账号与权限统一，满足审计与合规需求。

2. URL 跳转

若暂时无法提供标准 OAuth，可使用更轻量的 URL 跳转方案：

1. 既有系统生成携带 CustomerId、Name、ExtraInfo、Timestamp、Code 的登录 URL。
2. 用户点击后登录。
3. ADP-Chat-Client 校验签名、自动创建/绑定账户，并建立会话。

架构一览

下一步

已经了解 ADP-Chat-Client 的定位与能力？继续查看 快速开始，完成本地或服务器部署。