適用於 Microsoft 365 Copilot 的宣告式代理程式中的 MCP 應用程式使用者體驗指導方針

本指南為在 Microsoft 365 Copilot 中建置 MCP 型 UI 體驗的開發人員提供使用者體驗 (UX) 指引。 它涵蓋用於建立可順利整合到 Copilot 交談流程中的原生、連貫且以工作為中心的互動的模式。


UX 原則

使用以 MCP 為基礎的豐富 UI 建置出色的 Copilot 代理程式,表示提供專注的交談式體驗,並感覺對 Copilot 來說是原生的。 Copilot 代理程式應該會感覺像是交談的實用擴充功能,在正確的時間呈現正確的動作,而不是在 Copilot 內重建的完整應用程式。

提供交談價值

  • 代理程式應該在 Copilot 內提供比獨立 UI 更大的價值。
  • 利用自然語言、執行緒內容和多輪互動來實現在傳統導航模型中困難或低效的工作流程。
  • 設計利用交談而不是複寫現有流程的設計體驗。

擷取功能,不要複寫介面

避免將完整的應用程式體驗移植到 Copilot。 相反,識別可以作為工具公開的高價值原子功能。 每個功能都應該:

  • 只需要最基本的必要輸入。
  • 傳回結構化、可靠的輸出。
  • 讓模型自信地判斷下一步。

設計讓感覺對 Copilot 來說是原生的

  • 利用 Copilot 的設計系統、元件和互動模式,確保提供順暢且可預測的體驗。
  • 一致性可減少認知負荷,提高可預測性,並最大限度地減少使用者學習新互動模型的需求。

保留人為控制

信任是企業採用的基礎。 使用者必須保持最終決策者地位,尤其是當動作影響企業資料時。 提供:

  • 客服專員動作的清晰可見度
  • 敏感性作業的明確確認
  • 建立、修改或更新項目的透明結果

使用意圖縮放密度

調整 UI 的視覺足跡以符合使用者的即時需求。

  • 使用內嵌小工具取得一目了然的摘要和高階動作。
  • 使用展開檢視來執行使用者需要較大空間來與聊天一起工作的工作。

Chat 介面

Chat 介面是使用者與使用 Copilot Apps SDK 建置的代理程式互動的主要方式,定義應用程式在 Copilot 交談中的顯示與行為。

針對 Copilot 進行設計時,請遵循下列核心原則:

  • 交談優先: 聊天仍然是主要的互動模型。
  • 漸進式複雜度: 輕量型開始。 只在需要時展開。
  • 內容保留: 使用者不應遺失交談內容。
  • Clarity重複:應用程式 UI 和模型文字應相互補充,而不是重複內容。

Copilot 目前支援兩個主要聊天介面。 每個表面都有不同的用途,應根據互動的複雜性和深度進行選擇。

  • 所有應用程式都必須支援 內嵌模式,其中內嵌小工具會出現在產生的模型回應之前。
  • 並排模式 是選用介面,可在需要更豐富的互動時使用。

比較 Copilot 聊天中內嵌模式與並排模式的影像


內嵌模式

內嵌模式是 Copilot 中預設的交談中聊天介面。 Inline 不是迷你應用程式。 它增強了對話,而不是取代它。

內嵌模式中的小工具範例

何時使用內嵌模式

內嵌建議用於:

  • 預覽 (文件、影像、草稿)
  • 確認
  • 簡單動作
  • 快速決策提示

內嵌體驗應保持簡潔,且非常適合在回應的單一捲軸中。


內嵌模式版面配置

Copilot 聊天中的內嵌模式版面配置

  • 代理程式標頭: 識別回應代理程式並建立內容。
  • 內嵌小工具: 用來顯示結構化內容、預覽或動作控制項。
  • 模型回應: 在小工具之後顯示的簡短的模型產生訊息,以建議編輯、後續步驟和相關動作。

內嵌小工具

內嵌小工具直接顯示在聊天流程中,讓使用者無需離開對話即可查看資訊並採取行動。 它們提供快速確認、簡單的操作或視覺輔助工具。

  • 標題: 如果您的卡片是基於文件型的,或包含具有父元素的項目,請包含標題
  • 展開至並排檢視: 如果卡片包含多媒體或互動性,請用來開啟並排模式。
  • 動作: 限制為兩個動作,放在卡片底部。 動作應執行交談回合或工具呼叫。
互動指導方針
  • 保持互動專注: 避免多步驟流程、巢狀導覽或深度設定。 如果工作需要反覆運算、比較或大量編輯,請移至 [並排]。
  • 顯示摘要,而非系統: 內嵌顯示預覽,而非完整應用程式。 避免內部捲動、分頁、索引標籤、篩選或多層級分組。
  • 明確狀態: 內嵌互動必須提供清晰的系統回饋,例如載入狀態、停用狀態、成功確認、具有復原選項的錯誤狀態。 切勿僅依靠模型文字來傳達系統狀態。
  • 保留交談流程: 小工具應舒適地放入單一回應捲軸中。 它應該避免佔據視埠。 它應該補充模型回應,而不是與之競爭。

並排模式 (選擇性)

並排模式提供了一個擴展的沉浸式工作區,該工作區會與交談一起顯示。 它專為無法在內嵌表面內有效交付的更豐富的工作流程而設計。 與針對輕量級互動最佳化的內嵌模式不同,並排模式會建立專用的工作區,以進行更深入的互動,同時保留交談內容。

並排模式是選用的,應該刻意使用。

何時使用並排模式

當體驗需要時,請使用並排模式:

  • 多步驟編輯或設定
  • 具有持續性狀態的反覆工作流程
  • 複雜的視覺配置 (表格、畫布、儀表板)
  • 延伸檢閱或比較工作
  • 豐富的創作功能 (文件草稿、設計編輯、結構化輸入)
  • 超越單一捲動的工作區層級互動
  • 如果工作可以在簡潔的單輪互動中完成,請改用內嵌模式。

並排版面配置

Copilot 聊天中的並排版面配置

  • 交談窗格: Copilot 聊天仍然是意圖和控制的主要來源。
  • Chiclet 卡片: 當並排模式處於活動狀態時,原始內嵌小工具會在交談中折疊成一張緊湊的卡片,從而保留與展開的工作區的上下文。
  • 並排面板標頭: 顯示客服專員身分識別 (圖示和名稱) ,並包含整個應用程式的移交選項。
  • 應用程式工作區: 較大的 MCP 轉譯介面,用於編輯、檢閱或管理結構化內容。 這是 Copilot 內的內容相關工作區,不是獨立的應用程式殼層。
  • 關聯式控制項: 工作區內的工作特定控制項 (例如:編輯工具、格式設定、縮放、匯出) 。
互動指導方針
  • 保持工作區與內容相關: 並排模式提供專注的、特定工作的工作區,而不是完整的應用程式殼層。 避免全域導航、多選項卡系統、設置面板或不相關的功能。 如果體驗與整個 SaaS 產品類似,則表示超出範圍。
  • 將聊天保留為主要:對話仍然是意圖和控制的來源。 使用者必須能夠在並排模式開啟時繼續聊天、在工作中提出釐清的問題,並查看 Copilot 在其工作區旁的推理。
  • 作用中任務的範圍: 並排模式應支援單一一致的工作流程。 避免在不相關的實體之間切換並啟動巢狀體驗。 如果需要多個工作流程,請分割成單獨的曲面或動作。
  • 明確狀態: 內嵌互動必須提供清晰的系統回饋,例如載入狀態、停用狀態、成功確認、具有復原選項的錯誤狀態。 切勿僅依靠模型文字來傳達系統狀態。
  • 維持漸進式向上呈報: 應刻意進入並排模式。 請勿預設為並排進行簡單預覽或快速確認。

最佳做法

含有 [下載] 按鈕的小工具螢幕擷取畫面

小工具中 FluentUI 元件的螢幕擷取畫面

✅ 保留交談流程

保持內嵌小工具輕量級且以動作為導向。 最多支援兩個主要動作 (例如,核准、編輯、下載) 。 如果任務需要深度導航、多步驟工作流程或大量配置,請移交到並排模式。

✅ 使用 Fluent 元件實現原生合適度

內嵌體驗應該感覺像是 Copilot 的自然延伸。 使用與 Copilot 對齊的 Fluent 2 元件、間距、印刷樣式和 Token 來確保視覺和互動的一致性。

含有「正在開啟文件」指示器的小工具螢幕擷取畫面

模仿完整應用程式的小工具螢幕擷取畫面

✅ 提供小工具狀態處理

小工具必須提供清晰的系統回饋,例如載入狀態、停用狀態、成功確認以及具有復原選項的錯誤狀態。

❌ 不要使用具完整應用程式外觀的小工具

內嵌模式應該感覺像是聊天的自然延伸,而不是嵌入其中的整個應用程式。

含有自然語言提示的小工具螢幕擷取畫面

具有多個索引標籤的小工具螢幕擷取畫面

❌ 不要在小工具中重複 Copilot 功能

避免在小工具內重新建立聊天功能, (提示輸入、建議、推理摘要、重試控制項) 。 重複會產生混亂、視覺雜訊和碎片化的互動模型。

❌ 避免在小工具中深入瀏覽

小工具不應包含多個索引標籤或更深入的瀏覽。 考慮將它們分割成不同的卡片或工具動作。

具有大型捲軸的小工具螢幕擷取畫面

與模型文字中的內容重複的小工具螢幕擷取畫面

❌ 避免大型且大量捲動的版面配置

內嵌小工具應該簡潔易覽。 避免在小工具內垂直捲動。 高度應該感覺小工具大小,而不是應用程式大小。 如果內容需要捲動、複雜的表格或詳細編輯,請轉換到並排模式。

❌ 不要重複模型文字和小工具中的內容

請勿在小工具和模型訊息中重複相同的資訊。


視覺設計指導方針

視覺和互動的一致性對 Copilot 的使用者體驗至關重要。 應用程式預期會與 Fluent 設計系統一致,讓使用者在應用程式之間體驗可預測的行為、熟悉的控制項和一致的體驗。 這種一致性可協助使用者建立信任、安心地在工作流程之間移動,並安全地在 Copilot 內的多個應用程式之間採取行動。

Fluent Copilot 佈景主題指導方針

使用 Fluent 2 UI 套件建立美觀、具凝聚性的 Microsoft 體驗。 Fluent 2 UI 套件內建於 Figma,包含對應至程式碼庫的設計資產。 這意味著從設計到開發的無縫交接。

按鈕圖像

Fluent 2 > 按鈕:各種 Fluent 按鈕元件的螢幕擷取畫面

印刷

Fluent 2 >印刷:各種文字大小和樣式的螢幕擷取畫面

空格

應用程式卡片的全域填補應該是 24 像素。 卡片周圍填補的螢幕擷取畫面