Microsoft Agents A365 Runtime

1.0.0 verified Sat May 09 auth: no python

Telemetry, tracing, and monitoring components for AI agents built with the Microsoft Agents framework. Part of the Agent365 ecosystem, this runtime enables observability for agent workloads. Current version 1.0.0, supports Python >=3.11.

pip install microsoft-agents-a365-runtime

Common errors

error ModuleNotFoundError: No module named 'microsoft' ↓

cause The library is not installed or installed into a different Python environment.

fix

Run pip install microsoft-agents-a365-runtime in the correct environment.

error ImportError: cannot import name 'AgentRuntime' from 'microsoft.agents' ↓

cause Using wrong import path; AgentRuntime is under microsoft.agents.a365.runtime.

fix

Use from microsoft.agents.a365.runtime import AgentRuntime.

error TypeError: enable_telemetry() missing 1 required positional argument: 'connection_string' ↓

cause Called enable_telemetry() without providing the connection string.

fix

Pass connection_string parameter or set APPLICATIONINSIGHTS_CONNECTION_STRING env var.

Warnings

breaking Python 3.11 minimum: The library requires Python >=3.11. Running on older versions will raise an ImportError. ↓

fix Upgrade to Python 3.11 or later.

gotcha Enable telemetry requires Application Insights connection string set in environment or code; otherwise, runtime runs without tracing. ↓

fix Set APPLICATIONINSIGHTS_CONNECTION_STRING environment variable before calling enable_telemetry().

deprecated Direct import from 'microsoft_agents' (underscore) is deprecated; use 'microsoft.agents' (dotted) path. ↓

fix Change from 'from microsoft_agents...' to 'from microsoft.agents...'.

Imports

AgentRuntime

wrong

from microsoft_agents import AgentRuntime

correct

from microsoft.agents.a365.runtime import AgentRuntime

Incorrect package name; use dotted module path

enable_telemetry

wrong

from agents.runtime import enable_telemetry

correct

from microsoft.agents.a365.runtime.telemetry import enable_telemetry

Wrong module; telemetry is under runtime subpackage

TraceExporter

from microsoft.agents.a365.runtime.tracing import TraceExporter

No common wrong import known yet

Quickstart

Initialize the runtime with optional telemetry from an Application Insights connection string.

import os
from microsoft.agents.a365.runtime import AgentRuntime
from microsoft.agents.a365.runtime.telemetry import enable_telemetry

# Enable telemetry (requires connection string)
connection_string = os.environ.get('APPLICATIONINSIGHTS_CONNECTION_STRING', '')
if connection_string:
    enable_telemetry(connection_string)

# Create runtime
runtime = AgentRuntime()
print(f"Agent runtime created: {runtime}")