读完这篇你会知道

为什么需要 Callback？使用者痛点暴露，

AIGC 开发者常见问题场景：

• "我的AI程序黑箱运行，没法追踪各环节性能" - 一个ReAct Agent运行时可能调用多个节点、多个工具、多个模型——每次调用用了多少token？哪个节点耗时最长，工具返回了什么？这些关键信息完全不透明，手动添加监控代码既麻烦又影响业务逻辑清晰度。
• "监控网站更换成本太高" - "我们刚使用LangSmith上报数据。现在要换CozeLoop网站，又要修改所有代码！"这种因监控需求变化而频繁修改业务代码的情况让开发团队疲惫不堪。
• "流式处理总出现内存泄漏" - "我们使用流式处理后发现程序内存继续增长，但不知道哪里没正确释放资源"这种隐蔽问题导致程序逐渐变慢甚至崩溃。
• "无法精准计算API成本" - "各模型和工具调用实际消耗了多少token？如何精确计算成本分配给不同客户？"财务部门经常提出这样的疑问却无法得到准确答案。
• "调试复杂Agent像找针在草垛" - "当Agent出现异常行为时如何快速定位是哪个组件出错？如何获取完整执行方法信息？"维护团队痛苦地发现缺乏有效的追踪机制。

Callback程序顺势出现！它通过将观测逻辑与执行逻辑彻底分离，让开发者可以：

• 零侵入式监控: 不需要修改业务代码即可添加观测能力;
• 灵活替换: 改变监控网站只需更新Handler配置;
• 细粒度追踪: 在任何组件执行阶段插入自定义逻辑;说起来，
• 资源安全: 自动管理流式处理中的goroutine生命周期;

再看接口设计，五大关键时机捕捉一切关键事件！

AIGC程序中的每一个关键操作都被精确捕捉:

RunInfo: 一眼识别谁在说话!

AIGC程序中每次回调都带着*RunInfo。像身份证一样清楚告诉您:

• Name这方面，节点名称;Type: 内部实现类型;Component: 框架标准化的组件类别;三个字段来源明确:
  Node Name: 从Graph结构中获取,或通过compose.WithNodeName设置;Type: 由组件自身实现Typer接口返回,或反射取结构体名;Component: 框架预定义的枚举值,全局唯一标识.为什么需要Component字段?类型的组件,再进行相应处理:
  
  
  
  

go handler := callbacks.NewHandlerBuilder. OnStartFn(func(ctx context.Context,info *callbacks.RunInfo。input callbacks.CallbackInput) context.Context { //仅处理ChatModel类型回调 modelInput := model.ConvCallbackInput if modelInput == nil { return ctx //非ChatModel请求跳过 } log.Printf("向模型发送%d条消息",info.Name,len) return ctx }).Build