Condividi tramite

McpToolRegistrationService Classe

Fornisce i servizi di registrazione degli strumenti MCP per gli agenti di Azure Foundry.

Questo servizio gestisce la registrazione e la gestione dei server degli strumenti MCP (Model Context Protocol) con gli agenti di Azure Foundry usando Azure AI SDK. Offre una perfetta integrazione tra i server MCP e il framework agente di Azure Foundry.

Funzionalità:

  • Individuazione e configurazione automatica del server MCP
  • Integrazione delle identità di Azure con DefaultAzureCredential
  • Definizioni degli strumenti e gestione delle risorse
  • Supporto per scenari di sviluppo (ToolingManifest.json) e produzione (API gateway)
  • Gestione e registrazione degli errori completi

Inizializzare il servizio di registrazione dello strumento MCP per Azure Foundry.

Costruttore

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

Parametri

Nome Descrizione
logger

Istanza del logger per le operazioni di registrazione.

Valore predefinito: None
credential

Credenziali di Azure per l'autenticazione. Se None, verrà usato DefaultAzureCredential.

Valore predefinito: None

Esempio


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

Metodi

add_tool_servers_to_agent

Aggiunge server di strumenti MCP a un agente di Azure Foundry.

add_tool_servers_to_agent

Aggiunge server di strumenti MCP a un agente di 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

Parametri

Nome Descrizione
project_client
Necessario

Istanza di Azure Foundry AIProjectClient.
auth
Necessario

Gestore di autorizzazione per lo scambio di token.
auth_handler_name
Necessario

Nome del gestore di autorizzazione.
context
Necessario

Contesto di turno per l'operazione corrente.
auth_token

Token di autenticazione per accedere ai server MCP.

Valore predefinito: None

Eccezioni

Tipo Descrizione
ValueError

Se project_client è None o i parametri obbligatori non sono validi.
Exception

Se si verifica un errore durante la registrazione dello strumento MCP.