容器 V2

容器 V2 較初始容器有顯著改良，且會持續提供最新功能和異動。為確保服務專員隨時都能取得最實用的建議和重要工具，第 2 版採用動態面板的反應式顯示方式，並提供統一的建議資訊動態饋給。

用量

使用下列程式碼，將模組匯入 HTML 頁面：

<script src="https://www.gstatic.com/agent-assist-ui-modules/v2/container.js"></script>

使用下列標記嵌入模組：

<agent-assist-ui-modules-v2>

UI 模組連接器

與 V1 不同，您必須在 V2 中分別初始化 UI 模組連接器。將連接器與容器分離，可提高整合彈性。如需設定，請參閱「UI 模組連接器」。V1 容器上的許多屬性僅適用於 UI 模組連接器。

本地化

V2 容器支援本地化語言。如要以特定語言載入容器，請在指令碼路徑前加上語言代碼：

日文範例：

<script src="https://www.gstatic.com/agent-assist-ui-modules/ja/v2/container.js"></script>

如未指定語言代碼，容器預設會載入根路徑中的英文 (en)： html <script src="https://www.gstatic.com/agent-assist-ui-modules/v2/container.js"></script>

支援的語言代碼：

• 阿拉伯文 (ar)
• 中文 (簡體) (zh_cn)
• 克羅埃西亞文 (hr)
• 英文 (澳洲) (en_au)
• 英文 (加拿大) (en_ca)
• 英文 (英國) (en_gb)
• 菲律賓文 (fil)
• 法文 (fr)
• 法文 (加拿大) (fr_ca)
• 德文 (de)
• 北印度文 (hi)
• 匈牙利文 (hu)
• 義大利文 (it)
• 日文 (ja)
• 韓文 (ko)
• 馬來文 (ms)
• 挪威文 (no)
• 波蘭文 (pl)
• 葡萄牙文 (巴西) (pt_br)
• 羅馬尼亞文 (ro)
• 俄文 (ru)
• 西班牙文 (es)
• 瑞典文 (sv)
• 泰文 (th)
• 土耳其文 (tr)
• 越南文 (vi)

屬性

屬性是以字串為基礎的元件屬性，可在 HTML 中設定，或使用 JavaScript 中的 setAttribute() 設定。

屬性名稱	類型	註解
功能	字串	以逗號分隔的 Agent Assist 建議功能鍵清單，用於算繪。支援的清單：AGENT_COACHING、CONVERSATION_SUMMARIZATION、SMART_REPLY、KNOWLEDGE_SEARCH、PROACTIVE_GENERATIVE_KNOWLEDGE_ASSIST。如果 use-configured-features 設為 true，系統會忽略這項設定。
use-configured-features	BooleanString	是否要動態載入在對話設定檔中設定的建議功能，而不是以硬式編碼方式將其寫入 features。預設值為 "false"。
disabled-features	字串	以逗號分隔的建議功能清單，用於在 use-configured-features 為 "true" 時排除建議功能。範例："SMART_REPLY,CONVERSATION_SUMMARIZATION"。
session-id	字串	(選填) 非對話式用途的工作階段 ID，例如 Generative knowledge assist。
show-header	BooleanString	是否顯示 Agent Assist 品牌標題。預設值為 "false"。
show-dark-mode-toggle	BooleanString	是否顯示深色模式與淺色模式的切換鈕。預設值為 "true"。
命名空間	字串	選填的命名空間限制。如果要在單一頁面上實作多個 UI 模組例項，才需要這個屬性。
handoff-summarization-enabled	BooleanString	是否在初始化現有對話時，自動觸發對話摘要功能。預設值為 "false"。

輸入內容

輸入內容是 JavaScript 物件或其他複雜的屬性類型，必須直接在元素例項上指派：

const el = document.querySelector('agent-assist-ui-modules-v2');
el.propertyName = value;

屬性名稱	類型	註解
knowledgeAssistCardConfig	KnowledgeAssistV2Config	生成式知識輔助資訊卡的可選設定，包括複製/貼上答案，以及自訂文章連結目標。

類型

如要瞭解元件使用的自訂型別，請參閱下節。

BooleanString

"true" | "false"

KnowledgeAssistV2Config

interface KnowledgeAssistV2Config {
  /** Configuration for how suggested article links are opened. */
  articleLinkConfig?: {
    /** Whether to open the article in a new tab or in a popup window. Defaults to 'blank' (new tab). */
    target?: "blank" | "popup";
    /** Options to configure the popup's size and location. */
    popupWindowOptions?: string;
    /** The field name on the document metadata if a separate article link source is provided. */
    linkMetadataKey?: string;
  };
  /** Whether to show the Copy Answer button on suggestions. */
  showCopyAnswer: boolean;
  /** Whether to show the Paste Answer button on suggestions. */
  showPasteAnswer: boolean;
}