容器 V2

第 2 版容器比初始容器有大幅改善，為確保代理人隨時都能取得最有影響力的建議和重要工具，第 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 模組連接器。

在地化

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

日文範例：

<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，例如生成式知識輔助。
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;
}