追踪 Microsoft Agent Framework 应用

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

安装

安装所需的软件包：

pip

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)

---

Edit this page on GitHub or file an issue.

Connect these docs to Claude, VSCode, and more via MCP for real-time answers.