LoongSuite Microsoft Agent Framework Instrumentation

This package provides LoongSuite instrumentation for Microsoft Agent Framework (agent-framework-core).

It keeps MAF’s native OTel span lifetime, but routes GenAI span finalization through opentelemetry-util-genai before spans are ended:

• util_genai_bridge patches MAF’s native span helper functions and calls the shared opentelemetry-util-genai invocation finish helpers for AGENT / LLM / TOOL / EMBEDDING spans while the span is still recording. This ensures exporter snapshots include gen_ai.span.kind, gen_ai.operation.name, normalized provider names, token usage, finish reasons, and streaming TTFT where MAF exposes enough data. Non-streaming spans remain current for the wrapped call, and nested Robin provider instrumentation is suppressed when its optional context key is available.

• MAFSemanticProcessor remains as a compatibility layer for MAF workflow, MCP, and private-prefix attribute normalization. Metrics come from MAF’s native counter and histogram instruments; this package does not export process-cumulative ObservableGauges. Successful spans keep the OpenTelemetry default UNSET status; failed spans keep MAF’s ERROR status.

• react_step_patch (opt-in via ARMS_MAF_REACT_STEP_ENABLED=true) wraps FunctionInvocationLayer.get_response so that each LLM round-trip inside the ReAct loop emits one react step span via ExtendedTelemetryHandler.react_step() from opentelemetry-util-genai.

Truncation / PII helpers are reused from opentelemetry.util.genai.utils (gen_ai_json_dumps), aligned with the OpenAI Agents v2 GenAI instrumentation.

pip install "loongsuite-instrumentation-microsoft-agent-framework[instruments]"

pip install loongsuite-instrumentation-microsoft-agent-framework
pip install agent-framework-core