Aanbevolen procedures voor het gebruik van de Microsoft Learn MCP-server

In dit artikel worden de aanbevolen procedures beschreven voor het gebruik van de MCP-server (Learn Docs Model Context Protocol).

Meer informatie over de Learn MCP-server

Zie het overzichtsartikel van Learn MCP Server .

Dynamische detectie en selectie van hulpprogramma's

MCP-clients roepen hulpprogramma's/lijsten aan bij de verbinding om de huidige set hulpprogramma's en hun beschrijvingen op te halen. Agents gebruiken deze beschrijvingen om te bepalen welke tool moet worden aangeroepen en met welke parameters zonder dat een handmatige toewijzing nodig is: het protocol behandelt de beschikbaarheid van tools als dynamisch, niet statisch.

Als u een aangepaste integratie bouwt, volgt u hetzelfde patroon. Codeer geen hulpprogrammanamen, parameterschema's of verwacht gedrag. Haal de lijst met hulpprogramma's tijdens runtime op, geef beschrijvingen door aan uw model en laat deze doorsturen. Als een aanroep mislukt met 400 of 404, wordt ervan uitgegaan dat uw cache verlopen is. Vernieuw deze via tools/lijst en probeer uw integratie veerkrachtig te houden omdat tools worden toegevoegd, hernoemd of bijgewerkt, in tegenstelling tot traditionele API-contracten waarbij breaking changes updates aan de klantzijde vereisen.

Beheersing van het tokenbudget

Voeg maxTokenBudget toe aan de eindpunt-URL om het tokenaantal in zoekresultaten te beperken.

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

Hierdoor wordt inhoud afgekapt in resultaten om binnen uw budget te blijven. Handig bij het uitvoeren in agentloops waarbij elke toolaanroep gebruik maakt van uw contextvenster of facturering. Stel deze laag in als uw agent veel aanroepen per beurt doet, hoger als u uitgebreidere antwoorden wilt. De parameter is alleen van invloed op zoekresultaten. Ophalen retourneert altijd de volledige pagina.

Experimenteren en feedback delen

Het gebruik van een MCP-server is een nieuwe manier om te communiceren met Microsoft Learn-inhoud. We hebben de onderdelen van deze oplossing getest, die ook in andere toepassingen worden gebruikt. Toch kan er onverwacht gedrag optreden, waarbij de MCP-server niet wordt gebruikt, het reageert niet op de juiste wijze,

Volgende stappen

Ga naar de volgende koppelingen voor meer informatie over de Learn MCP-server:

  • Last updated on