Skip to main content

平台接入概览

PAI 采用统一消息处理架构,所有平台的入站消息都会被标准化为 UnifiedMessage 格式,经过核心 AI 管线处理后,再通过 UnifiedSender 路由到对应平台发送响应。 这种设计使得新增平台只需实现两个适配层:消息解析(入站)和消息发送(出站),无需修改核心逻辑。

统一消息格式

UnifiedMessage

所有平台的入站消息都会被转换为 UnifiedMessage,确保核心处理管线与平台无关。
string
required
平台标识符,如 telegramwechatqqfeishuminiappweb
string
required
消息文本内容
list[str]
消息中包含的图片 URL 列表,用于多模态处理
string
平台原始消息 ID,用于消息追踪和去重
string
消息事件时间戳
dict
平台原始消息数据,保留完整上下文供特殊处理使用

UnifiedSender

UnifiedSender 负责将 AI 生成的响应路由到正确的平台发送。根据 platform_id 自动选择对应的平台发送器。

支持平台一览

所有平台均通过 Webhook 或轮询方式接收消息,经统一消息格式处理后进入相同的 AI 管线。

消息处理流程

1

接收消息

各平台通过 Webhook 或 WebSocket 将消息推送到后端对应的端点
2

消息标准化

平台适配器将原始消息解析为 UnifiedMessage 格式
3

AI 处理

统一消息进入 LangGraph 工作流,经 Router 节点路由到对应功能节点处理
4

响应发送

UnifiedSender 根据 platform_id 将响应路由到正确的平台发送器

快速导航

Telegram

Bot API 接入,推荐首选

微信

GeWeChat 桥接接入

QQ

OneBot 协议接入

飞书

企业级事件订阅

小程序

微信小程序客户端

Web

React SPA 前端