Adicionar e gerir ferramentas

# 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)

**Parâmetros:

Pacote: 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);

**Parâmetros:

Pacote: 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);

**Parâmetros:

Pacote: Microsoft.Agents.A365.Tooling

• microsoft-agents-a365-tooling: Funcionalidade principal das ferramentas
• microsoft-agents-a365-tooling-extensions-agentframework: Integração com o Agent Framework
• microsoft-agents-a365-tooling-extensions-azureaifoundry: Azure AI Foundry integration
• microsoft-agents-a365-tooling-extensions-openAI: Integração com OpenAI
• microsoft-agents-a365-tooling-extensions-semantickernel: Integração com o Kernel Semântico

• @microsoft/agents-a365-tooling: Funcionalidade principal das ferramentas
• @microsoft/agents-a365-tooling-extensions-claude: Integração com Claude
• @microsoft/agents-a365-tooling-extensions-openai: Integração com OpenAI
• @microsoft/agents-a365-tooling-extensions-langchain: Integração com LangChain

• Microsoft.Agents.A365.Tooling: Funcionalidade principal das ferramentas
• Microsoft.Agents.A365.Tooling.Extensions.AgentFramework: Integração com o Agent Framework
• Microsoft.Agents.A365.Tooling.Extensions.AzureAIFoundry: Azure AI Foundry integration
• Microsoft.Agents.A365.Tooling.Extensions.SemanticKernel: Integração com o Semantic Kernel

Python com OpenAI

Este exemplo mostra como integrar ferramentas MCP com OpenAI numa aplicação Python.

Adicionar instrução de importação.

Adicione as importações necessárias para aceder ao módulo de Ferramentas e às extensões OpenAI:

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

2. Inicializar serviços de ferramentas

Crie instâncias dos serviços de configuração e registo de ferramentas:

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

3. Registar ferramentas MCP com o agente OpenAI

Use o add_tool_servers_to_agent método para registar todas as ferramentas MCP configuradas junto do seu agente OpenAI. Este método lida com cenários de autenticação tanto agentica como não agente:

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}")

Parâmetros do método

A tabela que se segue descreve os parâmetros a considerar.

4. Chamada durante a inicialização

Certifique-se de que chama o método de configuração durante a inicialização antes de executar o agente:

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

O add_tool_servers_to_agent método automaticamente:

• Carrega todos os servidores MCP a partir da ToolingManifest.json
• Regista as suas ferramentas com o agente OpenAI
• Configura a autenticação com base na configuração do manifesto
• Disponibiliza as ferramentas para o seu agente invocar

JavaScript com LangChain

Este exemplo mostra como integrar ferramentas MCP com LangChain numa aplicação JavaScript/TypeScript.

Adicionar instrução de importação.

Adicione as importações necessárias para aceder ao módulo de Ferramentas e às extensões LangChain:

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

2. Inicializar serviços de ferramentas

Crie uma instância do serviço de registo de ferramentas:

const toolService = new McpToolRegistrationService();

3. Registar ferramentas MCP com o agente LangChain

Use o addToolServersToAgent método para registar todas as ferramentas MCP configuradas junto do seu agente LangChain. Este método lida com cenários de autenticação tanto agentica como não agente:

// 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);
}

Parâmetros do método

A tabela seguinte descreve os parâmetros a utilizar com o addToolServersToAgent método.

4. Chamada durante a inicialização

Ligue ao addToolServersToAgent método durante a inicialização para registar as ferramentas MCP junto do seu agente.

O addToolServersToAgent método automaticamente:

• Carrega todos os servidores MCP a partir da ToolingManifest.json
• Regista as suas ferramentas junto do agente LangChain
• Configura a autenticação com base na configuração do manifesto
• Disponibiliza as ferramentas para o seu agente invocar

.NET com Kernel Semântico

Este exemplo mostra como integrar ferramentas MCP com o Kernel Semântico numa aplicação .NET.

Adicionar instrução de importação.

Adicione os namespaces necessários para aceder ao módulo de Ferramentas e às extensões do Kernel Semântico:

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

2. Serviços de registo com injeção de dependências

Adicione os serviços de ferramentas ao seu contentor de injeção de dependências para que possam ser injetados nas suas classes:

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

3. Adicionar declaração privada de campo

Declare um campo privado para guardar a referência do serviço de registo de ferramentas:

private readonly IMcpToolRegistrationService _toolsService;

4. Ferramentas MCP de registos com Kernel Semântico

Use o método de AddToolServersToAgentAsync extensão para registar todas as ferramentas MCP configuradas com a sua instância do Kernel Semântico. Este método lida com cenários de autenticação tanto agentica como não agente:

// 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);
}

Parâmetros do método

A tabela que se segue descreve os parâmetros a considerar.

O AddToolServersToAgentAsync método automaticamente:

• Carrega todos os servidores MCP a partir da ToolingManifest.json
• Regista as suas ferramentas com o Kernel Semântico
• Configura a autenticação com base na configuração do manifesto
• Disponibiliza as ferramentas para o seu agente invocar