数据流
结论:行为进 Mixpanel,内容留在你方后端,两边只靠编号相连。
白话:Mixpanel 只知道"谁、什么时候、做了什么、编号是多少"。原文和图片永远在你方自己的系统里。
打个比方
像图书馆借书卡。卡上只写书号,书本身在书架上。要看内容,拿书号去书架找。
■ 蓝 = 主线 / 已定■ 黄 = 连接键 / 待定■ 灰 = 说明
① 客户端行为
| 项目 | 说明 |
|---|---|
| 谁发送 | 浏览器 SDK |
| 什么时候 | 用户在页面上的每个动作发生时 |
| 带哪些编号 | distinct_id、device_id、session_id、page_view_id、conversation_id、message_id、artifact_id |
| 怎么处理 | 前端先打码邮箱、电话、卡号、证件号;Replay 遮住聊天区和媒体区;$insert_id 去重;event_sequence 排序;client_clock_offset_ms 校正时钟;断网时 SDK 本地重试 |
| 在哪查 | Mixpanel Development 4072898 |
② 服务端事实
| 项目 | 说明 |
|---|---|
| 谁发送 | 后端服务 |
| 什么时候 | 付款、订单、PeerCoins、模型调用提交成功后 |
| 带哪些编号 | order_id、payment_attempt_id、transaction_id、attempt_id、task_id、job_id |
| 怎么处理 | event_id 作为 $insert_id 去重;occurred_at 记发生时间;失败进队列,指数退避重试;is_test 标出沙盒付款 |
| 在哪查 | Mixpanel(服务端 API) |
③ 内容
| 项目 | 说明 |
|---|---|
| 谁发送 | 后端服务 |
| 什么时候 | 聊天文字、图片、视频产生时 |
| 带哪些编号 | conversation_id、message_id、response_id、artifact_id、media_id |
| 怎么处理 | 原文永不进 Mixpanel;只把编号发给 Mixpanel;内容按用户自己的存储规则保存 |
| 在哪查 | 你方后端数据库和对象存储 |
④ 经营分析
| 项目 | 说明 |
|---|---|
| 谁发送 | BI 任务 |
| 什么时候 | 每天定时 |
| 带哪些编号 | attempt_id、order_id、transaction_id |
| 怎么处理 | 从 Mixpanel 导出 + 后端账单合并;model_charge_posted 有值时优先;剔除 is_test |
| 在哪查 | bi.emorika.com(暂定,你方 AWS) |
编号查找表
| 编号 | 指的是什么 | 内容存在哪 | 怎么查 |
|---|---|---|---|
conversation_id | 一次对话 | 你方后端 · 对话表 | 按 conversation_id 查对话和全部消息 |
message_id | 一条消息 | 你方后端 · 消息表 | 按 message_id 查原文 |
parent_message_id | 这条消息回复的上一条 | 你方后端 · 消息表 | 按 parent_message_id 找上一条 |
turn_index | 对话里第几轮 | 你方后端 · 消息表 | conversation_id + turn_index |
response_id | 模型的一次回复 | 你方后端 · 模型输出表 | 按 response_id 查回复全文 |
attempt_id / task_id | 一次模型调用 | 你方后端 · 调用日志 + 账单 | 按 attempt_id 查耗时、模型、成本 |
job_id / parent_job_id | 一个生成任务 / 它的上一个任务 | 你方后端 · 任务表 | 按 job_id 查参数和状态 |
artifact_id / artifact_ids | 生成出的一个或多个作品 | 你方对象存储 | 按 artifact_id 取文件地址 |
media_id | 一个媒体文件 | 你方对象存储 | 按 media_id 取文件 |
source_image_id | 用来生成的原图 | 你方对象存储 | 按 source_image_id 取原图 |
order_id | 一笔订单 | 你方后端 · 订单表 | 按 order_id 查订单 |
transaction_id | 一笔实收 | 支付服务商 + 后端 | 按 transaction_id 对账 |
如何从 Mixpanel 回查内容
- 在 Mixpanel 找到那条事件,例如一条差评的 chat_reply_completed。
- 展开事件,复制
conversation_id、message_id或response_id。 - 在你方后端用这个编号查原文。
内容分析(聚类、打标签)在你方后端做。AWS Bedrock 打标签和回写 Mixpanel:可选(以后),不在 P0。
代理说明:本版按最新要求用 t.emorika.com nginx。早先方案的 t.peersoft.ai + CloudFront 已替换。来源:dev.peersoft.ai 代码配置(2026-10-29)。
名词表
| 名词 | 白话和例子 |
|---|---|
| 事件 | 用户做的一件事被记下来。像收银小票上的一行。 |
| 连接键 | 把两张表连起来的编号。像快递单号连起下单、发货、签收。 |
| attempt_id | 一次模型调用的编号,即 task_id。像取餐号,凭它找到那一份餐的成本。 |
| Replay | 把用户屏幕操作录成回放。像商店监控,但敏感处打码。 |
数据流 签字
确认人:研发 · 数据
意见:______________________
打印后勾选。本页不收集数据。