microsoft-agents-a365-observability-extensions-agent-framework 0.1.0__py3-none-any.whl

microsoft_agents_a365/observability/extensions/agentframework/__init__.py

@@ -0,0 +1,2 @@
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.

microsoft_agents_a365/observability/extensions/agentframework/span_processor.py

@@ -0,0 +1,35 @@
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
+
+# Custom Span Processor
+
+from opentelemetry.sdk.trace.export import SpanProcessor
+
+from microsoft_agents_a365.observability.core.constants import (
+    GEN_AI_OPERATION_NAME_KEY,
+    EXECUTE_TOOL_OPERATION_NAME,
+    GEN_AI_EVENT_CONTENT,
+)
+
+
+class AgentFrameworkSpanProcessor(SpanProcessor):
+    """
+    SpanProcessor for Agent Framework.
+    """
+
+    TOOL_CALL_RESULT_TAG = "gen_ai.tool.call.result"
+
+    def __init__(self, service_name: str | None = None):
+        self.service_name = service_name
+        super().__init__()
+
+    def on_start(self, span, parent_context):
+        if hasattr(span, "attributes"):
+            operation_name = span.attributes.get(GEN_AI_OPERATION_NAME_KEY)
+            if isinstance(operation_name, str) and operation_name == EXECUTE_TOOL_OPERATION_NAME:
+                tool_call_result = span.attributes.get(self.TOOL_CALL_RESULT_TAG)
+                if tool_call_result is not None:
+                    span.set_attribute(GEN_AI_EVENT_CONTENT, tool_call_result)
+
+    def on_end(self, span):
+        pass

microsoft_agents_a365/observability/extensions/agentframework/trace_instrumentor.py

@@ -0,0 +1,49 @@
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
+
+from __future__ import annotations
+
+from collections.abc import Collection
+from typing import Any
+
+from microsoft_agents_a365.observability.core.config import get_tracer_provider, is_configured
+from opentelemetry.instrumentation.instrumentor import BaseInstrumentor
+
+from microsoft_agents_a365.observability.extensions.agentframework.span_processor import (
+    AgentFrameworkSpanProcessor,
+)
+
+# -----------------------------
+# 3) The Instrumentor class
+# -----------------------------
+_instruments = ("agent-framework-azure-ai >= 1.0.0b251114",)
+
+
+class AgentFrameworkInstrumentor(BaseInstrumentor):
+    """
+    Instruments Agent Framework:
+      • Installs your custom OTel SpanProcessor
+    """
+
+    def __init__(self):
+        if not is_configured():
+            raise RuntimeError(
+                "Microsoft Agent 365 (or your telemetry config) is not initialized. Configure it before instrumenting."
+            )
+        super().__init__()
+
+    def instrumentation_dependencies(self) -> Collection[str]:
+        return _instruments
+
+    def _instrument(self, **kwargs: Any) -> None:
+        """
+        kwargs (all optional):
+        """
+
+        # Ensure we have an SDK TracerProvider
+        provider = get_tracer_provider()
+        self._processor = AgentFrameworkSpanProcessor()
+        provider.add_span_processor(self._processor)
+
+    def _uninstrument(self, **kwargs: Any) -> None:
+        pass

microsoft_agents_a365_observability_extensions_agent_framework-0.1.0.dist-info/METADATA

@@ -0,0 +1,69 @@
+Metadata-Version: 2.4
+Name: microsoft-agents-a365-observability-extensions-agent-framework
+Version: 0.1.0
+Summary: Agent Framework observability and tracing extensions for Microsoft Agent 365
+Author-email: Microsoft <support@microsoft.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/microsoft/Agent365-python
+Project-URL: Repository, https://github.com/microsoft/Agent365-python
+Project-URL: Issues, https://github.com/microsoft/Agent365-python/issues
+Project-URL: Documentation, https://github.com/microsoft/Agent365-python/tree/main/libraries/microsoft-agents-a365-observability-extensions-agentframework
+Keywords: observability,telemetry,tracing,opentelemetry,agent-framework,agents,ai
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: microsoft-agents-a365-observability-core>=0.0.0
+Requires-Dist: opentelemetry-api>=1.36.0
+Requires-Dist: opentelemetry-sdk>=1.36.0
+Requires-Dist: opentelemetry-instrumentation>=0.47b0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest>=7.0.0; extra == "test"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "test"
+
+# microsoft-agents-a365-observability-extensions-agentframework
+
+[![PyPI](https://img.shields.io/pypi/v/microsoft-agents-a365-observability-extensions-agentframework?label=PyPI&logo=pypi)](https://pypi.org/project/microsoft-agents-a365-observability-extensions-agentframework)
+[![PyPI Downloads](https://img.shields.io/pypi/dm/microsoft-agents-a365-observability-extensions-agentframework?label=Downloads&logo=pypi)](https://pypi.org/project/microsoft-agents-a365-observability-extensions-agentframework)
+
+Observability extensions for Microsoft Agent Framework. This package provides OpenTelemetry tracing integration specifically for Agent Framework-based applications.
+
+## Installation
+
+```bash
+pip install microsoft-agents-a365-observability-extensions-agentframework
+```
+
+## Usage
+
+For usage examples and detailed documentation, see the [Observability documentation](https://learn.microsoft.com/microsoft-agent-365/developer/observability?tabs=python) on Microsoft Learn.
+
+## Support
+
+For issues, questions, or feedback:
+
+- File issues in the [GitHub Issues](https://github.com/microsoft/Agent365-python/issues) section
+- See the [main documentation](../../../README.md) for more information
+ 
+## Trademarks
+ 
+*Microsoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the documentation may be either trademarks or registered trademarks of Microsoft in the United States and/or other countries. The licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks. Microsoft's general trademark guidelines can be found at http://go.microsoft.com/fwlink/?LinkID=254653.*
+
+## License
+
+Copyright (c) Microsoft Corporation. All rights reserved.
+
+Licensed under the MIT License - see the [LICENSE](../../../LICENSE.md) file for details.

microsoft_agents_a365_observability_extensions_agent_framework-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+microsoft_agents_a365/observability/extensions/agentframework/__init__.py,sha256=HIog-luBqQnLkza1Q8b34Rr1QVu6tuiAy5sOry0vIPg,73
+microsoft_agents_a365/observability/extensions/agentframework/span_processor.py,sha256=hJmgRSUpdH35NwTs281B7MIhGhTosdCnONxzUigJCAg,1114
+microsoft_agents_a365/observability/extensions/agentframework/trace_instrumentor.py,sha256=WO1pGk9NHwIt4AwyDFDE4-tkDsLr_AUk3vZRCzbdgC0,1486
+microsoft_agents_a365_observability_extensions_agent_framework-0.1.0.dist-info/METADATA,sha256=Eh1I_mICE2aQojWPdhM2hvCAQe27-J_egZr5GWSDKvc,3625
+microsoft_agents_a365_observability_extensions_agent_framework-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+microsoft_agents_a365_observability_extensions_agent_framework-0.1.0.dist-info/top_level.txt,sha256=G3c2_4sy5_EM_BWO67SbK2tKj4G8XFn-QXRbh8g9Lgk,22
+microsoft_agents_a365_observability_extensions_agent_framework-0.1.0.dist-info/RECORD,,

microsoft_agents_a365_observability_extensions_agent_framework-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

microsoft_agents_a365_observability_extensions_agent_framework-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+microsoft_agents_a365