Ajouter et gérer les outils

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

Paramètres :

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

Paramètres :

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

Paramètres :

Package : Microsoft.Agents.A365.Tooling

• microsoft-agents-a365-tooling : fonctionnalité d’outils de base
• microsoft-agents-a365-tooling-extensions-agentframework : intégration d’Agent Framework
• microsoft-agents-a365-tooling-extensions-azureaifoundry : intégration d’Azure AI Foundry
• microsoft-agents-a365-tooling-extensions-openai : intégration d’OpenAI
• microsoft-agents-a365-tooling-extensions-semantickernel : intégration de Semantic Kernel

• @microsoft/agents-a365-tooling : fonctionnalité d’outils de base
• @microsoft/agents-a365-tooling-extensions-claude : intégration de Claude
• @microsoft/agents-a365-tooling-extensions-openai : intégration d’OpenAI
• @microsoft/agents-a365-tooling-extensions-langchain: intégration de LangChain

• Microsoft.Agents.A365.Tooling: fonctionnalité d’outils de base
• Microsoft.Agents.A365.Tooling.Extensions.AgentFramework: intégration d’Agent Framework
• Microsoft.Agents.A365.Tooling.Extensions.AzureAIFoundry : intégration d’Azure AI Foundry
• Microsoft.Agents.A365.Tooling.Extensions.SemanticKernel : intégration de Semantic Kernel

Python avec OpenAI

Cet exemple montre comment intégrer des outils MCP à OpenAI dans une application Python.

1. Ajouter des instructions d’importation

Ajoutez les importations requises pour accéder au module Tooling et aux extensions OpenAI :

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

2. Initialiser les services d’outils

Créez des instances des services d’inscription de configuration et d’outil :

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

3. Inscrire des outils MCP auprès de l’assistant OpenAI

Utilisez la méthode add_tool_servers_to_agent pour inscrire tous les outils MCP configurés auprès de votre assistant OpenAI. Cette méthode gère à la fois les scénarios d’authentification agentique et nonagentique :

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

Paramètres de la méthode

La table suivante décrit les paramètres à utiliser avec add_tool_servers_to_agent.

4. Appel pendant l’initialisation

Veillez à appeler la méthode d’installation pendant l’initialisation avant d’exécuter l’assistant :

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

La méthode add_tool_servers_to_agent automatiquement :

• Charge tous les serveurs MCP à partir du ToolingManifest.json
• Inscrit ses outils auprès de l’assistant OpenAI
• Configure l’authentification en fonction de la configuration du manifeste
• Rend les outils disponibles pour que votre assistant appelle

JavaScript avec LangChain

Cet exemple montre comment intégrer des outils MCP à LangChain dans une application JavaScript/TypeScript.

1. Ajouter des instructions d’importation

Ajoutez les importations requises pour accéder au module Tooling et aux extensions LangChain :

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

2. Initialiser les services d’outils

Créez une instance du service d’inscription d’outil :

const toolService = new McpToolRegistrationService();

3. Inscrire des outils MCP auprès de l’assistant LangChain

Utilisez la méthode addToolServersToAgent pour inscrire tous les outils MCP configurés auprès de votre assistant LangChain. Cette méthode gère à la fois les scénarios d’authentification agentique et nonagentique :

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

Paramètres de la méthode

La table suivante décrit les paramètres à utiliser avec la méthode addToolServersToAgent.

4. Appel pendant l’initialisation

Appelez la méthode addToolServersToAgent pendant l’initialisation pour inscrire des outils MCP auprès de votre assistant.

La méthode addToolServersToAgent automatiquement :

• Charge tous les serveurs MCP à partir du ToolingManifest.json
• Inscrit ses outils auprès de l’assistant LangChain
• Configure l’authentification en fonction de la configuration du manifeste
• Rend les outils disponibles pour que votre assistant appelle

.NET avec Semantic Kernel

Cet exemple montre comment intégrer des outils MCP à Semantic Kernel dans une application .NET.

1. Ajouter des instructions d’importation

Ajoutez les espaces de noms requis pour accéder au module d’outils et aux extensions Semantic Kernel :

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

2. Enregistrer des services avec l’injection de dépendances

Ajoutez les services d’outils à votre conteneur d’injection de dépendances afin qu’ils puissent être injectés dans vos classes :

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

3. Ajouter une déclaration de champ privé

Déclarez un champ privé pour contenir la référence du service d’inscription d’outil :

private readonly IMcpToolRegistrationService _toolsService;

4. Inscrire des outils MCP avec Semantic Kernel

Utilisez la méthode d’extension AddToolServersToAgentAsync pour inscrire tous les outils MCP configurés avec votre instance Semantic Kernel. Cette méthode gère à la fois les scénarios d’authentification agentique et nonagentique :

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

Paramètres de la méthode

La table suivante décrit les paramètres à utiliser avec AddToolServersToAgentAsync

La méthode AddToolServersToAgentAsync automatiquement :

• Charge tous les serveurs MCP à partir du ToolingManifest.json
• Inscrit ses outils avec Semantic Kernel
• Configure l’authentification en fonction de la configuration du manifeste
• Rend les outils disponibles pour que votre assistant appelle