Bewährte Methoden für die Verwendung des Microsoft Learn MCP-Servers

In diesem Artikel werden die bewährten Methoden für die Verwendung des MCP-Servers (Learn Docs Model Context Protocol) beschrieben.

Grundlegendes zum Learn MCP-Server

Weitere Informationen finden Sie im Übersichtsartikel "Learn MCP Server ".

Dynamische Ermittlung und Toolauswahl

MCP-Clients rufen tools/list bei Verbindungsaufbau auf, um den aktuellen Satz von Tools und deren Beschreibungen abzurufen. Agents verwenden diese Beschreibungen, um zu entscheiden, welches Tool, inklusive der Parameter dafür, aufgerufen werden soll, ohne dass eine manuelle Zuordnung erforderlich ist: Das Protokoll handhabt die Verfügbarkeit von Tools als dynamisch und nicht statisch.

Wenn Sie eine benutzerdefinierte Integration erstellen, folgen Sie demselben Muster. Verwenden Sie keine hart kodierten Toolnamen, Parameterschemata oder erwartetes Verhalten. Rufen Sie die Toolliste zur Laufzeit ab, übergeben Sie Beschreibungen an Ihr Modell, und lassen Sie es routen. Wenn ein Anruf mit 400 oder 404 fehlschlägt, gehen Sie davon aus, dass Ihr Cache veraltet ist – aktualisieren Sie sie über Tools/Liste, und versuchen Sie erneut, Ihre Integration stabil zu halten, da Tools hinzugefügt, umbenannt oder aktualisiert werden, im Gegensatz zu herkömmlichen API-Verträgen, bei denen unterbrechungsbedingte Änderungen Clientupdates erfordern.

Tokenbudgetsteuerung

Fügen Sie maxTokenBudget zur Endpunkt-URL hinzu, um die Tokenanzahl in Suchantworten zu begrenzen.

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

Dadurch werden Inhalte in Ergebnissen abgeschnitten, sodass Ihr Budget gewahrt bleibt. Das ist bei der Ausführung in agentenbasierten Schleifen nützlich, bei denen jeder Toolaufruf Ihr Kontextfenster beansprucht oder Kosten verursacht. Legen Sie ihn niedrig fest, wenn Ihr Agent viele Aufrufe pro Turn ausführt, und höher, wenn Sie detailliertere Einzelantworten wünschen. Der Parameter wirkt sich nur auf Suchergebnisse aus – fetch gibt immer die ganze Seite zurück.

Experimentieren und Teilen von Feedback

Die Verwendung eines MCP-Servers ist eine neue Möglichkeit, mit Microsoft Learn-Inhalten zu interagieren. Wir haben die Komponenten dieser Lösung getestet, die auch in anderen Anwendungen verwendet werden. Dennoch kann es zu unerwartetem Verhalten kommen, bei dem der MCP-Server nicht verwendet wird, er reagiert nicht entsprechend,

Nächste Schritte

Weitere Informationen zum Learn MCP Server finden Sie unter den folgenden Links:

  • Last updated on