"
```
如果您正在[自托管 LangSmith](/langsmith/self-hosted)，请将 `OTEL_EXPORTER_OTLP_ENDPOINT` 替换为您的自托管 URL 并附加 `/api/v1/otel`。例如：`OTEL_EXPORTER_OTLP_ENDPOINT = "https://ai-company.com/api/v1/otel"`。
将 `LANGSMITH_ENDPOINT` 替换为您的 LangSmith API 端点。例如：`LANGSMITH_ENDPOINT = "https://ai-company.com/api/v1"`。
## 步骤 1. 创建实验会话
本指南假设已在 LangSmith 中创建了一个包含待评估示例的数据集。您可以通过 [LangSmith UI](/langsmith/evaluation-concepts#datasets) 或通过 [SDK](/langsmith/manage-datasets-programmatically) 创建数据集。
实验会话将所有评估追踪分组在一起。使用 LangSmith 客户端创建一个：
```python Python theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
from langsmith import Client
# 初始化 LangSmith 客户端
client = Client()
experiment_name = "strands-agent-experiment"
# 假设已创建数据集。您可以在 LangSmith UI 或通过 SDK 中找到数据集 ID。
dataset_id = ""
# 创建链接到数据集的实验会话
project = client.create_project(
project_name=experiment_name,
reference_dataset_id=dataset_id
)
experiment_id = str(project.id)
```
```typescript TypeScript theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
import { Client } from "langsmith";
// 初始化 LangSmith 客户端
const client = new Client({
apiKey: process.env.LANGSMITH_API_KEY,
});
const experimentName = "strands-agent-experiment";
const datasetId = "your-dataset-id";
// 创建链接到数据集的实验会话
const project = await client.createProject({
projectName: experimentName,
referenceDatasetId: datasetId,
});
const experimentId = project.id;
```
此外，您可以在 LangSmith UI 中创建评估器并将其绑定到您的数据集。对于在 UI 中定义并绑定到数据集的评估器，它们将自动在实验追踪上运行。
要了解有关评估器的更多信息，请参阅[评估器](/langsmith/evaluation-concepts#evaluators)。
## 步骤 2. 定义应用程序并配置 OpenTelemetry
首先，您需要一个使用 OpenTelemetry 进行追踪的应用程序。此示例使用 Strands 代理，但您可以使用任何已检测 OpenTelemetry 的应用程序。通过在 OTEL 头中包含实验 ID，设置 OpenTelemetry 将追踪路由到您的实验会话。此步骤的一般思路是拥有一个已使用 OpenTelemetry 进行检测的代理或应用程序。
此步骤未提供 TypeScript 示例，因为 `Strands TypeScript SDK` 目前（截至 2026 年 2 月）不支持 `OpenTelemetry` 可观测性。
```python Python theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
import os
from strands import Agent
from strands_tools import file_read, file_write, python_repl, shell, journal
from strands.telemetry import StrandsTelemetry
# 设置 OTEL 头，将实验 ID 作为项目
api_key = os.getenv('LANGSMITH_API_KEY')
os.environ['OTEL_EXPORTER_OTLP_HEADERS'] = f"x-api-key={api_key},Langsmith-Project={experiment_id}"
# 初始化遥测
strands_telemetry = StrandsTelemetry()
strands_telemetry.setup_otlp_exporter()
# 创建代理（Strands 自动创建 OTel span）
agent = Agent(
tools=[file_read, file_write, python_repl, shell, journal],
system_prompt="You are an Expert Software Developer.",
model="us.anthropic.claude-sonnet-4-20250514-v1:0",
)
```
有关使用 LangSmith 设置 OpenTelemetry 追踪的详细信息，请参阅[使用 OpenTelemetry 追踪](/langsmith/trace-with-opentelemetry)。
## 步骤 3. 设置关键 span 属性
为每次应用程序运行添加所需的 span 属性。这些属性将每个追踪链接到实验和特定的数据集示例。
以下属性与实验评估相关：
| 属性 | 用途 |
| -------------------------------- | ----------------------------------- |
| `langsmith.trace.session_id` | 将追踪路由到您的实验会话 |
| `langsmith.reference_example_id` | 将追踪链接到特定的数据集示例 |
| `langsmith.span.kind` | 设置 span 类型（例如 "llm"、"chain"、"tool"） |
| `inputs` | 记录应用程序的输入 |
| `outputs` | 记录应用程序的输出 |
有关支持的 OpenTelemetry 属性的完整列表，请参阅[使用 OpenTelemetry 追踪](/langsmith/trace-with-opentelemetry#supported-opentelemetry-attribute-and-event-mapping)。
```python Python theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
from opentelemetry import trace
def evaluate_with_opentelemetry(agent, example_id: str, example_input: str, experiment_id: str):
tracer = trace.get_tracer(__name__)
# 包装 span 以添加实验元数据
with tracer.start_as_current_span("experiment_evaluation") as span:
# 将追踪路由到实验
span.set_attribute("langsmith.trace.session_id", experiment_id)
# 将追踪链接到特定的数据集示例
span.set_attribute("langsmith.reference_example_id", example_id)
# 记录输入
span.set_attribute("inputs", example_input)
# 运行应用程序
response = agent(example_input)
# 记录输出
output_text = getattr(response, "output", str(response))
span.set_attribute("outputs", output_text)
return output_text
```
```typescript TypeScript theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
import { trace, Span } from "@opentelemetry/api";
async function evaluateWithAgent(
agent: Agent,
exampleId: string,
exampleInput: string,
experimentId: string
): Promise {
const tracer = trace.getTracer("experiment-runner");
return await tracer.startActiveSpan(
"experiment_evaluation",
async (span: Span) => {
try {
// 将追踪路由到实验
span.setAttribute("langsmith.trace.session_id", experimentId);
// 将追踪链接到特定的数据集示例
span.setAttribute("langsmith.reference_example_id", exampleId);
// 记录输入
span.setAttribute("inputs", exampleInput);
// 运行应用程序
const result = await agent.invoke(exampleInput);
// 记录输出
const response = String(result);
span.setAttribute("outputs", response);
return response;
} finally {
span.end();
}
}
);
}
```
## 步骤 4. 通过遍历数据集示例运行评估
每次实验运行都会在 LangSmith 中创建链接到您数据集示例的追踪。
```python Python theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
# 遍历数据集示例
for example in client.list_examples(dataset_name=dataset_name):
# 从示例输入字典中提取输入
# 根据您的数据集结构调整键
# （例如 "input"、"question" 等）
example_input = example.inputs.get("input")
evaluate_with_opentelemetry(
agent=agent,
example_id=str(example.id),
example_input=str(example_input),
experiment_id=experiment_id
)
```
```typescript TypeScript theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
// 遍历数据集示例
for await (const example of client.listExamples({ datasetName })) {
// 从示例输入字典中提取输入
// 根据您的数据集结构调整键
// （例如 "input"、"question" 等）
const exampleInput = example.inputs.input;
await evaluateWithAgent(
agent,
example.id,
String(exampleInput),
experimentId
);
}
```
运行评估后，您可以在 LangSmith UI 中[分析实验](/langsmith/analyze-an-experiment)以查看：
* 每个示例的单独追踪详情
* 评估器分数和反馈
* 不同实验运行之间的比较
导航到 [LangSmith UI](https://smith.langchain.com) 中的实验以分析结果。
***
[将这些文档连接](/use-these-docs)到 Claude、VSCode 等，通过 MCP 获取实时答案。
[在 GitHub 上编辑此页面](https://github.com/langchain-ai/docs/edit/main/src/langsmith/evaluate-with-opentelemetry.mdx) 或 [提交问题](https://github.com/langchain-ai/docs/issues/new/choose)。