@LangChain：Claude Platform 的追踪数据现在可以通过 OpenTelemetry 发送到 LangSmith。可从 Claude Managed Agents、Messa… 导出

Claude Platform 的追踪数据现在可以通过 OpenTelemetry 发送到 LangSmith。利用原生 OTel 支持，从 Claude Managed Agents、Messages API 或 Claude SDK 导出追踪数据。追踪数据会显示在 LangSmith 中，让你能够检查每一步并提升智能体性能。该功能现已开放公开测试。文档：https://docs.langchain.com/langsmith/trace-anthropic… — # 追踪 Anthropic 应用程序 - LangChain 文档 来源：https://docs.langchain.com/langsmith/trace-anthropic 你可以从 Anthropic 的服务器或自己的应用程序向 LangSmith 发送 Anthropic 追踪数据：- 从 Claude Platform 发送 (https://docs.langchain.com/langsmith/trace-anthropic#trace-from-the-claude-platform)：Claude Platform 直接从 Anthropic 的服务器发送追踪数据\。你在 Claude Console 中进行配置，无需更改应用程序代码\。- 从应用程序发送 (https://docs.langchain.com/langsmith/trace-anthropic#trace-from-your-application)：你的应用程序通过以下两种方式之一发送追踪数据：- Claude SDK (https://docs.langchain.com/langsmith/trace-anthropic#use-the-claude-sdks)：Claude SDK 生成 OpenTelemetry (OTel) span，并由 OTel 导出器库将其发送到 LangSmith\。- LangSmith SDK 包装器 (https://docs.langchain.com/langsmith/trace-anthropic#use-the-langsmith-sdk-wrapper)：使用 LangSmith SDK (Python 或 TypeScript) 包装 Anthropic 客户端\。你可以将这些追踪数据与其余代码的@traceablespan 合并为一条追踪记录\。## 从 Claude Platform 发送追踪数据 Claude Platform 会导出你的 Claude Managed Agents (https://platform.claude.com/docs/en/managed-agents/overview) 会话和 Messages API (https://platform.claude.com/docs/en/api/messages) 请求的 OTel 追踪数据\。它会将数据发送到一个目标，即你在 Claude Console 中注册的 OTel 端点\。你可以将 LangSmith 添加为目标，无需更改应用程序代码即可查看这些追踪数据\。有关目标和投递的详细信息，请参阅 Anthropic 文档中的通过 Claude API 使用 OpenTelemetry (https://platform.claude.com/docs/en/manage-claude/opentelemetry/api)\。开始之前，你需要：- 在 Claude Console 组织中拥有管理员角色或同等权限\。没有该权限，你将无法查看或管理目标\。- 一个 LangSmith API 密钥\。你可以使用个人访问令牌 (https://docs.langchain.com/langsmith/administration-overview#personal-access-tokens-pats)，或在希望追踪功能独立于用户账户时使用服务密钥 (https://docs.langchain.com/langsmith/administration-overview#service-keys)\。要创建密钥，请参阅创建账户和 API 密钥 (https://docs.langchain.com/langsmith/create-account-api-key)\。- 对于自行托管的 LangSmith，需要一个 Claude Platform 可以访问的端点：使用 443 端口上的 HTTPS，且主机名解析到公共 IP 地址\。### 第 1 步\。将 LangSmith 添加为目标 要添加目标：1. 在 Claude Console 中，打开组织的 OpenTelemetry 设置页面 (https://platform.claude.com/settings/telemetry-destinations)，然后点击添加目标\。2. 在提供商下拉列表中，选择LangSmith\。表单会随之显示 LangSmith 字段\。3. 填写以下字段：- 名称：(可选) 目标的标签，例如LangSmith\。- 区域：LangSmith 部署所在的区域：美国、欧洲、亚太或AWS 上的美国区域\。对于自行托管的 LangSmith，选择自行托管，并在LangSmith URL字段中输入实例的 OTel 端点 URL，例如https:///api/v1/otel\。- API 密钥：你的 LangSmith API 密钥\。- 项目：(可选) 接收追踪数据的追踪项目 (https://docs.langchain.com/langsmith/log-traces-to-project) 的名称\。如果留空，追踪数据将发送到default项目\。- LangSmith 工作区 ID：(可选) 接收追踪数据的 LangSmith 工作区 ID\。如果留空，追踪数据将发送到 API 密钥所属的工作区\。组织范围的服务密钥必须提供此字段\。要查找该 ID，请参阅创建账户和 API 密钥 (https://docs.langchain.com/langsmith/create-account-api-key)\。- 内容模式：选择完整内容，以在 span 中包含提示词和响应\。选择仅元数据时，span 将不包含输入和输出内容\。- 工作区：向此目标发送追踪数据的 Claude 工作区：全部、所选或除所选外全部\。有关每个选项的详细信息，请参阅 Anthropic 文档中的为目标选择工作区 (https://platform.claude.com/docs/en/manage-claude/opentelemetry/api#choose-workspaces-for-a-destination)\。4. 点击添加目标\。之后编辑该目标时，表单会显示通用的OTLP 端点 URL和请求头字段，替代 LangSmith 字段\。OTLP 端点 URL包含你所在区域的 URL，而 LangSmith 字段则转换为以下请求头：- x\-api\-key：API 密钥\。- Langsmith\-Project：项目，如果你设置了项目\。- X\-Tenant\-Id：LangSmith 工作区 ID，如果你设置了该 ID\。如果更改OTLP 端点 URL的主机，请重新输入请求头的值\。### 第 2 步\。检查追踪数据是否到达 要检查配置：1. 在使用该目标的 Claude 工作区中发送一个 Messages API 请求，或运行一个 Claude Managed Agents 会话\。2. 在 Claude Console 的 OpenTelemetry 设置页面上，检查该目标的投递列是否显示正常\。这可能需要大约一分钟\。3. 在 LangSmith 中，打开你在项目字段中指定的项目，或default项目\。### 排查投递问题 如果 Claude Console 的 OpenTelemetry 设置页面 (https://platform.claude.com/settings/telemetry-destinations) 上的投递列显示失败，将鼠标指针悬停在其上即可查看最近一次错误：- HTTP 401：目标未发送 API 密钥\。- HTTP 403：API 密钥不正确、已过期或已被删除\。对于未提供工作区 ID 的组织范围服务密钥，LangSmith 也会返回 403\。- HTTP 404：端点 URL 不正确\。编辑目标，检查OTLP 端点 URL是否以/otel结尾(自行托管的 LangSmith 为/api/v1/otel)，并且不包含/v1/traces\。有关其他错误，请参阅 Anthropic 文档中的投递错误 (https://platform.claude.com/docs/en/manage-claude/opentelemetry/api#delivery-errors)\。如果投递列显示已禁用，将鼠标指针悬停在其上即可查看原因\。例如，如果目标的主机名解析到非公共 IP 地址，Claude Platform 会禁用该目标\。请参阅 Anthropic 文档中的投递和运行状况 (https://platform.claude.com/docs/en/manage-claude/opentelemetry/api#delivery-and-health)\。## 从应用程序发送追踪数据 当需要由应用程序发送追踪数据时，请使用以下方法之一\。要在同一条追踪记录中追踪 Anthropic 调用及其余代码，请使用 LangSmith SDK 包装器\。### 使用 Claude SDK Claude SDK 会在应用程序中为其发送的每个请求以及工具运行器执行的每次工具调用生成 OTel span\。OTel 导出器库会将这些 span 发送到 LangSmith\。有关 SDK 选项及其生成的 span 的详细信息，请参阅 Anthropic 文档中的设置 SDK 追踪 (https://platform.claude.com/docs/en/manage-claude/opentelemetry/sdk)\。要将 Claude SDK span 发送到 LangSmith：1. 安装或升级 Claude SDK (https://platform.claude.com/docs/en/manage-claude/opentelemetry/sdk#install-the-sdk)，并注册追踪器提供程序 (https://platform.claude.com/docs/en/manage-claude/opentelemetry/sdk#register-a-tracer-provider)\。2. 使用 LangSmith 部署的 OTel 端点 URL 配置 OTel 导出器：设置以下请求头：- x\-api\-key：你的 LangSmith API 密钥\。- Langsmith\-Project：(可选) 接收追踪数据的追踪项目名称\。如果没有此请求头，追踪数据将发送到default项目\。- X\-Tenant\-Id：(可选) 接收追踪数据的 LangSmith 工作区 ID\。如果没有此请求头，追踪数据将发送到 API 密钥所属的工作区\。组织范围的服务密钥必须提供此请求头\。例如，使用标准 OTel 环境变量：有关导出器配置的更多信息，请参阅追踪非 LangChain 应用程序 (https://docs.langchain.com/langsmith/trace-with-opentelemetry#trace-a-non-langchain-application)\。3. (可选) 默认情况下，Claude SDK 仅记录元数据\。要在 span 中包含提示词和响应，请设置内容模式\。请参阅 Anthropic 文档中的配置 SDK (https://platform.claude.com/docs/en/manage-claude/opentelemetry/sdk#configure-the-sdk)\。### 使用 LangSmith SDK 包装器 Python 中的 Anthropic 包装方法 (wrap\_anthropic (https://reference.langchain.com/python/langsmith/wrappers/_anthropic/wrap_anthropic)) 和 TypeScript 中的包装方法 (wrapAnthropic (https://reference.langchain.com/javascript/functions/langsmith.wrappers_anthropic.wrapAnthropic.html)) 会包装你的 Anthropic 客户端，以自动记录追踪数据\。使用包装器时，LangSmith 会以易读的格式呈现消息，包括工具调用和多模态内容块\。包装器可以与@traceable装饰器 (Python) 或traceable函数 (TypeScript) 配合使用，因此你可以使用包装器追踪 Anthropic 调用，并使用装饰器或函数追踪应用程序的其他部分\。要使用 TypeScript 的wrapAnthropic包装器追踪 Claude Managed Agents (https://platform.claude.com/docs/en/managed-agents/overview) 会话，请参阅追踪 Claude Managed Agents (https://docs.langchain.com/langsmith/trace-with-claude-managed-agents)\。— > ClaudeDevs (@ClaudeDevs)： > Claude Platform 现已开放公开测试，可将 Messages API、Claude Managed Agents 和 Claude SDK 的 OpenTelemetry 追踪数据发送到你的可观测性技术栈。