本頁面提供互動式 Google Chat 擴充應用程式的建構方式總覽。互動式 Chat 擴充應用程式是建構為 Google Workspace 外掛程式，可擴充 Google Chat。
使用者可以透過互動式 Chat 應用程式執行下列操作：
- 將即時通訊應用程式加入即時通訊聊天室或直接訊息。
- 與含有文字、資訊卡和互動式 UI 元素的 Chat 應用程式互傳訊息。
- 在與 Chat 應用程式的個人即時訊息中，查看「首頁」資訊卡並與之互動。這張資訊卡位於「首頁」分頁中。
- 使用斜線指令、快速指令或訊息動作提示 Chat 應用程式。
- 預覽即時通訊訊息中的連結，直接在對話中採取行動。
- 將資訊提交至 Chat 應用程式，例如在對話方塊或資訊卡訊息中輸入文字。
- 在各種 Google Workspace 應用程式中自動或手動執行工作，以及連結外部工具或服務。
使用者如何探索及使用互動式 Chat 擴充應用程式
在 Chat 中，擴充 Chat 功能的外掛程式會顯示為 Google Chat 應用程式。使用者可以透過多種方式探索及使用發布至市集的 Chat 應用程式，包括：
- 從 Google Chat 或 Marketplace 搜尋及安裝 Chat 擴充應用程式。
- 與已新增至 Chat 聊天室的 Chat 擴充應用程式互動。
- Google Workspace 管理員代表使用者安裝 Chat 應用程式後，使用者就能在即時訊息面板中找到該應用程式。
如要開始使用 Chat 應用程式，Google Chat 使用者可以傳送即時訊息給 Chat 應用程式，或將其新增至聊天室。使用者也可以 @提及 Chat 應用程式來新增。詳情請參閱「使用 Chat 擴充應用程式」。
以下範例說明使用者如何 @提及 Google Chat 應用程式，將其新增至聊天室：
開始使用
如要開始建構互動式 Chat 應用程式，請參閱下列說明文件：
- 設定 Google Chat API，並為 Chat 應用程式啟用互動式功能。
- 瞭解如何使用觸發條件、事件物件和動作，接收及回應使用者互動。
- 請嘗試快速入門，為您偏好的 Google Chat 應用程式架構建構基本 Chat 應用程式。
設定及建立基本 Chat 應用程式
下表列出各Google Chat 應用程式架構的說明文件，說明如何設定 Chat API，以及建立基本的互動式 Chat 應用程式：
| 架構或工作 | 指南 |
|---|---|
| 設定 Chat API | 設定 Google Chat API |
| 快速入門導覽課程 | |
| Apps Script | 使用 Apps Script 建構 Chat 擴充應用程式 |
| HTTP 服務 (Cloud Run 函式) | 建構 HTTP Chat 擴充應用程式 |
| Pub/Sub | 使用 Pub/Sub 建構 Chat 擴充應用程式 |
| Dialogflow CX | 建構 Dialogflow CX Chat 擴充應用程式 |
| Dialogflow ES | 建構 Dialogflow ES Chat 擴充應用程式 |
| Agent Development Kit (ADK) AI 代理 | 建構 ADK AI 代理 Chat 擴充應用程式 |
| Agent2Agent (A2A) AI 代理程式 | 建構 A2A AI 代理程式 Chat 擴充應用程式 |
| A2UI AI 代理 | 建構 A2UI AI 代理 Chat 應用程式 |
| Gemini Enterprise AI 代理 | 建構 Gemini Enterprise AI 代理程式 Chat 應用程式 |
建構互動功能
下表列出建構互動式 Google Chat 應用程式功能的文件：
| 功能 | 指南 |
|---|---|
| 接收及回應使用者互動 | 接收及回應使用者互動 |
| 傳送訊息 (回覆互動或主動傳送) | 回覆訊息或 使用 Chat API 傳送訊息 |
| 回應斜線指令、快速指令和訊息動作 | 回應指令 |
| 建構互動式對話方塊 | 開啟互動式對話方塊 |
| 收集及處理來自資訊卡和對話方塊的資訊 | 讀取使用者在資訊卡上輸入的表單資料 |
| 預覽 Chat 訊息中的連結 | 預覽連結 |
| 在 1 對 1 即時訊息中建構首頁 (應用程式首頁) | 為 Chat 擴充應用程式建立首頁 |
| 連結外部系統和工具 | 將 Chat 應用程式連結至其他服務和工具 |
Google Workspace 外掛程式的限制和注意事項
由於 Chat 應用程式是建構為擴充 Chat 的 Google Workspace 外掛程式，請注意下列功能限制：
- AppSheet 建構為 Google Workspace 外掛程式時，無法使用 Chat 擴充應用程式架構。請改用 HTTP 服務、Apps Script、Dialogflow ES、Dialogflow CX 或 Pub/Sub 建立即時通訊應用程式。
- Chat 不支援自訂授權卡。如要從 Chat 驗證服務並授予授權，Chat 應用程式必須傳回基本授權資訊卡。
- 系統不支援 Chat 側欄中的外掛程式首頁。如果您已在資訊清單 (
addons.common.homepageTrigger) 中設定首頁觸發條件，首頁只會顯示在擴充功能延伸的其他 Google Workspace 應用程式側欄中。您可以為 Chat 應用程式建立首頁，這類首頁會顯示在與 Chat 應用程式進行 1 對 1 即時訊息對話的首頁分頁中。
如要擴充現有的 Google Workspace 外掛程式，讓它能在 Chat 中運作，請考量 Chat 擴充應用程式的下列設定需求：
- Google Workspace Marketplace 安裝設定必須允許個人和 Google Workspace 管理員安裝外掛程式。
- Chat 會忽略外掛程式資訊清單 (
addons.common) 中的任何常見設定。如要設定外掛程式在 Chat 中運作，請務必啟用並設定 Chat API。如需相關步驟，請參閱「設定 Google Chat API」。 - 如要在 Chat 中部署及測試外掛程式，必須使用 Chat API 的「顯示設定」。系統會忽略您在 Google Workspace Marketplace SDK 中設定的任何瀏覽權限或測試設定。如要在 Chat 中部署外掛程式的測試版本，請參閱「測試 Google Chat 應用程式的互動功能」。
- 如果外掛程式已發布到 Google Workspace Marketplace，您就無法儲存對 Google Chat API 設定所做的任何變更草稿。更新 Chat API 設定後，所有現有使用者都能立即使用更新後的 Chat 應用程式。如要更新市集資訊，請先建立草稿，再提交變更。
相關主題
非外掛程式的 Chat 擴充應用程式：建構互動式 Google Chat 擴充應用程式
不是 Google Workspace 外掛程式的 Chat 應用程式會建構為僅限 Chat 的應用程式，接收Chat API 互動事件 (Event)，而不是 Google Workspace 外掛程式事件物件 (EventObject) 和動作。
如果您維護的 Chat 應用程式不是外掛程式，可以採取下列行動：
- 將非外掛程式的 Chat 擴充應用程式，轉換為可擴充 Google Chat 的 Google Workspace 外掛程式。請參閱「將 Google Chat 擴充應用程式轉換為 Google Workspace 外掛程式」。
- 如需要求和回應格式，請參閱本文件集各互動式功能指南底部的「不屬於外掛程式的即時通訊應用程式」可展開章節。