createAgent 构建的 LangChain 智能体自动支持通过 LangSmith 进行追踪,该平台用于捕获、调试、评估和监控 LLM 应用程序的行为。
追踪记录了智能体执行的每一个步骤,从最初的用户输入到最终的响应,包括所有工具调用、模型交互和决策点。这些执行数据可以帮助你调试问题、评估不同输入下的性能,并监控生产环境中的使用模式。
本指南将向你展示如何为 LangChain 智能体启用追踪,并使用 LangSmith 来分析其执行过程。
前提条件
开始之前,请确保你已具备以下条件:- 一个 LangSmith 账户:在 smith.langchain.com 注册(免费)或登录。
- 一个 LangSmith API 密钥:请按照创建 API 密钥指南操作。
启用追踪
所有 LangChain 智能体都自动支持 LangSmith 追踪。要启用它,请设置以下环境变量:快速开始
将追踪记录到 LangSmith 不需要额外的代码。只需像往常一样运行你的智能体代码:default 的项目中。要配置自定义项目名称,请参阅记录到项目。
选择性地追踪
你可以选择使用 LangSmith 的tracing_context 上下文管理器来追踪应用中的特定调用或部分操作:
记录到项目
静态设置
静态设置
你可以通过设置
LANGSMITH_PROJECT 环境变量,为整个应用设置一个自定义的项目名称:动态设置
动态设置
你也可以通过编程方式为特定操作设置项目名称:
为追踪添加元数据
你可以使用自定义的元数据和标签来为你的追踪添加注释:Connect these docs to Claude, VSCode, and more via MCP for real-time answers.

