需启用审计日志、部署反向代理、调用usage report api及配置webhook回传，四步缺一不可。否则控制台无流量统计、调用日志或用户反馈数据。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已部署 MiniMax 智能体并完成基础配置，但在控制台后台未看到任何流量统计、调用日志或用户反馈数据，则可能是由于数据采集未启用、日志导出未触发、代理链路缺失或权限范围受限所致。以下是获取 MiniMax 智能体后台流量统计与用户反馈数据的具体方法：
一、启用智能体请求审计日志并导出结构化数据
MiniMax 控制台为 Agent 项目级账户提供原生请求审计能力，可捕获每次调用的 request_id、输入长度、输出长度、响应延迟、客户端 IP 归属地及完整时间戳。该日志是还原用户行为路径与生成反馈概览的核心依据，需手动开启且默认不激活。
1、登录 console.minimax.tech，进入目标项目「设置」→「安全与审计」。
2、点击「启用智能体请求日志」，确认开通；系统将在 5 分钟内开始捕获新请求，历史请求不可追溯。
3、在「审计日志」页签中设定时间范围（起止日期必须在当前日期前 90 天内）。
4、勾选「包含请求体摘要」和「包含响应体摘要」后点击「导出 CSV」。
5、使用 Excel 或 Pandas 对导出文件的 user_message 与 assistant_response 字段进行关键词提取与情感倾向标注，生成用户反馈分类报表。
二、部署反向代理层捕获原始交互流量
当控制台日志未覆盖全部调用路径（如 Webhook 直连、第三方平台中转、移动端 SDK 调用）时，需在请求必经链路中插入轻量级代理，实现无侵入式全量埋点。该方式可捕获 user_session_id、retry_count、agent_call_depth 等控制台不暴露的细粒度字段，支撑深度反馈归因分析。
1、在边缘服务器或本地开发环境部署 Nginx + Lua 或 Envoy 反向代理，将所有发往 https://api.minimax.chat/v1/text/chatcompletion 的请求统一转发。
2、在代理配置中添加日志写入逻辑，将每条请求的 X-Forwarded-For、User-Agent、完整 JSON body 及响应状态码写入本地 JSONL 文件。
3、定时执行脚本，将 JSONL 日志按小时切片并上传至对象存储（如 OSS/MinIO），供下游 BI 工具拉取解析。
4、对每条日志中的 messages 数组进行轮次计数，识别单 session 内平均对话轮数；对 choices[0].message.content 执行空值与截断检测，标记潜在中断反馈。
三、调用 Usage Report API（Beta）获取聚合指标
MiniMax 提供 Beta 版本的 Usage Report API，支持按小时粒度返回指定 Agent ID 的总请求数、成功数、失败数、平均响应延迟与 token 消耗总量。该接口不依赖日志导出，适用于构建实时监控看板或告警联动场景，但需项目具备 Agent Analytics 权限。
1、构造 HTTPS GET 请求，URL 为：https://api.minimax.chat/v1/agent/{agent_id}/usage?start_time=1747987200&end_time=1748073600（Unix 时间戳格式，跨度不超过 7 天）。
2、在请求 Header 中添加：Authorization: Bearer YOUR_API_KEY 与 Content-Type: application/json。
3、发起请求后，检查响应体中 data[].success_rate 字段是否低于 95%，若存在显著波动，需结合审计日志定位失败时段的具体 error_code。
4、提取 data[].feedback_summary 字段（若存在），该字段为平台自动聚类的高频用户反馈短语，如“回答太长”“没理解问题”“重复回答”，可直接用于优化提示词。
四、检查 Webhook 回传路径是否完整启用
若智能体通过 Webhook 集成至微信公众号、飞书机器人等外部渠道，用户反馈数据不会自动回传至 MiniMax 控制台，必须由接收端主动将用户消息与 bot 响应同步上报至 MiniMax 的 Feedback Ingestion Endpoint，否则后台始终为空。
1、确认 Webhook 接收服务（如 Flask/FastAPI 后端）在收到用户消息后，已实现对 /v1/feedback 端点的异步 POST 调用。
2、请求 Body 必须包含字段：agent_id、session_id、user_message、assistant_response、rating（1–5 整数）及 timestamp（ISO 8601 格式）。
3、检查 Webhook 响应状态码是否为 202 Accepted，若返回 400 或 401，说明字段缺失或签名验证失败。
4、在 MiniMax 控制台「Agent」→「调试」页中，点击「查看最近反馈」，确认上报数据是否出现在列表中；若延迟超过 2 分钟，需排查网络策略或重试机制配置。
