SuperAPI AI 工具集

maf-tracing

智能体与模型

查看项目

更新于 10-16 09:33

技能介绍

用途:为 Microsoft Agent Framework(MAF)工作流启用追踪与日志。MAF 会自动为每次执行器调用、智能体调用和 LLM 请求生成 OpenTelemetry span,无需在 Executor 类内部添加埋点,只需配置导出目标并调用 configure_otel_providers() 激活内置遥测。

主要能力:支持导出到 Azure Application Insights、通用 OTLP 端点,或两者同时导出;可选将 Python logging 通过 OpenTelemetry 一并导出。

使用方式:先读取项目中的 requirements.txt、.env 与入口脚本,确认导出目标。在应用启动时、任何 workflow.run() 之前完成配置:导出器配置必须先于 configure_otel_providers(),而 configure_otel_providers() 又必须先于 workflow.run()。连接字符串与端点通过环境变量读取,不得硬编码。常见环境变量包括 APPLICATIONINSIGHTS_CONNECTION_STRING、OTEL_EXPORTER_OTLP_ENDPOINT、OTEL_EXPORTER_OTLP_TRACES_ENDPOINT、OTEL_EXPORTER_OTLP_PROTOCOL、OTEL_SERVICE_NAME。依赖包按需追加:agent-framework>=1.0.1、azure-monitor-opentelemetry>=1.6.4、opentelemetry-exporter-otlp-proto-http>=1.25.0、opentelemetry-sdk>=1.25.0 等,并提供 .env.example 模板。

适用场景:需要为 MAF 项目增加可观测性、将遥测导出到 Azure Application Insights 或 OTLP 兼容后端、或调试 MAF 工作流中的执行器/智能体/LLM span 时。

限制与注意:不要在 Executor 类或 @handler 方法内添加手动 span 或调用配置代码;configure_azure_monitor() 会自行创建 TracerProvider,与 OTLP 组合时应复用已有 provider;OTLP 端点应为基地址,SDK 会自动追加 /v1/traces;默认协议为 http/protobuf(端口 4318),若用 gRPC 需设置 OTEL_EXPORTER_OTLP_PROTOCOL=grpc 并安装对应导出包。具体收费、平台支持与效果等资料暂未提供。