容器 V2

容器 V2 相较于初始容器有了显著改进，并且将继续提供最新功能和变更。为确保客服人员始终可以获得最具影响力的建议和关键工具，版本 2 采用响应式显示，其中包含动态面板和统一的建议 Feed。

用法

使用以下代码在 HTML 页面中导入模块：

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

使用以下标记嵌入模块：

<agent-assist-ui-modules-v2>

界面模块连接器

与 V1 不同，您必须在 V2 中单独初始化界面模块连接器。将连接器与容器分离可提高集成灵活性。如需了解设置，请参阅 UI 模块连接器。V1 容器上的许多属性仅适用于界面模块连接器。

本地化

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。
show-header	BooleanString	是否显示 Agent Assist 品牌标头。默认值为 "false"。
show-dark-mode-toggle	BooleanString	是否显示深色模式与浅色模式之间的切换开关。默认值为 "true"。
命名空间	字符串	可选的命名空间限制。仅当在单个网页上实现多个界面模块实例时才需要。
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;
}