設計適用於 Microsoft 365 Copilot 的企業營運 MCP 應用程式

企業營運 (LOB) MCP 應用程式可將Microsoft 365 Copilot連線至支援核心商務功能的企業系統,例如 CRM、IT 服務管理、ERP 和人力資源。 本文為開發人員和架構設計人員提供核心設計模式和常見陷阱,以整合來自這些系統的資料、關係、權限和工作流程。

為什麼 LOB MCP 應用程式需要其他設計

在宣告式代理程式中,MCP 應用程式會將互動式應用程式小工具新增至 MCP 工具回應。 Microsoft 365 Copilot 提供交談進入點,MCP 伺服器會連線到外部系統,而應用程式小工具可讓使用者無需離開交談就能檢閱、探索或對資料採取行動。

在 Microsoft 365 Copilot 中工作的使用者經常需要在 Salesforce、ServiceNow、HubSpot、Microsoft Dynamics 365、SAP 商務應用程式、Workday、Jira 和 Coupa 等 LOB) 系統 (企業營運中擷取資訊或執行動作。 這些封裝的企業應用程式包含廣泛的預先建置資料結構、關聯和商務邏輯,組織通常會進一步自訂這些結構、關聯和商務邏輯。 因此,即使是相同 LOB 產品的兩個部署,也可能公開不同的欄位、值、關聯、權限和工作流程。 使用者要求也多種多樣,可以組合公司名稱、篩選器、相關記錄和操作,而無需遵循固定結構。

例如,使用者可能會詢問 Copilot:「尋找 Global Fizz 並顯示其相關的開啟記錄」。 支援這類要求需要的不僅僅是公開用於檢索或更新資料的工具。 MCP 應用程式必須解釋業務術語、根據目標環境進行驗證、解析相關記錄、保留存取控制並協調多步驟工作流程。 這些要求要求在工具設計、資料處理和互動體驗之間需要深思熟慮的模式。

如需基礎指引,請參閱 建置 MCP 外掛程式、 使用 MCP 應用程式新增 UI 以及 MCP 應用程式的 UX 指導方針。

以下設計原則以Salesforce、ServiceNow和HubSpot參考範例為基礎,透過工具設計和互動式工作流程解決資料模型的這些挑戰。

在定義工具之前對應 LOB 資料模型

在定義 Copilot 可以呼叫的 MCP 工具之前,請檢閱支援的交談案例和 LOB 應用程式的資料模型。 每個 LOB 應用程式都有現成可用的資料模型,但組織可以對其進行廣泛自訂。 因此,產品的預設結構描述或參考範例可能與目標環境不相符。 驗證每個實體和欄位,包括其 API 名稱、標籤、資料類型、必要或唯讀狀態、接受的值和關聯。

與 LOB 應用程式自訂團隊合作,以識別特定環境的變更。 讓 MCP 伺服器、工具結構描述和應用程式小工具與目前的資料模型保持一致,以免它們偏離 LOB 系統。

MCP 應用程式元件之間的個別職責

LOB MCP 應用程式必須套用自訂的商務規則、保留來源系統權限、解析相關記錄,以及處理跨代理程式指示、MCP 工具、LOB 整合和應用程式小工具的衍生更新。 將這些職責分開,以便一致地執行規則,並且每一層都可以獨立地進行保護、測試和變更。

  • 使用代理說明和工具描述來指導工具選擇和論點準備。 驗證伺服器上的每個工具呼叫;請勿依賴指令來強制執行權限、允許的值、關聯性或查詢安全性。
  • 使用 MCP 伺服器進入點(接收傳入 MCP 請求的代碼)來路由工具呼叫。 將商務規則、值轉換、關係解析和結果準備保留在這些處理常式使用的工具處理常式或協助程式程式碼中。
  • 使用 LOB 用戶端或配接器進行下游驗證和 API 通訊。 將分頁、重試、節流和來源系統錯誤處理保留在此界限之後。
  • 在來源檔案中建置和維護應用程式小工具。 應用程式小工具會顯示結果、收集輸入,並使用主機橋接器來呼叫 MCP 工具。 它不得儲存認證、進行授權決策,或直接呼叫 LOB API。 從此來源產生可部署的應用程式小工具 HTML;請勿直接編輯產生的檔案。

將驗證比對到 LOB 系統

MCP 端點的驗證和從 MCP 伺服器到 LOB 系統的驗證是不同的界限。 下列選項描述下游 LOB 驗證。 選擇方法之前,請先確認目標系統支援的內容:

  • 委派身分識別 會使用每個使用者的登入權杖。 它會保留每位使用者權限和稽核歷程記錄,但需要 LOB 支援、額外的驗證設定和權杖管理。
  • 應用程式身分識別 使用具有祕密或憑證的用戶端識別碼。 它簡化了服務對服務存取,但 LOB 系統會將動作歸屬於應用程式,而不是使用者。
  • 共用認證會 為每個人使用一個私人權杖、API 金鑰或服務帳戶密碼。 設定很簡單,但 LOB 系統無法套用每位使用者權限或屬性。

如需 MCP 端點選項,請參閱 MCP 驗證。

建立內容相關的體驗,而非其他應用程式

LOB 系統已經為廣泛的工作流程、探索和管理提供了完整的應用程式。 請勿在 MCP 應用程式內重新建立該應用程式或複製其畫面。 複製全螢幕會增加載入時間,並使體驗感覺不那麼交談。 將 LOB MCP 應用程式用於目前交談所需的焦點 UI,並將更廣泛的工作導向 LOB 系統。

讓交談建立工作,並在工作受益於結構化檢閱或互動時使用應用程式小工具。

例如,使用者可能會問:

使用者: 「顯示我的開放中商機本月即將關閉。」

應用程式小工具可以顯示篩選後的記錄以供檢閱和編輯,而不會重現完整的 CRM 體驗。

LOB 資訊通常會分散到相關實體。 了解客戶、案例、員工或供應商可能需要檢視相關記錄,同時將主要記錄保留在上下文中。 使用應用程式小工具狀態和 UX 功能,例如可展開的區段或詳細資料檢視,讓使用者可以探索這些關聯,而不需要針對每個實體提出個別的交談要求。

例如,當使用者要求 Copilot 提供帳戶時,傳回的帳戶會成為應用程式小工具在內容中保留的主要記錄:

使用者: 「顯示全域帳戶。」

顯示帳戶的金鑰欄位,其中包含相關實體的控制項,例如商機、案例和連絡人。 在應用程式小工具狀態中保留帳戶內容。 當選取的檢視需要相關資料時,請使用目前帳戶識別碼透過主機橋接器叫用適當的 MCP 工具。 僅當使用者開啟相關記錄檢視時,才載入相關記錄,並讓主要記錄保持可見。

使用清單顯示要檢閱的重要欄位,並新增可開啟所選記錄詳細表單的 [編輯 ] 按鈕。

顯示相關商務記錄的應用程式小工具 360 度檢視

交談會建立商務內容一次,而使用者介面可讓使用者透過直接互動繼續探索該內容。

初始要求可能會改為命名使用者想要的相關檢視:

使用者: 「顯示全域帳戶的商機。」

只有當使用者需要探索跨記錄時,才使用相關實體周遊體驗。 周遊螢幕較重,因為它們會維護內容並載入多個相關視圖。 讓內嵌應用程式小工具保持焦點。 當周遊需要更多空間時,請使用可保留交談的展開介面。 對於獨立作業,請使用專為該任務設計的焦點應用程式小工具。

使用交談內容預先填入應用程式小工具

當使用者建立 LOB 記錄時,表單可以包含許多必要欄位、控制值欄位和關聯欄位。 使用者通常會在請求中提供其中的一些資訊。 在建立表單中預先填寫這些值,以便使用者檢閱這些值並完成其餘欄位,而不需要重複資訊。 此模式使用交談來提供內容,並使用應用程式小工具來提供結構化檢閱和互動。

例如,使用者的要求可能會提供數個表單欄位的值:

使用者: 「使用電子郵件 maya@contoso.com為 Contoso 的 Maya Chen 建立連絡人。」

show_create_form(
    entity="contact",
    prefill={"first_name": "Maya", "last_name": "Chen",
             "email": "maya@contoso.com", "company_name": "Contoso"}
)

HubSpot 聯絡表單預先填入使用者請求中的資訊

應用程式小工具隨即開啟,並填入這些值,以便使用者檢閱這些值並填寫任何遺失的欄位。 將預先填入的值視為使用者輸入:在建立記錄之前,先在 MCP 伺服器上驗證它們。

當 Microsoft 365 工作內容可以改善工作時,請使用 Work IQ 。 它可以幫助處理涉及「我的」的請求,並提供建立或更新記錄的相關內容。

設計 LOB 資料的工具和互動

圍繞商務營運設計工具

LOB 系統通常會公開具有許多實體和作業的大型複雜 API。 請勿將整個 API 鏡像為 MCP 工具。 定義使用者需要的一組重點商務作業,並為每個工具提供不同的名稱、描述和輸入結構描述。 繼續支援 MCP 伺服器內的工作,例如建置 API 篩選器和解析相關記錄名稱。

一個不受限制的 MCP 工具與重複使用清單、表單和詳細資料小工具的焦點工具的比較

一起設計工具和應用程式小工具。 針對常見的互動類型 (例如清單、表單和詳細資料檢視) 重複使用一小組最佳化的應用程式小工具,而不是為每個工具或實體建立個別的小工具。 這種方法可以保持使用者體驗的一致性,並減少小工具程式碼、載入額外負荷和維護。

為一般作業建立個別工具,例如取得、建立和更新:

get_records(...)
create_record(...)
update_record(...)

還要避免使用接受任何實體和操作的不受限制的工具。 其廣泛的模式使得驗證、授權、路由和結果處理變得難以預測。

在檢視或編輯之前處理記錄相符項目

使用者通常依公司名稱搜尋 LOB 記錄,例如帳戶、公司或連絡人名稱,而不是按穩定的記錄識別碼。 記錄 ID 通常包含許多數字,不切實際地記住或在交談中輸入。 例如,Salesforce 記錄可以有 18 個字元的 ID,例如 0015g00000ABCDeAAH,使用者不太可能知道或輸入。 企業名稱通常是專有名詞,使用者可能會輸入部分值或出現拼字錯誤。 因此,搜尋可以比對零、一或多筆記錄。 在檢視或編輯之前,使用名稱到 ID 解析模式將使用者的文字轉換為經過驗證的穩定記錄 ID。 此方法可防止將作業套用到錯誤的記錄。 永遠不要假設第一個相符項目就是預期的記錄。 在工具結構描述中宣告支援的搜尋欄位和 record-ID 參數。

三步驟記錄解析,顯示依名稱搜尋、刻意比對選取項目,以及依穩定記錄識別碼編輯

例如,使用者可能會依名稱識別要編輯的帳戶:

使用者: 「編輯全域帳戶。」

首先,使用使用者的文字呼叫工具:

get_accounts(name="Global")

MCP 伺服器會將文字對應至支援 Contains 的搜尋或 LIKE 有結果限制的搜尋。 如需將篩選對應至 LOB 查詢運算子的詳細資訊,請參閱 在 MCP 伺服器上建立篩選清單。 當使用者未提供確切的儲存名稱時,此方法會探索候選記錄。 傳回具有每個穩定識別碼和區分記錄所需的可辨識欄位的輕量候選結果:

{
  "structuredContent": {
    "type": "accounts",
    "items": [
      {
        "id": "0015g00000ABCDeAAH",
        "name": "Global Media"
      },
      {
        "id": "0015g00000FGHIjAAH",
        "name": "Global Manufacturing"
      }
    ]
  }
}

傳回候選結果後,根據相符計數繼續。 針對單一明確的相符項目,請使用其識別碼和要求的動作再次呼叫工具。 若有多個相符項目,請顯示含有 [檢視 ] 或 [編輯 ] 控制項的清單;選取的控制項會使用該記錄的識別碼呼叫工具。 在任一情況下,第二次呼叫都會使用已解決的識別碼和要求的動作:

get_accounts(account_id="0015g00000ABCDeAAH", action="edit")

如果沒有相符的記錄,請提示使用者縮小搜尋範圍。

在代理程式指令中Capture此雙呼叫模式,並在工具定義中聲明名稱篩選器和record-ID輸入:

{
    "name": "get_accounts",
    "description": "Get accounts. Pass account_id to retrieve one record; add action='edit' to open the edit form. Filters: name, industry, account_number, and type.",
    "handler": get_accounts,
}

對應控制和選擇清單值及相依性

LOB 系統通常會使用控制值欄位,也稱為選擇清單、選擇欄位或列舉。 使用者會看到例如 的標籤 Closed Won,而 API 可能需要儲存的程式碼,例如 closedwon。 不要假設熟悉的標籤在每個實作中都有相同的儲存值。

控制值欄位只接受在目標 LOB 環境中設定的值。 儲存的值可以是文字代碼、數字或其他系統識別碼。 在查詢或其他 CRUD 要求中使用顯示標籤、任意文字或過時的儲存值可能會導致驗證錯誤、寫入失敗或結果遺失。

從 LOB 中繼資料 API 擷取標籤和代碼,並將它們快取以供參考。 如果 LOB 系統未提供中繼資料 API,請透過系統管理設定來維護和驗證對應。 當來源設定變更時,重新整理快取或已設定的對應,讓工具和應用程式小工具不會漂移。

例如,下列不區分大小寫的查閱會將使用者面向的標籤轉譯成其儲存的程式碼:

label_to_code = {item["label"].casefold(): item["value"] for item in allowed_values}
normalized_value = user_value.casefold()
if normalized_value not in label_to_code:
    raise ValueError("The value is not supported by the LOB system.")
status_code = label_to_code[normalized_value]

當控制值欄位具有相依性 (一個選取範圍會控制另一個選取範圍) 時,會在 MCP 伺服器和應用程式小工具使用的中繼資料中擷取這些關係。 例如,如果 [類別 ] 控制 子類別,選取 [硬體] 應該只顯示其允許的子類別。 寫入 LOB 系統之前,請先在 MCP 伺服器上驗證選取的組合。

valid_codes = dependencies[category_code]
if subcategory_code not in valid_codes:
    raise ValueError("The subcategory is not valid for the selected category.")

在 MCP 伺服器上建置篩選清單

LOB 查詢通常會結合不同欄位類型和相關記錄的條件。 使用者透過業務標籤和名稱來表達這些條件,而 LOB API 需要確切的欄位名稱、儲存的值、資料類型和查詢運算子。 為每個支援的商務實體定義一個焦點清單工具,以便 MCP 伺服器可以驗證、翻譯和執行完整的查詢。

三步驟篩選程序,顯示對應至宣告工具篩選器並傳回為單一篩選清單的商務要求

例如,使用者可能會在商務術語中表示最低金額:

使用者: “顯示至少價值 20,000 的交易。”

代理程式指示會引導 Copilot 將要求與適當的工具進行比對,並僅使用其描述中宣告的篩選條件。 工具架構和處理常式會拒絕不支援的篩選。

在呼叫清單工具之前,請將使用者要求中的每個條件與工具描述中宣告的篩選條件進行比對。 請勿省略不受支援的條件或以不同的篩選條件取代。 當工具不支援要求的篩選時,請使用者修改要求。

Copilot 將「至少 20,000」解譯為最低金額條件。 它之 get_deals 所以選取,是因為工具描述會宣告對應 amount_min 的篩選:

{
    "name": "get_deals",
    "description": "Get deals. Filters: amount_min (inclusive minimum amount), stage.",
    "handler": get_deals,
}

接著,Copilot 會將條件對應至宣告的工具參數:

get_deals(amount_min="20000")

MCP 伺服器會驗證該值,並將工具參數對應至 LOB API 所需的欄位和運算子:

FILTERS = {"amount_min": ("amount", ">=")}

def build_filter(parameter: str, value: str) -> str:
    field, operator = FILTERS[parameter]
    return f"{field} {operator} {float(value)}"

lob_filter = build_filter("amount_min", "20000")

LOB 記錄包含許多資料類型,而且每個類型都需要不同的參數圖形和查詢運算子。 對每個欄位套用一個篩選模式可能會導致無效的查詢或不正確的結果。 將每個支援的資料類型對應至適當的參數和運算子:

資料類型 運算子​​ 參數模式 範例
自由格式文字 Contains 或 LIKE 一個參數 name
控制值 相等 一個參數 stage
相關記錄 相等 一個參數 account_id
數值 下限和上限 *_min, *_max amount_min, amount_max
日期 開始和結束邊界 *_from, *_to close_date_from, close_date_to

對於用於尋找一筆記錄或 Contains 結果的文字篩選,是 LIKE 候選項目,而不是已驗證的身分識別。 在檢視或編輯作業之前,將預定的候選項目解析為其穩定記錄識別碼。

在將每個值新增至 LOB 查詢之前,先驗證並格式化每個值。 將所有條件當做一個伺服器端查詢來執行,而不是要求 Copilot 合併數個工具呼叫的結果,這可能會遺失篩選條件或產生不一致的結果。 傳回一份權威結構化清單。

當使用者在稍後精簡要求時,請保留適用的篩選條件,並只新增或取代已變更的條件:

使用者: “顯示至少價值 20,000 的交易。”

使用者: 「現在只顯示已成交的交易。」

get_deals(amount_min="20000", stage="Closed Won")

在每次精簡後返回相同的結構化清單類型,以便主機一致地呈現結果。

從自然語言請求篩選的 HubSpot 訂單清單

限制和快取清單結果

LOB 實體可能包含數千筆記錄,而且其 API 可能速度緩慢或受到節流。 傳回大型清單會增加回應時間和承載大小,同時顯示它們會讓應用程式小工具不堪重負,並在 Microsoft 365 Copilot 中佔用太多空間。

在 MCP 伺服器上套用預設和最大結果限制、使用可預測的排序,並指出何時有更多記錄可用。 讓使用者精簡其篩選條件,或使用由伺服器端分頁支援的明確 式 [載入更多 ] 動作。

快取合適的清單、中繼資料和相關記錄結果,以減少重複的 LOB API 呼叫:

cache = TTLCache(maxsize=200, ttl=120)
items = None if refresh else cache.get(cache_key)

根據資料變更的頻率選擇到期時間。 在快取金鑰中包含查詢和安全性內容,不要在使用者之間共用使用者特定的結果,並在寫入後使受影響的項目無效。 當使用者要求重新整理或最新的資料時,請略過快取並呼叫 LOB API。

LOB 資料具有高度關聯性。 記錄通常會將帳戶、連絡人、擁有者或其他實體的連結儲存為系統識別碼,而且可以包含自我參照關係,例如上層帳戶或管理員階層。 然而,用戶需要可識別的公司名稱。 使用個別要求解析每個識別碼會建立 N+1 查詢模式,該模式會隨著清單及其關聯的增大而變慢。

三步驟批次解析程序,顯示記錄擷取、唯一外部索引鍵的集合,以及包含已解決客戶和擁有者名稱的清單

首先,使用 LOB API 的關聯投影、聯結或顯示值功能,以傳回與原始查詢相關的名稱。 如果不支援,請收集唯一的外部索引鍵,並使用 LOB 系統的批次關聯、批次讀取或 IN 查詢功能。

遞補流程為:

retrieve records → collect unique foreign keys → batch-read related names

在傳回結構化清單之前,請先解析 MCP 伺服器上的相關值。 此方法會以少量的要求取代每列的查閱,並減少載入時間和節流風險。

在 MCP 伺服器上建置匯總

LOB 實體可以包含數十萬或更多記錄。 摘要和儀表板可以跨類別、階段、擁有者或時間段彙總此資料。 請勿擷取所有基礎記錄,並要求 Copilot 或應用程式小工具計算結果。 在 MCP 伺服器上使用 LOB 彙總 API 或分組查詢,並僅傳回應用程式小工具所需的計算資料。 如果 LOB API 不支援彙總,請在 MCP 伺服器上從有界編頁資料集計算結果,並讓使用者清楚了解範圍。

根據伺服器彙總的商機資料建置的準銷售案源儀表板

在建立記錄之前先解決關聯

使用者可依據公司、連絡人、擁有者或父帳戶等名稱辨識相關記錄,但 LOB API 需要使用者在建立或更新記錄時通常不知道或提供的記錄識別碼。 接受關聯輸入的可辨識名稱,然後在內部將其解析為 LOB API 所需的記錄識別碼。

建立記錄前,顯示兩個相符的授權帳戶和一個受限制帳戶的關聯選項面板

將欄位標記為相關記錄;例如 可以 Company: Contoso 🔗 加強伺服器解析名稱的指示器。

含有 [公司關聯] 欄位和查閱指示器的 HubSpot 連絡表單

當使用者選取 [儲存] 時,請將每個關係解析為使用者有權存取和關聯的一筆相符記錄,然後再呼叫建立 API。 當名稱不明確時,永遠不要選取第一個相符項目:

"Contoso" → company_id="company_123"

如果名稱未解析或不明確,請保持表單及其值開啟,並顯示具有可能相符項目的持續結構化警示。 讓使用者選取想要的記錄,然後重新提交其穩定記錄識別碼。

顯示建議的比對記錄的關聯解析警示

在 中 structuredContent 返回此可修正條件,而不是設定頂層 isError,以便應用程式小工具可以要求修正,而不會將工具呼叫視為失敗。

在更新期間保護關係變更

關係變更會比一般欄位編輯產生更大的業務影響,例如變更帳戶擁有者、重新指派案例,或將連絡人移至另一家公司。

更簡單的模式是在一般編輯表單中將關聯欄位保留為唯讀:

Company: Contoso 🔗    [read-only]

此方法可讓使用者瞭解記錄的關係,而不會使隨之而來的重新指派看起來像是普通的文字編輯。

支援關係變更時,專用工具會將它們與一般更新分開。

使用專用工具執行具有更廣泛效果的動作

有些商務動作不僅僅更新欄位,而且具有專用的 LOB API。 在 CRM 系統中,轉換潛在客戶可以建立相關的客戶、連絡人和商機記錄,並調用其他工作流程規則。

使用專用工具代表這類作業:

convert_lead(lead_id="lead_123", create_opportunity=true)

專用工具會呼叫 LOB 系統的原生作業,而不是透過一般建立或更新呼叫來重建它,這可能會略過驗證、相關記錄建立、工作流程行為和稽核歷程記錄。

透過 ServiceNow 的本機動作解決事件是專用業務營運的另一個範例。

透過專用動作執行 ServiceNow 事件解決

開始建置 LOB MCP 應用程式

使用下列其中一個選項來套用這些設計原則:

  • 自訂有效的應用程式:開啟 Microsoft Copilot 代理程式套件代理程式庫中的 MCP 應用程式索引標籤,以下載適用於 Salesforce CRM、ServiceNow ITSM 和 HubSpot CRM 的工作 LOB MCP 應用程式。 這些應用程式一起示範本文中的模式,並可適應貴組織的資料模型和工作流程。
  • 探索原始程式碼: 檢閱伺服器、應用程式小工具和部署來源的 MCP 互動式 UI 範例 。

將應用程式連線到開發環境、嘗試本文中討論的體驗,並使其適應您自己的 LOB 工作流程。