{"id":27955,"library":"microsoft-agents-a365-runtime","title":"Microsoft Agents A365 Runtime","description":"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.","status":"active","version":"1.0.0","language":"python","source_language":"en","source_url":"https://github.com/microsoft/Agent365-python","tags":["agents","telemetry","tracing","microsoft","azure","opentelemetry","observability"],"install":[{"cmd":"pip install microsoft-agents-a365-runtime","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Core dependency for tracing and metrics","package":"opentelemetry-api","optional":false},{"reason":"Required for exporting telemetry data","package":"opentelemetry-sdk","optional":false},{"reason":"Export telemetry to Azure Monitor (optional)","package":"azure-monitor-opentelemetry-exporter","optional":true}],"imports":[{"note":"Incorrect package name; use dotted module path","wrong":"from microsoft_agents import AgentRuntime","symbol":"AgentRuntime","correct":"from microsoft.agents.a365.runtime import AgentRuntime"},{"note":"Wrong module; telemetry is under runtime subpackage","wrong":"from agents.runtime import enable_telemetry","symbol":"enable_telemetry","correct":"from microsoft.agents.a365.runtime.telemetry import enable_telemetry"},{"note":"No common wrong import known yet","symbol":"TraceExporter","correct":"from microsoft.agents.a365.runtime.tracing import TraceExporter"}],"quickstart":{"code":"import os\nfrom microsoft.agents.a365.runtime import AgentRuntime\nfrom microsoft.agents.a365.runtime.telemetry import enable_telemetry\n\n# Enable telemetry (requires connection string)\nconnection_string = os.environ.get('APPLICATIONINSIGHTS_CONNECTION_STRING', '')\nif connection_string:\n    enable_telemetry(connection_string)\n\n# Create runtime\nruntime = AgentRuntime()\nprint(f\"Agent runtime created: {runtime}\")","lang":"python","description":"Initialize the runtime with optional telemetry from an Application Insights connection string."},"warnings":[{"fix":"Upgrade to Python 3.11 or later.","message":"Python 3.11 minimum: The library requires Python >=3.11. Running on older versions will raise an ImportError.","severity":"breaking","affected_versions":"all"},{"fix":"Set APPLICATIONINSIGHTS_CONNECTION_STRING environment variable before calling enable_telemetry().","message":"Enable telemetry requires Application Insights connection string set in environment or code; otherwise, runtime runs without tracing.","severity":"gotcha","affected_versions":"all"},{"fix":"Change from 'from microsoft_agents...' to 'from microsoft.agents...'.","message":"Direct import from 'microsoft_agents' (underscore) is deprecated; use 'microsoft.agents' (dotted) path.","severity":"deprecated","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Run `pip install microsoft-agents-a365-runtime` in the correct environment.","cause":"The library is not installed or installed into a different Python environment.","error":"ModuleNotFoundError: No module named 'microsoft'"},{"fix":"Use `from microsoft.agents.a365.runtime import AgentRuntime`.","cause":"Using wrong import path; AgentRuntime is under microsoft.agents.a365.runtime.","error":"ImportError: cannot import name 'AgentRuntime' from 'microsoft.agents'"},{"fix":"Pass connection_string parameter or set APPLICATIONINSIGHTS_CONNECTION_STRING env var.","cause":"Called enable_telemetry() without providing the connection string.","error":"TypeError: enable_telemetry() missing 1 required positional argument: 'connection_string'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}