知识辅助

本页包含生成式知识辅助界面模块(也称为知识辅助 V2)的 API 文档。客服人员使用此模块查询公司知识库,并接收由生成式 AI 生成的回答。

用法

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

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

使用以下代码嵌入模块:

<agent-assist-knowledge-assist-v2>

属性

属性名称 类型 评论
session-id 字符串 用于非对话式使用情形的可选会话 ID。
父级 字符串 用于非对话式使用情形的父级项目位置名称。示例:“projects/foo/locations/global”

用法

属性是基于字符串的组件属性,可通过以下方式设置:

直接在 HTML 模板中:

<element-selector property-name="value">

在 JavaScript 代码中:

var el = document.querySelector('element-selector');
el.setAttribute('property-name', 'value');

输入

属性名称 类型 评论
config KnowledgeAssistV2Config Knowledge Assist V2 模块的可选配置。

用法

输入通常是 JavaScript 对象或其他复杂的属性类型,必须直接在元素实例上进行分配:

const el = document.querySelector('element-selector');
el.propertyName = value;

类型

如需了解该组件使用的自定义类型,请参阅下一部分。

KnowledgeAssistV2Config

interface KnowledgeAssistV2Config {
  articleLinkConfig: {
    /**
     * Whether to open the article in a new tab, or as a popup. Defaults to new
     * tab.
     */
    target?: "blank" | "popup";
    /**
     * Options to configure the popup's size and location. See
     * https://developer.mozilla.org/en-US/docs/Web/API/Window/open#window_features.
     */
    popupWindowOptions?: string;
    /**
     * The field name on the document metadata if a separate article link source
     * is provided.
     */
    linkMetadataKey?: string;
  };
  showCopyAnswer: boolean;
  showPasteAnswer: boolean;
}