Skip to content

feat(monitoring): enhance sender display name extraction and per-sender group session IDs - #3006

Open
a251231 wants to merge 2 commits into
langbot-app:masterfrom
a251231:feat/monitoring-sender-name-and-group-session
Open

a251231 wants to merge 2 commits into
langbot-app:masterfrom
a251231:feat/monitoring-sender-name-and-group-session

Conversation

@a251231

@a251231 a251231 commented Nov 12, 2026

Copy link
Copy Markdown

概述 / Overview

增强监控会话的发送者名称提取与群聊会话粒度:

  • MonitoringHelper._extract_sender_name 多字段提取 (pkg/pipeline/monitoring_helper.py):统一在 record_query_start、record_query_response、record_query_error 和 record_plugin_reply 中提取显示名,依次支持 group.name、sender.get_name()、sender.{member_name,nickname,remark,name,display_name,username,user_name,card} 以及 query.variables['sender_name']。
  • 群聊监控会话按发言人拆分 (monitoring_session_id):当 platform == 'group' 且 sender_id 非空时,使用 group_{launcher_id}_{sender_id} 作为 monitoring_session_id。
  • 监控会话导出与前端类型补齐:在 sessions CSV 导出及 BackendClient.ts 中补齐 user_name 字段。

检查清单 / Checklist

PR 作者完成 / For PR author

  • 阅读仓库贡献指引了吗?
  • 我已签署或将在机器人提示后签署 CLA。
  • 我确定已自行测试所作的更改,确保功能符合预期。

@github-actions

github-actions Bot commented Nov 12, 2026 •

Copy link
Copy Markdown
Contributor

All contributors have signed the CLA. ✅ 所有贡献者均已签署 CLA。
Posted by the CLA Assistant Lite bot.

@a251231

a251231 commented Nov 12, 2026

Copy link
Copy Markdown
Author

I have read the CLA Document and I hereby sign the CLA

@RockChinQ

Copy link
Copy Markdown
Member

感谢贡献!我们支持「群聊监控会话按发言人拆分」这个方向,但当前实现有两处需要调整后才能合并。

1. 发送者名提取:不要把群名放在第一位

_extract_sender_name 第一步取 message_event.group.name,而真实的 GroupMessage 本来就有 .group 属性。用 SDK 实体实测:同一个群里 Alice、Bob 发的消息,都会返回群名(master 现在返回 Alice / Bob)。这个函数会写进每条消息的 user_name(query start/response/error/plugin reply),合入后群聊里看不出是谁发的消息,和按人拆会话也矛盾。测试 test_extract_sender_name_supports_group_sender_methods_and_variables 把「返回群名」当成了期望值,也需要一起改。

建议:

  • 回退链改成 sender.get_name() → sender.{member_name,nickname,remark,card,...} → variables['sender_name'],群名不参与发送者名。如果要展示群名,单独存一个字段,例如放进会话快照,不要占用 user_name。
  • platform/botmgr.py:1480 附近(跳过流水线时记录消息)也有一份旧的取名逻辑,请一起换成这个函数。
  • CSV 导出加 user_name、BackendClient.ts 补 user_name?:这部分没问题,保留。

2. 按人拆分会话:要在所有监控写入方统一,而且只拆监控、不拆对话

现在只改了 monitoring_helper.monitoring_session_id,其他写入方还在用 group_{launcher_id},同一个群会出现两套会话,数据也对不上:

写入方 位置 现状
消息 / LLM 调用 pipeline/monitoring_helper.py 已改为 group_X_user
工具调用 provider/tools/toolmgr.py::_get_query_session_id 仍为 group_X,按会话查工具调用(service/monitoring.py ~2644)会查不到
跳过流水线的消息 platform/botmgr.py ~1488(注释写着与 monitoring_helper 同格式) 仍为 group_X
Ingress 事件 → 会话摘要 persistence/session_summary_writer.py,取值来自 conversation_id 仍为 group_X

建议的设计:

  1. 只用一个函数生成监控会话 ID。 例如在 monitoring_helper 里提供 build_monitoring_session_id(launcher_type, launcher_id, sender_id)。上表所有写入方都改为调用它,不再各自拼 f'{type}_{id}'。
  2. 只拆监控视图,不改真实的对话 key。 Agent run / transcript / runner_state 用的 conversation_id、sessionmgr 的对话上下文、box session 模板、bansess 访问控制,都必须继续按 group_{launcher_id} 走,否则会改变机器人在群里的记忆和权限行为。所以 ingress → summary 这条路径要在 summary writer 里做映射:群聊时用 conversation_id + actor_id 算出监控会话 ID,而不是直接改 conversation_id 本身。
  3. 兜底:sender_id 为空时(部分适配器、系统事件)退回 group_{launcher_id}。PR 里已经这样处理了,保留。
  4. 历史数据:升级后旧的 group_X 会话会保留为历史,新消息进入 group_X_user,不需要迁移,但请在 PR 描述里说明。如果改动不大,可以让会话列表支持按群(launcher_id)筛选或分组,方便查看一个群的全部会话。
  5. 测试:除了现有单测,建议再加一条:同一个群聊 query 走消息记录、LLM 调用、工具调用、ingress summary 后,这几处的 session_id 一致;并且 conversation_id / sessionmgr 的会话 key 不变。

方便的话,请按以上两点更新这个 PR。有问题欢迎在这里讨论 🙏

@a251231

a251231 commented Nov 17, 2026

Copy link
Copy Markdown
Author

@RockChinQ 感谢 Review!已按上述两点完成调整并推送更新(30597590b):

  1. 发送者名提取 (extract_sender_name):

    • 移除了 message_event.group.name,回退链改为 sender.get_name() → sender.{member_name, nickname, remark, name, display_name, username, user_name, card} → variables['sender_name']。
    • platform/botmgr.py 中 _record_discarded_message 的旧取名逻辑已统一替换为 extract_sender_name。
    • 更新了单测 test_extract_sender_name_supports_group_sender_methods_and_variables(包含真实 SDK GroupMessage 实体校验返回发送者名 Alice)。
    • 保留了 CSV 导出的 user_name 与前端 BackendClient.ts 的 user_name?。
  2. 统一监控会话 ID 生成(只拆监控视图,不拆真实对话 Key):

    • 提供统一的 build_monitoring_session_id(launcher_type, launcher_id, sender_id)(以及用于会话摘要映射的 monitoring_session_id_from_conversation),当 sender_id 为空时兜底退回 group_{launcher_id}。

    • 已在全部 4 处监控写入方统一调用:

      • pipeline/monitoring_helper.py(消息与 LLM 调用)
      • provider/tools/toolmgr.py::_get_query_session_id(工具调用)
      • platform/botmgr.py::_record_discarded_message(跳过流水线的消息)
      • persistence/session_summary_writer.py::ingress_summary_change(Ingress 事件 → 会话摘要映射,不修改 EventLog.conversation_id 本身;同时在读侧未覆盖 Ingress 投影与 reset_session_context 中保持兼容)。
    • Agent run / transcript / runner_state 的 conversation_id、sessionmgr 对话上下文、Box session 模板和 bansess 均保持 group_{launcher_id} 不变。

    • 会话列表新增了可选的 launcher_id(HTTP launcherId / groupId)筛选支持,可一键筛选同一群下的全部会话(含历史 group_X 与新的 group_X_user),并在 PR 描述中补充了历史数据说明。

    • 新增了端到端单测 test_group_query_monitoring_session_id_is_consistent_across_all_writers_without_splitting_conversation,验证同一群聊 Query 走消息记录、LLM 调用、工具调用、跳过流水线消息、Ingress summary 后 session_id 一致且 get_session_analysis 聚合完整,同时 conversation_id 与 sessionmgr 会话 key 保持 group_{launcher_id}。

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants