添加和管理工具

# Use McpToolServerConfigurationService.list_tool_servers
from microsoft.agents.a365.tooling import McpToolServerConfigurationService

config_service = McpToolServerConfigurationService()
tool_servers = await config_service.list_tool_servers(agentic_app_id, auth_token)

参数：

包：microsoft_agents_a365.tooling

// Use McpToolServerConfigurationService.listToolServers
const { McpToolServerConfigurationService } = require('@microsoft/agents-a365-tooling');

const configService = new McpToolServerConfigurationService();
const toolServers = await configService.listToolServers(agentUserId, authToken);

参数：

包：@microsoft/agents-a365-tooling

// Use IMcpToolServerConfigurationService.ListToolServersAsync
using Microsoft.Agents.A365.Tooling.Services;

var configService = serviceProvider.GetRequiredService<IMcpToolServerConfigurationService>();
var toolServers = await configService.ListToolServersAsync(agentInstanceId, authToken);

参数：

包：Microsoft.Agents.A365.Tooling.Services

• microsoft_agents_a365.tooling：核心工具功能
• microsoft_agents_a365.tooling.extensions.agentframework：Agent Framework集成
• microsoft_agents_a365.tooling.extensions.azureaifoundry：Azure AI Foundry 集成
• microsoft_intelligent_agents_a365.tooling.extensions.openai: OpenAI 集成
• microsoft_intelligent_agents_a365.tooling.extensions.semantickernel: 语义内核 集成

• @microsoft/intelligent_agents-a365-tooling: 核心工具功能
• @microsoft/agents-a365-tooling-extensions-claude: Claude 集成
• @microsoft/agents-a365-tooling-extensions-openai: OpenAI 集成
• @microsoft/agents-a365-tooling-extensions-langchain: LangChain 集成

• Microsoft.Agents.A365.Tooling.Services: 核心工具功能
• Microsoft.Agents.A365.Tooling.Extensions.AgentFramework.Services: Agent Framework集成
• Microsoft.Agents.A365.Tooling.Extensions.AzureAIFoundry.Services: Azure AI Foundry 集成
• Microsoft.Agents.A365.Tooling.Extensions.SemanticKernel.Services: 语义内核 集成

Python 与 OpenAI

此示例演示了如何在 Python 应用程序中将 MCP 工具与 OpenAI 集成。

1. 添加导入语句

添加必要的导入语句以访问 Tooling 模块和 OpenAI 扩展：

from microsoft.agents.a365.tooling import McpToolServerConfigurationService
from microsoft.agents.a365.tooling.extensions.openai import mcp_tool_registration_service

2. 初始化工具服务

创建配置服务和工具注册服务的实例：

# Create configuration service and tool service with dependency injection
self.config_service = McpToolServerConfigurationService()
self.tool_service = mcp_tool_registration_service.McpToolRegistrationService()

3. 将 MCP 工具注册到 OpenAI 智能体

使用 add_tool_servers_to_agent 方法将所有已配置的 MCP 工具注册到您的 OpenAI 智能体。 该方法同时支持智能体式和非智能体式身份验证场景：

async def setup_mcp_servers(self, auth: Authorization, context: TurnContext):
    """Set up MCP server connections"""
    try:
        use_agentic_auth = os.getenv("USE_AGENTIC_AUTH", "false").lower() == "true"
        if use_agentic_auth:
            self.agent = await self.tool_service.add_tool_servers_to_agent(
                agent=self.agent,
                agentic_app_id=agentic_app_id,
                auth=auth,
                context=context,
            )
        else:
            self.agent = await self.tool_service.add_tool_servers_to_agent(
                agent=self.agent,
                agentic_app_id=agentic_app_id,
                auth=auth,
                context=context,
                auth_token=self.auth_options.bearer_token,
            )

    except Exception as e:
        logger.error(f"Error setting up MCP servers: {e}")

方法参数

下表描述了 add_tool_servers_to_agent 方法的参数说明。

4. 在初始化期间调用

请确保在运行智能体之前，于初始化期间调用 setup 方法：

# Setup MCP servers during initialization
await self.setup_mcp_servers(auth, context)

add_tool_servers_to_agent 方法会自动：

• 从 ToolingManifest.json 文件中加载所有 MCP 服务器。
• 将这些服务器的工具注册到 OpenAI 智能体。
• 根据清单配置设置身份验证。
• 使智能体能够调用这些工具。

使用 LangChain 的 JavaScript

此示例演示了如何在 JavaScript 或 TypeScript 应用程序中将 MCP 工具与 LangChain 集成。

1. 添加导入语句

添加所需的导入以访问工具模块和 LangChain 扩展：

import { McpToolServerConfigurationService } from '@microsoft/agents-a365-tooling';
import { McpToolRegistrationService } from '@microsoft/agents-a365-tooling-extensions-langchain';

2. 初始化工具服务

创建工具注册服务的实例：

const toolService = new McpToolRegistrationService();

3. 将 MCP 工具注册到 LangChain 智能体

使用 addToolServersToAgent 方法将所有已配置的 MCP 工具注册到您的 LangChain 智能体。 该方法同时支持智能体式和非智能体式身份验证场景：

// Get MCP Tools
try {
  const agent = await toolService.addToolServersToAgent(
    agent,
    process.env.AGENTIC_USER_ID || '',
    authorization,
    turnContext,
    process.env.MCP_AUTH_TOKEN || "",
  );
} catch (error) {
  console.error('Error adding MCP tool servers:', error);
}

方法参数

下表描述了 addToolServersToAgent 方法使用的参数。

4. 在初始化期间调用

在初始化过程中调用 addToolServersToAgent 方法，将 MCP 工具注册到您的智能体中。

addToolServersToAgent 方法会自动：

• 从 ToolingManifest.json 文件中加载所有 MCP 服务器。
• 使用 LangChain 智能体注册其工具。
• 根据清单配置设置身份验证。
• 使智能体能够调用这些工具。

具有语义内核的 .NET

本示例演示了如何在 .NET 应用程序中将 MCP 工具与 语义内核 集成。

1. 添加导入语句

添加必要的命名空间以访问 Tooling 模块和 语义内核 扩展：

using Microsoft.Agents.A365.Tooling;
using Microsoft.Agents.A365.Tooling.Extensions.SemanticKernel;

2. 使用依赖注入注册服务

将工具服务添加到依赖注入容器中，以便将其注入到类中：

builder.Services.AddSingleton<IMcpToolRegistrationService, McpToolRegistrationService>();
builder.Services.AddSingleton<IMcpToolServerConfigurationService, McpToolServerConfigurationService>();

3. 添加私有字段声明

声明一个私有字段来保存工具注册服务的引用：

private readonly IMcpToolRegistrationService _toolsService;

4. 将 MCP 工具注册到 语义内核

使用 AddToolServersToAgentAsync 扩展方法将所有已配置的 MCP 工具注册到您的 语义内核 实例中。 该方法同时支持智能体式和非智能体式身份验证场景：

// Simplified call (authentication configured automatically)
await toolService.AddToolServersToAgentAsync(kernel, userAuthorization, turnContext);

// Or with explicit authentication parameters:
if (useAgenticAuth)
{
    await toolService.AddToolServersToAgentAsync(kernel, userAuthorization, authHandlerName, turnContext);
}
else
{
    await toolService.AddToolServersToAgentAsync(kernel, userAuthorization, authHandlerName, turnContext, authToken);
}

方法参数

下表描述了与 AddToolServersToAgentAsync 一起使用的参数。

AddToolServersToAgentAsync 方法会自动：

• 从 ToolingManifest.json 文件中加载所有 MCP 服务器。
• 将他们的工具注册到语义内核。
• 根据清单配置设置身份验证。
• 使智能体能够调用这些工具。