Day 13 / 共 20 天 · 高层聊天 Agent消息事件类型:从
消息事件类型:从 python/packages/autogen-agentchat/src/autogen_agentchat/messages.py 读出一段工作流
认识文本、多模态和事件消息。。今天不追求把每行代码翻译成中文;目标是建立可验证的因果链:谁调用它、它如何处理输入、状态留下在哪里、它下一步交给谁。
📍 20 天路线 · D01-D03 认识三层包结构 → D04-D07 Core 消息运行时 → D08-D10 模型、工具与上下文 → D11-D14 高层聊天 Agent → D15-D17 团队编排 → D18-D20 扩展与产品化
D11 AssistantAgent 的高层循环→D12 ChatAgent 与 TaskResult→D13 消息事件类型→D14 可组合终止条件→D15 BaseGroupChat 连接两层框架→
💡 今日类比会议中的发言、工具回执和流式字幕。先用这个类比理解职责,再回到真实路径 python/packages/autogen-agentchat/src/autogen_agentchat/messages.py 校正它;类比帮你记住结构,源码负责告诉你边界。
L01
先问问题 · 消息事件类型
🤔 问题为什么今天不是直接背
python/packages/autogen-agentchat/src/autogen_agentchat/messages.py 的所有实现?因为它只是 AutoGen 这条链路中的一个站点。先定位它接收什么、产出什么,细节才不会变成孤岛。L02
找到入口 · 消息事件类型
💡 本质从 python/packages/autogen-agentchat/src/autogen_agentchat/messages.py 打开后,先看导入、公开类或函数和构造参数。它们像岗位说明书:告诉你这个模块需要哪些前置条件,也暴露它依赖的邻居。
python/packages/autogen-agentchat/src/autogen_agentchat/messages.py今天的主焦点:先观察命名、导入与主要入口。调用方用编辑器的引用跳转,确认谁把数据送进来。下游沿返回值、await、事件或方法调用找到它交棒的位置。L03
跟数据走 · 消息事件类型
👶 大白话把输入写成一句话:任务从
python/packages/autogen-agentchat/src/autogen_agentchat/base/_chat_agent.py 或调用方来到这里,被转换、校验或包装后,再交给下一站。源码阅读最可靠的导航不是文件树,而是参数、返回值和事件。动画心智图:先追一条数据的去向,再扩展到异常分支。
L04
看协作边界 · 消息事件类型
🤔 问题今天的焦点属于「消息事件类型」。把它当作 会议中的发言、工具回执和流式字幕:它不必独自做完所有事,而是把专业工作交给模型、工具、存储或下一位对象。
L05
辨析取舍 · 消息事件类型
💡 本质当逻辑被拆到多个对象时,初看要跳很多文件;换来的好处是可替换、可测试和可观测。遇到抽象层先不要嫌绕,问它隔离了哪一种变化:模型、工具、状态还是流程。
Q&A
Q:看不懂某个函数要停多久?
A:先记下输入、输出、调用位置,跳过内部细节;等主链路第二次经过它时再回来。源码学习不是一次读完,是不断缩小未知区域。
L06
动手复盘 · 消息事件类型
👶 大白话用命令确认
python/packages/autogen-agentchat/src/autogen_agentchat/messages.py 的真实存在和周边文件,再回到本页画三格图:输入 → 消息事件类型 → 输出。明天会从 python/packages/autogen-agentchat/src/autogen_agentchat/conditions/_terminations.py 接着走,今天留下的问题正好成为明天的入口。# AI_WORK 中的真实项目根目录
cd /Users/bitmart/work/codes/github/AI_WORK/autogen
# 先确认本课焦点存在;路径都相对项目根目录
ls python/packages/autogen-agentchat/src/autogen_agentchat/messages.py
常见卡点AI_WORK 的仓库版本可能与文章调研时不同。如果路径改名,先在项目根目录使用
rg --files | rg "关键词" 查找,而不是把绝对路径复制进笔记。