Procedure consigliate per l'uso del server MCP di Microsoft Learn

Questo articolo descrive le procedure consigliate per l'uso del server MCP (Learn Docs Model Context Protocol).

Informazioni sul server Learn MCP

Consultare l'articolo Panoramica su Learn MCP Server.

Individuazione dinamica e selezione degli strumenti

I client MCP chiamano strumenti/elenco al momento della connessione per ottenere l'attuale set di strumenti e le loro descrizioni. Gli agenti usano queste descrizioni per decidere quale strumento chiamare e con quali parametri senza mapping manuale richiesto dalla progettazione: il protocollo considera la disponibilità dello strumento come dinamica, non fissa.

Se si sta creando un'integrazione personalizzata, seguire lo stesso modello. Non rendere fissi i nomi degli strumenti, gli schemi dei parametri o il comportamento atteso. Recuperare l'elenco degli strumenti in fase di esecuzione, passare le descrizioni al modello e lasciare che venga instradato. Se una chiamata ha esito negativo con 400 o 404, supponi che la cache sia obsoleta: aggiorna tramite strumenti/elenco e riprova a mantenere resiliente l'integrazione man mano che gli strumenti vengono aggiunti, rinominati o aggiornati, a differenza dei contratti API tradizionali in cui le modifiche che causano interruzioni richiedono aggiornamenti lato client.

Gestione del budget dei token

Aggiungere maxTokenBudget all'URL dell'endpoint per limitare il numero di token nelle risposte di ricerca:

https://learn.microsoft.com/api/mcp?maxTokenBudget=2000

Questo tronca il contenuto nei risultati per rispettare il budget. Utile in caso di esecuzione in cicli agentici in cui ogni chiamata di strumento consuma la finestra di contesto o incide sulla fatturazione. Impostarlo su basso se l'agente esegue molte chiamate a turno, più alto se vuoi risposte singole più avanzate. Il parametro influisce solo sui risultati della ricerca. Il recupero restituisce sempre la pagina completa.

Sperimentare e condividere commenti e suggerimenti

L'uso di un server MCP è un nuovo modo per interagire con il contenuto di Microsoft Learn. Sono stati testati i componenti di questa soluzione, che vengono usati anche in altre applicazioni. Tuttavia, è possibile che si verifichi un comportamento imprevisto, in cui il server MCP non viene usato, non risponde in modo appropriato,

Passaggi successivi

Per altre informazioni su Learn MCP Server, visitare i collegamenti seguenti:

  • Last updated on