平台接入概览
PAI 采用统一消息处理架构,所有平台的入站消息都会被标准化为UnifiedMessage 格式,经过核心 AI 管线处理后,再通过 UnifiedSender 路由到对应平台发送响应。
这种设计使得新增平台只需实现两个适配层:消息解析(入站)和消息发送(出站),无需修改核心逻辑。
统一消息格式
UnifiedMessage
所有平台的入站消息都会被转换为UnifiedMessage,确保核心处理管线与平台无关。
string
required
平台标识符,如
telegram、wechat、qq、feishu、miniapp、webstring
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 桥接接入
OneBot 协议接入
飞书
企业级事件订阅
小程序
微信小程序客户端
Web
React SPA 前端