什麼是訊息延伸模組？

  • 5 分鐘

當您建置訊息擴充功能時，您會建置適用於 Microsoft Teams 的應用程式，該應用程式會延伸至 Microsoft 365。 擴充應用程式可讓它顯示在 Microsoft Outlook 中，並在 Microsoft 365 Copilot 中顯示為外掛程式。

擴充Microsoft Teams 應用程式稱為Microsoft 365 應用程式。 Microsoft 365 應用程式會使用常見的應用程式指令清單、應用程式封裝格式，以及您用來建置適用於 Microsoft Teams 之應用程式的開發人員和系統管理員工具。

訊息擴充功能是一項應用程式功能，其會使用 Bot 在使用者與外部系統之間進行通訊。

訊息擴充功能

應用程式指令清單中定義了訊息延伸模組的功能、它在使用者介面中的顯示方式，以及可支援的互動。

命令和訊息處理程式是訊息擴充功能可以具備的功能。 訊息擴充功能可以使用搜尋和動作命令，以及訊息處理程序的組合。

命令有兩種類型：

  • 搜尋命令可讓使用者搜尋外部系統，並將該搜尋的結果以卡片的形式插入訊息中。
  • 動作命令，可讓使用者對 Teams 中的訊息採取行動，並顯示可用來收集或顯示資訊的強制回應快顯。

此信息圖顯示Microsoft Teams 用戶介面中搜尋和動作命令之間的視覺和功能差異。

當具有特定網域的 URL 貼到撰寫消息框時，訊息處理程式可讓您的訊息擴充功能將連結展開。

Microsoft Teams 撰寫消息框中鏈接的螢幕快照。調適型卡片會內嵌在訊息撰寫區域中。

搜尋命令

搜尋命令可用來搜尋外部系統，並以豐富的格式卡片傳回結果。 建置 Microsoft 365 Copilot 訊息擴充功能外掛程式時，您需要包含訊息擴充功能搜尋命令的應用程式。

Microsoft Teams 中以搜尋為基礎的訊息延伸模組所傳回的搜尋結果螢幕快照。

訊息擴充功能如何運作？

訊息擴充功能會使用向 Bot Framework 註冊的 Bot，在用戶端與外部系統之間進行通訊。

Bot Framework 是由 Microsoft 所提供的平臺，可為您提供建置、測試、部署及管理 Bot 所需的工具和服務。

訊息擴充功能包含 Bot 資源、Microsoft Entra 應用程式註冊，以及使用 Bot Framework SDK 來處理使用者互動的程式代碼。

下圖顯示訊息延伸模組的高階結構：

顯示訊息延伸模組高階結構的圖表。

Bot 服務會向 Bot Framework 註冊 Bot，並在使用者與訊息擴充功能互動時接收來自用戶端的要求。 它會將要求傳送至包含 Bot 程式代碼的 Web 服務。 Web 服務會使用 Microsoft Entra 中的 Bot 應用程式註冊認證，向 Bot 服務進行驗證。 它會從外部系統收集數據，並將數據傳回 Bot 服務，而 Bot 服務會傳回給用戶端。

假設使用者使用訊息擴充功能起始搜尋。 下列循序圖顯示互動：

此圖顯示當使用者起始搜尋，且訊息延伸模組將搜尋結果傳回給使用者時，訊息延伸模組元件之間的互動。

  1. 使用者會在客戶端開啟訊息延伸模組，並輸入搜尋查詢。
  2. 用戶端會透過包含使用者查詢相關信息的通道端點，將要求傳送至 Bot 服務。
  3. Bot 服務會將要求傳送至 Web 服務上公開的傳訊端點，以處理用戶查詢。
  4. 傳訊端點會接收要求並叫用 Bot 配接器。 Bot 配接器會使用 Bot Microsoft Entra 應用程式註冊認證，以保護 Web 服務與 Bot 服務之間的通訊。
  5. Bot 配接器會 OnTeamsMessageExtensionQuery 在 Bot 活動處理程式類別上叫用 方法，其中包含處理傳入要求的邏輯。
  6. Bot 活動處理程式會從外部系統取得數據。 它會建立 ， MessageExtensionResult其中包含外部資料做為格式豐富的卡片，並建立 MessageExtensionResponse包含的 MessageExtensionResult。
  7. Bot 配接器會從 Bot 活動處理程式接收回應，並建立 HTTP 回應。
  8. 傳訊端點會將回應傳回給 Bot 服務。
  9. Bot 服務會透過通道端點將回應傳回訊息擴充功能。
  10. 訊息延伸模組會在用戶端中轉譯回應，並將搜尋結果顯示給使用者。

無論您的訊息擴充功能支援、搜尋或動作命令，或連結解除混淆，都發生相同的流程。 Bot 服務會將要求轉送至您的 Web 服務，以處理並響應該要求。