Callbacks 与追踪

Callbacks 用于监听模型调用、工具调用、链路开始结束、异常等事件。追踪系统可以帮助你看清 Agent 到底做了什么。

为什么重要

大模型应用不是普通接口，问题可能出在：

• Prompt 不合理。
• 检索结果不对。
• 工具选错。
• 模型输出格式不稳定。
• token 超限。
• 某一步延迟过高。

没有追踪，很难定位。

建议记录字段

字段	说明
trace_id	请求链路 ID
user_id	用户 ID
model	使用模型
prompt_version	Prompt 版本
input/output	输入输出，注意脱敏
latency	耗时
token_usage	token 消耗
tool_calls	工具调用明细
error	异常信息

LangSmith

LangSmith 可用于跟踪、调试和评估 LangChain / LangGraph 应用。企业生产环境也可以接入自建日志、APM 或链路追踪平台。

非官方声明

本站为个人维护的非官方中文学习文档，不代表 LangChain 官方。页面内容是基于公开文档、源码实践和中文开发者视角重新整理的学习资料。涉及 API 细节时，请以官方文档和实际安装版本为准。

参考来源

• LangChain / LangGraph 官方文档：https://docs.langchain.com/
• LangChain API Reference：https://reference.langchain.com/
• 本站内容为中文学习整理，不做官方身份声明。