数据存储区代理

注意 ：数据存储区代理不在 Dialogflow 服务等级协议 (SLA) 范围内。

数据存储区代理是一种特殊类型的 Dialogflow 代理，可以根据您的网站内容和上传的数据提供 LLM 生成的代理响应。

如需创建此代理，请在创建代理时提供数据存储区。

数据存储区代理具有称为“数据存储区处理程序”的特殊状态处理程序。使用这些数据存储区处理程序，您的数据存储区代理可以与最终用户就内容展开对话。

限制

存在以下限制：

• 此功能目前在 Google Analytics（分析）中仅支持部分语言。请参阅语言参考文档中的数据存储区列。
• 仅支持以下区域：global、us 多区域和 eu 多区域。

访问权限控制

如果您是项目所有者，则拥有创建数据存储区代理所需的所有权限。如果您不是项目所有者，则必须拥有以下角色：

• Dialogflow 管理员
• Discovery Engine Admin

如需了解详情，请参阅 Dialogflow 访问权限控制指南。

创建数据存储区代理

如需创建数据存储区代理，请执行以下操作：

1. 如果您尚未按照 Dialogflow setup中的说明操作，请先完成这些操作。

2. 在 Google Cloud 控制台中，前往搜索和对话页面。

   Search and Conversation

3. 从控制台下拉菜单中选择您的项目。

4. 如果您尚未激活该 API，请阅读并同意服务条款，然后点击继续并激活该 API。

5. 点击 Create a New App 或 New App。

6. 选择聊天。

7. 在代理配置部分中提供您的公司名称。

8. 展开“时区和语言设置”部分。

9. 选择时区。

10. 选择默认语言。

11. 在您的代理名称部分中提供代理名称。

12. 在代理的位置部分中，选择一个单区域或多区域。

13. 点击继续。

14. 通过执行以下任一操作，将数据存储区连接到您的代理：

    • 选择之前创建的现有数据存储区。
    • 创建新的数据存储区：
      1. 点击创建新的数据存储区。
      2. 选择数据源。
      3. 为您选择的数据存储区来源提供数据和配置。 您的数据存储区位置应与代理位置相对应。
      4. 点击创建以创建数据存储区。
      5. 选择新的数据存储区。

15. 点击创建。

16. 您的代理现已创建完毕，并且系统会自动将您重定向到可用的数据存储区页面，您可以在该页面根据需要添加更多数据存储区。

17. 如果您为网站创建了新的数据存储区，则必须验证您的网域。

18. 如需使用 Dialogflow CX 打开代理，请点击左侧面板中的预览。在 Dialogflow CX 控制台中，您可以修改或添加数据存储区处理程序、部署代理，以及（可选）添加可处理数据存储区未涵盖的场景的流。

测试代理

注意 ：新的数据存储区 Web 内容最多可能需要 4 小时才能编入索引并由代理进行正确处理。

您可以使用 Dialogflow CX 模拟器测试代理。

改进代理的生成式响应

如果您在测试期间发现某些响应不符合您的预期，请尝试以下操作。

您可以通过添加特定问题的 FAQ 条目来覆盖答案。

您可以在 Dialogflow 控制台中进一步自定义您的代理。 如需导航到控制台，请在控制台提供的代理列表中点击代理的名称。然后，打开 Dialogflow 代理设置页面并导航到机器学习标签页，然后转到生成式 AI 子标签页。可用的自定义选项如下：

依据信心

对于由关联的数据存储区的内容生成的每个响应，我们都会评估一个置信度，该置信度用于衡量响应中的所有信息是否都有数据存储区中的信息支持。您可以通过选择您可以接受的最低置信度来自定义允许的回应类型。如果返回结果的置信度完全低于该级别，则系统不会显示该响应。

有 5 个置信度可供选择：极低、低、中、高和非常高。

数据存储区提示

您可以选择添加有关代理的更多信息，这些信息可以提高数据存储区内容生成的回答的质量，并使其更接近您的品牌：

• 代理名称 - 代理应该用自己的名称命名。如果您不设置它，将使用默认值 AI Assistant。
• 代理身份 - 代理角色是什么。如果您不设置它，将使用默认值 AI Assistant。
• 公司名称应设置为贵公司的名称。这项设置应该已在代理创建流程中进行设置，但可以根据需要调整。建议正确设置此字段（尤其是不要将其留空），以免影响生成的答案的质量。
• Company description（公司说明）是对公司业务或提供的服务的简短说明。
• 代理范围 - 要使用的代理的位置。如果您不设置此政策，系统将使用公司网站上的默认值。

部分或全部填写完此部分后，您可以在右侧您的提示下查看根据这些设置生成的一小段文字，这些段落将用于生成答案。

禁止的词组

您可以选择定义不允许使用的特定词组。如果生成的响应（或者，用于生成响应的提示中的内容，例如最后一条用户话语）包含一字不差的任何禁止短语，则系统不会显示该响应。

数据存储区模型选择和摘要提示

处理用户查询时，代理会搜索数据存储区以查找合适的来源。然后，代理会将用户查询和找到的信息来源发送给 LLM，然后 LLM 会执行摘要。

您可以选择用于摘要的模型，并且可以选择提供您自己的提示。

选择生成模型

您可以选择数据存储区代理针对摘要生成请求使用的生成模型。如果未选择任何项，将使用 text-bison@001。 下表列出了可用的选项：

模型标识符	语言支持
text-bison@001	提供所有支持的语言。
text-bison@002	提供所有支持的语言。
微调 text-bison@001（对话）	目前仅支持英语文本。
微调 text-bison@001（信息类）	目前仅支持英语文本。
双子座 - Pro	提供所有支持的语言。

自定义摘要提示

注意 ：提供自定义提示可能会影响正面或负面答案的质量。您应自行负责回答的质量。

您可以自行为摘要 LLM 调用提供提示。 提示是可能包含预定义占位符的文本模板。系统会在运行时将占位符替换为适当的值，并将最终文本发送给 LLM。

占位符如下所示：

• $original-query：用户的查询文本。
• $rewritten-query：Dialogflow 使用重写模块将原始用户查询重写为更准确的格式。

• $sources：Dialogflow 会使用 Enterprise Search 根据用户的查询搜索来源。找到的源代码以特定格式呈现：

  [1] title of first source
  content of first source
  [2] title of second source
  content of first source
  

• $conversation：对话历史记录按以下格式呈现：

  Human: user's first query
  AI: answer to user's first query
  Human: user's second query
  AI: answer to user's second query
  

自定义提示应在 LLM 无法提供答案时指示 LLM 返回“NOT_ENOUGH_INFORMATION”。代理会将此常量转换为便于用户理解的消息。

部署代理

您可以通过多种方式部署代理：

• 最简单的方法是使用 Dialogflow CX 集成，它可以为您的代理提供界面。 每个集成都提供了部署说明。

• Dialogflow Messenger 集成对于数据存储区代理来说是一个特别好的选择。 它具有针对生成式功能的内置选项。

• 您可以创建自己的界面并使用 Dialogflow CX API 进行互动。您的界面实现控制着部署。

跟踪代理的性能

您可以监控您的代理对话记录，并且可以使用分析工具来获取代理统计信息。

特殊 intent

除了处理与您提供的内容相关的问题，数据存储区代理还可以处理以下类型的问题：

• 代理识别：可以处理“你是谁？”或“你是人类吗？”等问题。
• 上报给人工客服：可以处理“我想咨询人工客服”或“我想咨询人工客服”等问题。

这是通过自动生成的意图和意图路由来实现的。

混合代理

如果您已有 Dialogflow CX 代理，则可以将此代理升级为混合代理，该代理将精确对话控件（流、参数、意图、条件、转换等）与数据存储区处理程序生成功能的强大功能相结合。

在此次升级过程中，您可能希望针对代理的某些对话场景删除或暂时停用意图路由（同时测试数据存储区处理程序），因为数据存储区处理程序可以更轻松地处理这些场景。

建议针对数据存储区处理程序采用以下场景：

• 可通过贵组织的文件或网站回答的问题。
• 不需要数据库查询的常见问题解答。

对于数据存储区处理程序，不建议出现以下情况：

• 未对所需问题做出回答的内容。
• 需要查询数据库或服务器请求的问题。
• 需要隐去数据的场景。
• 需要确定代理响应的场景。

Dialogflow 按以下优先顺序评估最终用户输入：

1. 范围内的路由的 intent 匹配
2. 数据存储区内容常见问题解答
3. 非结构化数据存储区内容

输入评估顺序

Dialogflow 按以下顺序评估混合代理的最终用户输入：

1. 表单填充时的参数输入。
2. 范围内的路由的 intent 匹配。
3. 包含 FAQ 数据存储区内容的数据存储区处理程序。
4. 包含非结构化数据存储区内容的数据存储区处理程序。

为现有代理添加或修改数据存储区处理程序

数据存储区处理程序是一种特殊类型的 Dialogflow 状态处理程序。这意味着您可以将它们应用于流或页面，并且使用相同的范围规则对其进行评估。

如需添加或修改数据存储区处理程序，请执行以下操作：

1. 转到 Dialogflow CX 控制台。
2. 选择您的 Google Cloud 项目。
3. 选择代理。
4. 选择与数据存储区处理程序关联的数据流。这通常是默认启动流程。
5. 选择与数据存储区处理程序关联的页面。 这通常是初始页。
6. 点击页面数据中的添加状态处理程序，然后选择数据存储区。
7. 如果您需要创建数据存储区，系统会将您转到 Vertex AI Search and Conversation 界面。请参阅数据存储区信息以帮助您进行选择。
8. 如果您已有数据存储区，请点击修改数据存储区。
9. 根据需要进行更新，并在完成后保存。 请参阅下文，了解特定于数据存储区的设置。

代理响应

在代理响应部分，您可以提供引用生成式答案的自定义响应。使用代理说部分中的 $request.knowledge.questions[0] 来提供生成式答案。

数据存储区响应选项

您可以更新链接数上限字段，以指明生成式答案应提供的补充链接的数量上限。

处理对话离题

最终用户可能会在对话期间询问澄清性问题。 例如，在收集信用卡信息的过程中，他们可能希望阐明什么是 CVV。在这种情况下，您的代理应该回答问题并返回收集必要的信用卡信息。为此，您可以创建一个数据存储区处理程序，其中包含可以回答该问题的数据存储区，将该处理程序应用于处理信用卡信息收集流程的流程初始页，并为此处理程序设置返回到“当前页面”的过渡目标。

处理不必要的意图匹配

如果您的代理应该使用数据存储区处理程序，却匹配意图，您可以尝试以下解决方法：

• 删除或修改模糊的训练短语，以确保所有训练短语精确地处理所需的意图，并且不会与数据存储区内容冲突。
• 使用反例以避免意图匹配。

数据存储区过滤

在某些情况下，您可能只想使用特定数据存储区进行查询，具体取决于会话参数值。例如，您可以为商品类别创建唯一的数据存储区。要针对商品类别完成数据存储区过滤，请执行以下操作：

• 将会话参数设置为商品类别。
• 创建条件路由，用于检查会话参数的值并转换到具有所需数据存储区处理程序的特定页面。
• 数据存储区处理程序应转换回调用页面，以便对话可以继续。

个性化

要使生成式回答更贴合最终用户的需求，您可以向 Dialogflow 提供用户相关信息。

此信息以 JSON 格式提供。 没有预期的架构，因此您可以随意定义对象属性。 该 JSON 会按原样发送到大语言模型，因此描述性属性名称和值可以获得最佳结果。

例如：

{
  "subscription plan": "Business Premium Plus",
  "devices owned": [
    {"model": "Google Pixel 7"},
    {"model": "Google Pixel Tablet"}
  ]
}

使用 Dialogflow API 进行个性化设置

您可以在发送检测意图请求时向 Dialogflow 提供此数据。此信息必须在每个检测意图请求中提供，因为它不会保留在会话中。

请在 Sessions.detectIntent 方法的 queryParams.endUserMetadata 字段中提供此信息。

转到 Session API 参考文档

选择会话引用的协议和版本：

协议	V3	V3beta1
REST	会话资源	会话资源
RPC	会话接口	会话接口
C++	SessionsClient	不可用
C#	SessionsClient	不可用
Go	SessionsClient	不可用
Java	SessionsClient	SessionsClient
Node.js	SessionsClient	SessionsClient
PHP	不可用	不可用
Python	SessionsClient	SessionsClient
Ruby	不可用	不可用

关闭

使用 Dialogflow Messenger 进行个性化设置

您可以将此数据提供给 Dialogflow Messenger 集成。请参阅 setContext 方法。

搜索配置

为了更好地控制代理行为并改善答案质量，我们提供增强和过滤搜索配置，可让您提升、掩埋和过滤文档。

借助提升控件，您可以通过对特定文档应用提升值（大于零表示排名较高，小于零表示排名较低）来更改搜索结果排名。

借助过滤器控件，您可以根据指定的过滤条件保留或移除搜索结果。

此信息以 JSON 格式提供给 Dialogflow 请求。 JSON 的格式取决于搜索控件类型。

增强控制

以下搜索配置介绍了增强控制：

"searchConfig": {
  "boostSpecs": [
    {
      "dataStores": [ "DATASTORE_ID" ],
      "spec": [
        {
          "conditionBoostSpecs": {
            "condition": "CONDITION",
            "boost": "1.0"
          }
        }
      ]
    }
  ]
}

注意 ：DATASTORE_ID 是数据存储区的全名：projects/your_project_id/locations/your_location/collections/your_collection_name/dataStores/your_datastore_name，
CONDITION 必须遵循 Vertex AI Search and Conversation 的过滤器表达式语法。
，并且提升值必须介于 -1.0 到 1.0 之间。

过滤器控件

以下搜索配置描述了过滤器控件：

"searchConfig": {
  "filterSpecs": [
    {
      "dataStores": [ "DATASTORE_ID" ],
      "filter": "CONDITION"
    }
  ]
}

注意 ：DATASTORE_ID 是数据存储区的全名：projects/your_project_id/locations/your_location/collections/your_collection_name/dataStores/your_datastore_name，
和 CONDITION 必须遵循 Vertex AI Search and Conversation 的过滤器表达式语法。

使用 Dialogflow API 设置搜索配置

您可以在发送检测意图请求时向 Dialogflow 提供此数据。此信息必须在每个检测意图请求中提供，因为它不会保留在会话中。

请在 Sessions.detectIntent 方法的 queryParams.searchConfig 字段中提供此信息。

转到 Session API 参考文档

选择会话引用的协议和版本：

协议	V3	V3beta1
REST	会话资源	会话资源
RPC	会话接口	会话接口
C++	SessionsClient	不可用
C#	SessionsClient	不可用
Go	SessionsClient	不可用
Java	SessionsClient	SessionsClient
Node.js	SessionsClient	SessionsClient
PHP	不可用	不可用
Python	SessionsClient	SessionsClient
Ruby	不可用	不可用

关闭

使用 Dialogflow Messenger 设置搜索配置

您可以将此数据提供给 Dialogflow Messenger 集成。

如需应用搜索控件，在将以下代码段嵌入网站时，需要将其添加到 DF Messenger 代码中：

<script>
  document.addEventListener('df-messenger-loaded', () => {
    const dfMessenger = document.querySelector('df-messenger');
    const searchConfig = { ... }
    dfMessenger.setQueryParameters(searchConfig);
  });
</script>

请参阅 setQueryParameters 方法。