使用 Microsoft Learn MCP 伺服器的最佳做法

本文說明使用 Learn Docs 模型內容通訊協定 (MCP) 伺服器的最佳做法。

了解Learn MCP 的伺服器

請參閱 Learn MCP伺服器概述 文章。

動態發現與工具選擇

MCP 用戶端會在連線時呼叫工具/清單,取得目前的工具組合及其描述。 代理利用這些描述決定呼叫哪個工具及使用什麼參數,無需設計上手動映射:協定將工具可用性視為動態,而非固定。

如果你正在建立自訂整合,也要遵循相同的模式。 不要硬編碼工具名稱、參數結構或預期行為。 執行時取得工具清單,將描述傳給模型,讓它路由。 如果呼叫傳回 400 或 404,請假設快取已過期,並透過工具/清單重新整理後重試,以維持整合的韌性。這是因為工具可能會持續新增、重新命名或更新,不同於傳統 API 合約在發生破壞性變更時需要更新用戶端。

代幣預算控制

在端點網址附加 maxTokenBudget,以限制搜尋回應中的標記數量:

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

這樣會截斷結果內容,以維持在您的預算範圍內。 在代理式循環中執行時特別有用,因為每次工具呼叫都會消耗您的內容視窗或增加計費。 如果你的代理人每回合做很多呼叫,就把它設得比較低;如果你想要更豐富的單一回應,就把它調得更高。 這個參數只影響搜尋結果——fetch 總是回傳整頁。

實驗和分享意見反應

使用MCP伺服器是與 Microsoft Learn 內容互動的新方式。 我們測試了這個解決方案的組件,這些元件也被應用於其他應用中。 不過,你可能會遇到意想不到的狀況,比如 MCP 伺服器沒被使用,導致它無法正確回應,

後續步驟

您可以瀏覽下列連結,以深入瞭解 Learn MCP 伺服器: