Compartilhar via

McpToolRegistrationService Classe

Fornece serviços de registro de ferramenta MCP para agentes do Azure Foundry.

Esse serviço lida com o registro e o gerenciamento de servidores de ferramentas MCP (Protocolo de Contexto de Modelo) com agentes do Azure Foundry usando o SDK de IA do Azure. Ele fornece integração perfeita entre servidores MCP e a estrutura de agente do Azure Foundry.

Características:

  • Descoberta e configuração automáticas do servidor MCP
  • Integração de identidade do Azure com DefaultAzureCredential
  • Gerenciamento de recursos e definições de ferramenta
  • Suporte para cenários de desenvolvimento (ToolingManifest.json) e produção (API de gateway)
  • Tratamento de erros e registro em log abrangentes

Inicialize o Serviço de Registro de Ferramentas do MCP para o Azure Foundry.

Construtor

McpToolRegistrationService(logger: Logger | None = None, credential: DefaultAzureCredential | None = None)

Parâmetros

Nome Description
logger

Instância do agente para operações de registro em log.

Valor padrão: None
credential

Credencial do Azure para autenticação. Se Nenhum, DefaultAzureCredential será usado.

Valor padrão: None

Exemplos


>>> service = McpToolRegistrationService()
>>> service.add_tool_servers_to_agent(project_client, agent_id, token)

Métodos

add_tool_servers_to_agent

Adiciona servidores de ferramenta MCP a um agente do Azure Foundry.

add_tool_servers_to_agent

Adiciona servidores de ferramenta MCP a um agente do Azure Foundry.

async add_tool_servers_to_agent(project_client: AIProjectClient, auth: Authorization, auth_handler_name: str, context: TurnContext, auth_token: str | None = None) -> None

Parâmetros

Nome Description
project_client
Obrigatório

A instância do Azure Foundry AIProjectClient.
auth
Obrigatório

Manipulador de autorização para troca de token.
auth_handler_name
Obrigatório

Nome do manipulador de autorização.
context
Obrigatório

Transforme o contexto da operação atual.
auth_token

Token de autenticação para acessar os servidores MCP.

Valor padrão: None

Exceções

Tipo Description
ValueError

Se project_client for Nenhum ou os parâmetros necessários forem inválidos.
Exception

Se houver um erro durante o registro da ferramenta MCP.