Agregar y administrar herramientas

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

Paquete: 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:

Paquete: 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:

Paquete: Microsoft.Agents.A365.Tooling

• microsoft-agents-a365-tooling: funcionalidad básica de herramientas
• microsoft-agents-a365-tooling-extensions-agentframework: integración de Agent Framework
• microsoft-agents-a365-tooling-extensions-azureaifoundry: integración de Fundición de IA de Azure
• microsoft-agents-a365-tooling-extensions-openai: integración de OpenAI
• microsoft-agents-a365-tooling-extensions-semantickernel: integración del kernel semántico

• @microsoft/agents-a365-tooling: funcionalidad básica de herramientas
• @microsoft/agents-a365-tooling-extensions-claude: integración de Claude
• @microsoft/agents-a365-tooling-extensions-openai: integración de OpenAI
• @microsoft/agents-a365-tooling-extensions-langchain: integración de LangChain

• Microsoft.Agents.A365.Tooling: funcionalidad básica de herramientas
• Microsoft.Agents.A365.Tooling.Extensions.AgentFramework: integración de Agent Framework
• Microsoft.Agents.A365.Tooling.Extensions.AzureAIFoundry: integración de Fundición de IA de Azure
• Microsoft.Agents.A365.Tooling.Extensions.SemanticKernel: integración del kernel semántico

Python con OpenAI

En este ejemplo se muestra cómo integrar herramientas de MCP con OpenAI en una aplicación de Python.

1. Agregar declaraciones de importación

Agregue las importaciones necesarias para acceder al módulo Herramientas y las extensiones de OpenAI:

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

2. Inicializar servicios de herramientas

Cree instancias de los servicios de configuración y registro de herramientas:

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

3. Registrar herramientas de MCP con el agente de OpenAI

Use el método add_tool_servers_to_agent para registrar todas las herramientas de MCP configuradas con el agente de OpenAI. Este método gestiona escenarios de autenticación tanto de agente como de no 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 de métodos

La tabla siguiente describe los parámetros para usar con add_tool_servers_to_agent.

4. Llamada durante la inicialización

Asegúrese de llamar al método de configuración durante la inicialización antes de ejecutar el agente:

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

El método add_tool_servers_to_agent se realiza automáticamente:

• Carga todos los servidores MCP desde ToolingManifest.json
• Registra sus herramientas con el agente de OpenAI
• Configura la autenticación basada en la configuración del manifiesto
• Hace que las herramientas estén disponibles para que el agente las invoque

JavaScript con LangChain

En este ejemplo se muestra cómo integrar herramientas de MCP con LangChain en una aplicación JavaScript/TypeScript.

1. Agregar declaraciones de importación

Agregue las importaciones necesarias para acceder al módulo Herramientas y las extensiones de LangChain:

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

2. Inicializar servicios de herramientas

Cree una instancia del servicio de registro de herramientas:

const toolService = new McpToolRegistrationService();

3. Registrar herramientas de MCP con el agente de LangChain

Use el método addToolServersToAgent para registrar todas las herramientas de MCP configuradas con el agente de LangChain. Este método gestiona escenarios de autenticación tanto de agente como de no 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 de métodos

La tabla siguiente describe los parámetros para usar con el método addToolServersToAgent.

4. Llamada durante la inicialización

Llame al método addToolServersToAgent durante la inicialización para registrar las herramientas de MCP con el agente.

El método addToolServersToAgent se realiza automáticamente:

• Carga todos los servidores MCP desde ToolingManifest.json
• Registra sus herramientas con el agente de LangChain
• Configura la autenticación basada en la configuración del manifiesto
• Hace que las herramientas estén disponibles para que el agente las invoque

.NET con kernel semántico

En este ejemplo se muestra cómo integrar herramientas de MCP con kernel semántico en una aplicación .NET.

1. Agregar declaraciones de importación

Agregue los espacios de nombres necesarios para acceder al módulo Herramientas y las extensiones de kernel semántico:

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

2. Registrar servicios con inserción de dependencias

Agregue los servicios de herramientas al contenedor de inserción de dependencias para que se puedan insertar en las clases:

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

3. Agregar declaración de campo privado

Declare un campo privado para contener la referencia del servicio de registro de herramientas:

private readonly IMcpToolRegistrationService _toolsService;

4. Registrar herramientas de MCP con kernel semántico

Use el método de extensión AddToolServersToAgentAsync para registrar todas las herramientas de MCP configuradas con la instancia de Kernel semántico. Este método gestiona escenarios de autenticación tanto de agente como de no 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 de métodos

La tabla siguiente describe los parámetros para usar con AddToolServersToAgentAsync

El método AddToolServersToAgentAsync se realiza automáticamente:

• Carga todos los servidores MCP desde ToolingManifest.json
• Registra sus herramientas con el kernel semántico
• Configura la autenticación basada en la configuración del manifiesto
• Hace que las herramientas estén disponibles para que el agente las invoque