共用方式為


使用模型內容通訊協定擴充代理程式

使用工具擴充代理程式的另一種方式是透過模型內容通訊協定(MCP)。

什麼是模型上下文協定?

模型上下文協定 (MCP) 可讓使用者直接在 Copilot Studio 內連接現有的知識伺服器和資料來源。 連接到 MCP 伺服器後您可以存取:

  • 資源:用戶端應用程式可以讀取的類似文件的資料 (例如 API 回應或文件內容)
  • 工具:語言模型可以呼叫的函數
  • 提示:預先定義的提示範本以完成特定任務

注意

Copilot Studio 目前僅支援工具。

MCP 如何運作?

MCP 伺服器發行的每個工具都會自動新增為 Copilot Studio 中的工具。 名稱、描述、輸入和輸出均從伺服器繼承。 當 MCP 伺服器上的工具更新或移除時,Copilot Studio 會動態反映這些變化,確保使用者始終擁有最新版本並且刪除過時的工具。 單一 MCP 伺服器可以整合及管理多個工具,每個工具都可做為 Copilot Studio 中的工具存取。

當您連線到非Microsoft產品,包括外部 MCP 伺服器時,您必須負責您在 Copilot Studio 中存取的工具和數據。

注意

必須啟用生成式協調流程才能使用 MCP。

在 Copilot Studio 中使用 MCP 擴充代理程式的程序為何?

要將 MCP 整合到 Copilot Studio 中:

  1. 建立 MCP 伺服器
  2. 根據下列提供的 YAML 架構範本建立自訂 MCP 連接器
  3. 將現有 MCP 連接器中的工具新增至 Agent,即可透過 Copilot Studio 取用
  4. (選擇性) 發佈 MCP 連接器 ,以允許跨租使用者使用連接器。

建立 MCP 伺服器

您可以使用 MCP 軟體開發工具套件 (SDK) 以其中一種支援的語言設定 MCP 伺服器。

建立自訂 MCP 連接器

支援的傳輸方式

在 MCP 中,傳輸是用戶端-伺服器通訊的基礎。 傳輸處理發送和接收訊息的機制。 Copilot Studio 目前支援下列傳輸類型:

  • 可串流 - 建議使用 (已正式發行)
  • 伺服器傳送事件 (SSE) (公開預覽版)

注意

假設 SSE 傳輸 已被取代,MCS 中的 SSE 傳輸支援仍為公開預覽狀態。 從 2025 年 8 月開始,Copilot Studio 將不再支援 MCP 的 SSE。

設定自訂連接器

設定好 MCP 伺服器後,您必須為 MCP 伺服器設定自訂連接器 (透過 Power Apps 或 Power Automate)。 若要執行此程式,您需要 MCP 伺服器的架構檔案。 此模式文件是一個 OpenAPI 規範 YAML 文件,用於描述您的 MCP 伺服器的 API。

如需規格檔案外觀的指引,請參閱提供的 一些 MCP 伺服器架構範例

  1. 在左側導覽中選擇代理程式

  2. 從代理程式清單中選擇您的代理程式。

  3. 移至代理程式的 [工具] 頁面。

  4. 選取 [新增工具]。

  5. 選取 [新增工具]。

  6. 選取 [自定義連接器]。 您將前往 Power Apps 來建立新的自訂連接器。

  7. 選取新增自訂連接器

  8. 選擇匯入 OpenAPI 檔案

  9. 導覽到您的架構文件,然後選擇匯入以匯入該文件。

  10. 選取 [繼續] 以完成 Power Apps 中的設定。 您可以在 Power Apps 文件中的匯入 OpenAPI 定義中閱讀有關設定過程的更多資訊。

MCP 伺服器架構範例

以下是兩個使用虛構數據的 MCP 伺服器使用 YAML 格式的 OpenAPI 架構檔案範例。 這些範例示範每個支援的傳輸。 您需要填寫您自己的 MCP 伺服器的詳細資訊。

以下是適用於 Streamable 的 YAML 範例(建議):

swagger: '2.0'
info:
  title: Contoso
  description: MCP Test Specification, YAML for streamable MCP support in Copilot Studio
  version: 1.0.0
host: contoso.com
basePath: /
schemes:
  - https
paths:
  /mcp:
    post:
      summary: Contoso Lead Management Server
      x-ms-agentic-protocol: mcp-streamable-1.0
      operationId: InvokeMCP
      responses:
        '200':
          description: Success

以下是 SSE 的 YAML 範例:


swagger: '2.0'
info:
  title: Contoso
  description: MCP Test Specification, YAML for SSE MCP support in Copilot Studio
  version: 1.0.0
host: contoso.com
basePath: /
schemes:
  - https
paths:
  /mcp/sse:
    get:
      summary: Contoso Lead Management Server
      x-ms-agentic-protocol: mcp-sse-1.0
      operationId: InvokeMCP
      responses:
        '200':
          description: Success 

Microsoft COPilot Studio 中提供的 MCP 連接器

Microsoft提供數個預先建置的 MCP 連接器,以聯機到 Copilot Studio 中的Microsoft服務。 以下是 Copilot Studio 中提供的Microsoft MCP 連接器:

  • Dataverse
  • Dynamics 365
    • 銷售
    • 金融
    • 供應鏈
    • 服務
  • 織物

將工具從現有的 MCP 連接器新增至代理程式

您可以直接從 Copilot Studio 內部連線到現有的 MCP 伺服器。 新增工具的程式是相同的,無論是針對預先建置Microsoft MCP 連接器,還是針對您自己建立的 MCP 連接器。

若要將現有的 MCP 連接器新增至代理程式,請遵循下列步驟:

  1. 在左側導覽中選擇代理程式

  2. 從清單中選擇您的代理程式。

  3. 移至代理程式的 [工具] 頁面。

  4. 選取 [新增工具]。

  5. 選取 [模型內容通訊協定]。 MCP 連接器的清單隨即顯示。

  6. 從清單中選擇所需的 MCP 連接器。

  7. 授權連接,輸入所需的任何資訊。

  8. 完成時,請選取 [新增至代理程式 ] 或 [ 新增並設定 ] 繼續進行。

    第一個選項只會將 MCP 連接器及其工具新增至代理程式,而第二個選項則新增連接器及其工具,同時讓您有機會設定連接器的詳細數據。

MCP 工具會在 [ 工具] 底下新增至您的代理程式。

檢視 MCP 連接器隨附的工具清單

若要查看新增至 Agent 的 MCP 伺服器附帶的工具清單:

  1. 請移至您的代理程式的工具頁籤。

  2. 從工具清單中選取 MCP 連接器。

    MCP 連接器的設定頁面隨即出現。

  3. 移至 [工具] 區段,以查看 MCP 伺服器所支援的工具清單。

已知問題和計劃的改進

以下是產品團隊已知曉且正在努力解決的問題:

問題 解決方案/解決方法
目前,Open SSE 連線呼叫中傳回的端點必須是完整的 URI。 不適用