Skip to main content
LangSmith 可以通过其内置的 OpenTelemetry 工具捕获由 Microsoft Agent Framework 生成的追踪数据。本指南将展示如何自动捕获来自 Microsoft Agent Framework 智能体的追踪数据,并将其发送到 LangSmith 进行监控和分析。

安装

安装所需的软件包:
pip install agent-framework opentelemetry-exporter-otlp-proto-http

设置

1. 配置环境变量

启用智能体的 OpenTelemetry 工具,并设置 OpenTelemetry 环境变量以指向 LangSmith 的 OTEL 端点:
export ENABLE_INSTRUMENTATION=true
export OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
export OTEL_EXPORTER_OTLP_ENDPOINT=https://api.smith.langchain.com/otel/v1/traces
export OTEL_EXPORTER_OTLP_HEADERS="x-api-key=<你的_langsmith_api_key>,Langsmith-Project=<你的项目名称>"

2. 在应用中启用 OpenTelemetry

在你的 Microsoft Agent Framework 应用中,使用内置的 configure_otel_providers 函数启用 OpenTelemetry 追踪:
from agent_framework.observability import configure_otel_providers

# 启用 OpenTelemetry 追踪
configure_otel_providers(enable_sensitive_data=True)
设置 enable_sensitive_data=True 允许在追踪中捕获输入和输出内容。如需排除敏感数据,请设置为 False

3. 创建并运行你的智能体

配置完成后,你的 Microsoft Agent Framework 智能体将自动向 LangSmith 发送追踪数据:
from agent_framework import ChatAgent
from agent_framework.observability import configure_otel_providers
from agent_framework.openai import OpenAIChatClient

# 启用 OpenTelemetry 追踪
configure_otel_providers(enable_sensitive_data=True)


agent = ChatAgent(
    chat_client=OpenAIChatClient(model_id="gpt-4o"),
)

result = await agent.run("巴伐利亚的首府是哪里?")
print(result.text)