Najlepsze rozwiązania dotyczące korzystania z serwera MICROSOFT Learn MCP

W tym artykule opisano najlepsze rozwiązania dotyczące korzystania z serwera MCP (Learn Docs Model Context Protocol).

Omówienie serwera Learn MCP

Zobacz artykuł Omówienie serwera MCP Learn .

Odnajdywanie dynamiczne i wybieranie narzędzi

Klienci MCP wywołają narzędzia/listę w połączeniu, aby uzyskać bieżący zestaw narzędzi i ich opisów. Agenci używają tych opisów, aby zdecydować, które narzędzie uruchomić i z jakimi parametrami, bez potrzeby ręcznego odwzorowania zaplanowanego w projekcie: protokół postrzega dostępność narzędzi jako dynamiczną, zamiast stałą.

Jeśli tworzysz integrację niestandardową, postępuj zgodnie z tym samym wzorcem. Nie należy kodować nazw narzędzi, schematów parametrów ani oczekiwanego zachowania. Pobierz listę narzędzi w czasie wykonywania, przekaż opisy do modelu i pozwól mu kierować. Jeśli wywołanie zakończy się niepowodzeniem z błędem 400 lub 404, uznaj, że pamięć podręczna jest przestarzała — odśwież przez narzędzia/listę i spróbuj ponownie, aby utrzymać odporność integracji, ponieważ narzędzia są dodawane, zmieniane lub aktualizowane, w przeciwieństwie do tradycyjnych kontraktów interfejsu API, gdzie zmiany powodujące niezgodność wymagają aktualizacji klienta.

Kontrola budżetu tokenu

Dołącz wartość maxTokenBudget do adresu URL punktu końcowego, aby ograniczyć liczbę tokenów w odpowiedziach wyszukiwania:

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

Dzięki temu zawartość w wynikach jest skracana, aby zmieścić się w budżecie. Przydatne podczas uruchamiania w pętlach agentowych, w których każde wywołanie narzędzia wykorzystuje okno kontekstu lub wpływa na rozliczenia. Ustaw go na niskim poziomie, jeśli agent wykonuje wiele wywołań na turę; ustaw wyższą, jeśli potrzebujesz bogatszych pojedynczych odpowiedzi. Parametr ma wpływ tylko na wyniki wyszukiwania — pobieranie zawsze zwraca pełną stronę.

Eksperymentowanie i udostępnianie opinii

Korzystanie z serwera MCP to nowy sposób interakcji z zawartością usługi Microsoft Learn. Przetestowaliśmy składniki tego rozwiązania, które są również używane w innych aplikacjach. Mimo to może wystąpić nieoczekiwane zachowanie, gdy serwer MCP nie jest używany lub nie odpowiada właściwie.

Dalsze kroki

Aby dowiedzieć się więcej na temat serwera Learn MCP Server, odwiedź następujące linki: