microsoft-agents-a365-tooling-extensions-agentframework 0.1.0__py3-none-any.whl

microsoft_agents_a365/tooling/extensions/agentframework/__init__.py

@@ -0,0 +1,27 @@
+# Copyright (c) Microsoft. All rights reserved.
+
+"""
+Agent 365 Tooling Agent Framework Extensions
+
+Agent Framework specific tools and services for AI agent development.
+Provides Agent Framework-specific implementations and utilities for
+building agents with Microsoft Agent Framework capabilities.
+
+Main Service:
+- McpToolRegistrationService: Add MCP tool servers to Agent Framework agents
+
+This module includes implementations for:
+- Agent Framework agent creation with MCP (Model Context Protocol) server support
+- MCP tool registration service for dynamically adding MCP servers to agents
+- Azure OpenAI and OpenAI chat client integration
+- Authentication and authorization patterns for MCP server discovery
+"""
+
+__version__ = "1.0.0"
+
+# Import services from the services module
+from .services import McpToolRegistrationService
+
+__all__ = [
+    "McpToolRegistrationService",
+]

microsoft_agents_a365/tooling/extensions/agentframework/services/__init__.py

@@ -0,0 +1,14 @@
+# Copyright (c) Microsoft. All rights reserved.
+
+"""
+Services module for Agent Framework tooling.
+
+This package contains service implementations for MCP tool registration
+and management within the Agent Framework.
+"""
+
+from .mcp_tool_registration_service import McpToolRegistrationService
+
+__all__ = [
+    "McpToolRegistrationService",
+]

microsoft_agents_a365/tooling/extensions/agentframework/services/mcp_tool_registration_service.py

@@ -0,0 +1,158 @@
+# Copyright (c) Microsoft. All rights reserved.
+
+from typing import Optional, List, Any, Union
+import logging
+
+from agent_framework import ChatAgent, MCPStreamableHTTPTool
+from agent_framework.azure import AzureOpenAIChatClient
+from agent_framework.openai import OpenAIChatClient
+
+from microsoft_agents.hosting.core import Authorization, TurnContext
+
+from microsoft_agents_a365.runtime.utility import Utility
+from microsoft_agents_a365.tooling.services.mcp_tool_server_configuration_service import (
+    McpToolServerConfigurationService,
+)
+from microsoft_agents_a365.tooling.utils.constants import Constants
+
+from microsoft_agents_a365.tooling.utils.utility import (
+    get_mcp_platform_authentication_scope,
+)
+
+
+class McpToolRegistrationService:
+    """
+    Provides MCP tool registration services for Agent Framework agents.
+
+    This service handles registration and management of MCP (Model Context Protocol)
+    tool servers with Agent Framework agents.
+    """
+
+    def __init__(self, logger: Optional[logging.Logger] = None):
+        """
+        Initialize the MCP Tool Registration Service for Agent Framework.
+
+        Args:
+            logger: Logger instance for logging operations.
+        """
+        self._logger = logger or logging.getLogger(self.__class__.__name__)
+        self._mcp_server_configuration_service = McpToolServerConfigurationService(
+            logger=self._logger
+        )
+        self._connected_servers = []
+
+    async def add_tool_servers_to_agent(
+        self,
+        chat_client: Union[OpenAIChatClient, AzureOpenAIChatClient],
+        agent_instructions: str,
+        initial_tools: List[Any],
+        auth: Authorization,
+        auth_handler_name: str,
+        turn_context: TurnContext,
+        auth_token: Optional[str] = None,
+    ) -> Optional[ChatAgent]:
+        """
+        Add MCP tool servers to a chat agent (mirrors .NET implementation).
+
+        Args:
+            chat_client: The chat client instance (Union[OpenAIChatClient, AzureOpenAIChatClient])
+            agent_instructions: Instructions for the agent behavior
+            initial_tools: List of initial tools to add to the agent
+            auth: Authorization context for token exchange
+            auth_handler_name: Name of the authorization handler.
+            turn_context: Turn context for the operation
+            auth_token: Optional bearer token for authentication
+
+        Returns:
+            ChatAgent instance with MCP tools registered, or None if creation failed
+        """
+        try:
+            # Exchange token if not provided
+            if not auth_token:
+                scopes = get_mcp_platform_authentication_scope()
+                authToken = await auth.exchange_token(turn_context, scopes, auth_handler_name)
+                auth_token = authToken.token
+
+            agentic_app_id = Utility.resolve_agent_identity(turn_context, auth_token)
+
+            self._logger.info(f"Listing MCP tool servers for agent {agentic_app_id}")
+
+            # Get MCP server configurations
+            server_configs = await self._mcp_server_configuration_service.list_tool_servers(
+                agentic_app_id=agentic_app_id,
+                auth_token=auth_token,
+            )
+
+            self._logger.info(f"Loaded {len(server_configs)} MCP server configurations")
+
+            # Create the agent with all tools (initial + MCP tools)
+            all_tools = list(initial_tools)
+
+            # Add servers as MCPStreamableHTTPTool instances
+            for config in server_configs:
+                try:
+                    server_url = getattr(config, "server_url", None) or getattr(
+                        config, "mcp_server_unique_name", None
+                    )
+                    if not server_url:
+                        self._logger.warning(f"MCP server config missing server_url: {config}")
+                        continue
+
+                    # Prepare auth headers
+                    headers = {}
+                    if auth_token:
+                        headers[Constants.Headers.AUTHORIZATION] = (
+                            f"{Constants.Headers.BEARER_PREFIX} {auth_token}"
+                        )
+
+                    server_name = getattr(config, "mcp_server_name", "Unknown")
+
+                    # Create and configure MCPStreamableHTTPTool
+                    mcp_tools = MCPStreamableHTTPTool(
+                        name=server_name,
+                        url=server_url,
+                        headers=headers,
+                        description=f"MCP tools from {server_name}",
+                    )
+
+                    # Let Agent Framework handle the connection automatically
+                    self._logger.info(f"Created MCP plugin for '{server_name}' at {server_url}")
+
+                    all_tools.append(mcp_tools)
+                    self._connected_servers.append(mcp_tools)
+
+                    self._logger.info(f"Added MCP plugin '{server_name}' to agent tools")
+
+                except Exception as tool_ex:
+                    server_name = getattr(config, "mcp_server_name", "Unknown")
+                    self._logger.warning(
+                        f"Failed to create MCP plugin for {server_name}: {tool_ex}"
+                    )
+                    continue
+
+            # Create the ChatAgent
+            agent = ChatAgent(
+                chat_client=chat_client,
+                tools=all_tools,
+                instructions=agent_instructions,
+            )
+
+            self._logger.info(f"Agent created with {len(all_tools)} total tools")
+            return agent
+
+        except Exception as ex:
+            self._logger.error(f"Failed to add tool servers to agent: {ex}")
+            raise
+
+    async def cleanup(self):
+        """Clean up any resources used by the service."""
+        try:
+            for plugin in self._connected_servers:
+                try:
+                    if hasattr(plugin, "close"):
+                        await plugin.close()
+                except Exception as cleanup_ex:
+                    self._logger.debug(f"Error during cleanup: {cleanup_ex}")
+            self._connected_servers.clear()
+        except Exception as ex:
+            self._logger.debug(f"Error during service cleanup: {ex}")

microsoft_agents_a365_tooling_extensions_agentframework-0.1.0.dist-info/METADATA

@@ -0,0 +1,68 @@
+Metadata-Version: 2.4
+Name: microsoft-agents-a365-tooling-extensions-agentframework
+Version: 0.1.0
+Summary: Agent Framework integration tools for Agent 365 AI agent tooling
+Author-email: Microsoft <support@microsoft.com>
+License: 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-tooling-extensions-agentframework
+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
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: microsoft-agents-a365-tooling>=0.0.0
+Requires-Dist: microsoft-agents-hosting-core<0.6.0,>=0.4.0
+Requires-Dist: agent-framework-azure-ai>=1.0.0b251114
+Requires-Dist: azure-identity>=1.12.0
+Requires-Dist: typing-extensions>=4.0.0
+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-tooling-extensions-agentframework
+
+[![PyPI](https://img.shields.io/pypi/v/microsoft-agents-a365-tooling-extensions-agentframework?label=PyPI&logo=pypi)](https://pypi.org/project/microsoft-agents-a365-tooling-extensions-agentframework)
+[![PyPI Downloads](https://img.shields.io/pypi/dm/microsoft-agents-a365-tooling-extensions-agentframework?label=Downloads&logo=pypi)](https://pypi.org/project/microsoft-agents-a365-tooling-extensions-agentframework)
+
+Agent Framework specific tools and services for AI agent development. Provides MCP (Model Context Protocol) tool registration service for dynamically adding MCP servers to Agent Framework agents.
+
+## Installation
+
+```bash
+pip install microsoft-agents-a365-tooling-extensions-agentframework
+```
+
+## Usage
+
+For usage examples and detailed documentation, see the [Tooling documentation](https://learn.microsoft.com/microsoft-agent-365/developer/tooling?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_tooling_extensions_agentframework-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+microsoft_agents_a365/tooling/extensions/agentframework/__init__.py,sha256=IPaHio1uop6iVK6KYeI5ERhTm3uPQRO6__21SYQqpQ4,880
+microsoft_agents_a365/tooling/extensions/agentframework/services/__init__.py,sha256=TcxL8IstydK8bZ2H3hFVKRvO67VYDqY7JOTBEA9ylXc,338
+microsoft_agents_a365/tooling/extensions/agentframework/services/mcp_tool_registration_service.py,sha256=Ic_yrUMQZs-Vc5IcSKMMdZCX1oZVJZw1EkDzyX14Q2c,6237
+microsoft_agents_a365_tooling_extensions_agentframework-0.1.0.dist-info/METADATA,sha256=N95eYNQEubpQgB2CzQ7EX6uQLnr4W08_gE9jdwnQdaU,3493
+microsoft_agents_a365_tooling_extensions_agentframework-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+microsoft_agents_a365_tooling_extensions_agentframework-0.1.0.dist-info/top_level.txt,sha256=G3c2_4sy5_EM_BWO67SbK2tKj4G8XFn-QXRbh8g9Lgk,22
+microsoft_agents_a365_tooling_extensions_agentframework-0.1.0.dist-info/RECORD,,

microsoft_agents_a365_tooling_extensions_agentframework-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_tooling_extensions_agentframework-0.1.0.dist-info/top_level.txt

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