代理具有许多会影响行为的设置。每种控制台都提供不同的设置。
Conversational Agents 控制台代理设置
要访问代理设置,请执行以下操作:
控制台
- 打开对话代理控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 点击右上角的这些设置图标。
- 根据需要更新设置。
- 点击保存。
API
请参阅 Agent
类型的 get
和 patch/update
方法。
为代理参考选择协议和版本:
协议 | V3 | V3beta1 |
---|---|---|
REST | 代理资源 | 代理资源 |
RPC | 代理界面 | 代理界面 |
C++ | AgentsClient | 不可用 |
C# | AgentsClient | 不可用 |
Go | AgentsClient | 不可用 |
Java | AgentsClient | AgentsClient |
Node.js | AgentsClient | AgentsClient |
PHP | 不可用 | 不可用 |
Python | AgentsClient | AgentsClient |
Ruby | 不可用 | 不可用 |
以下各小节介绍了代理设置的不同类别。
基本设置
以下通用设置可用于代理:
-
代理的用户可读名称。
-
代理的默认时区。
-
此设置决定了代理是使用生成式 playbook 还是确定性流程来开始对话。
-
您在创建代理时选择的代理区域。
-
锁定代理
指示代理是否已锁定。 无法修改已锁定的代理。
-
启用 Cloud Logging
指示是否为代理启用 Cloud Logging。
启用对话历史记录
指示您是否希望 Google 收集和存储已隐去的最终用户查询,以提高质量。
启用基于意见征求的最终用户输入内容编辑功能
如果启用此设置,您可以使用特殊的会话参数来控制是否从对话历史记录和 Cloud Logging 中隐去最终用户输入和参数。默认情况下,会话参数为
true
。如果停用此设置,系统不会进行任何遮盖处理。用户同意情况通过布尔会话参数
$session.params.conversation-redaction
收集。如果此设置处于启用状态,且会话参数设置为false
,则不会进行任何编辑(其他编辑策略仍会应用)。如果启用此设置,并且会话参数设置为true
,则会发生遮盖。一个同意声明请求流程示例可以是:首先询问用户是否愿意保留最终用户输入,然后将回答与两个意图匹配,一个是“同意意图”,另一个是“拒绝意图”。然后,在fulfillment 中“yes intent”路由的参数预设中,将会话参数设置为
false
(不进行数据处理),在“no intent”路由的参数预设中,将会话参数设置为true
(进行数据处理)。
-
启用 BigQuery Export
表示是否已启用 BigQuery 导出。
BigQuery 数据集
BigQuery 数据集名称。
BigQuery 表
BigQuery 表名。
-
您可以启用意图建议。
-
您可以启用此设置,以便就代理的回答质量提供反馈,包括“我喜欢”/“不喜欢”反馈。
-
您可以使用此设置添加 Git 集成。
生成式 AI 设置
您可以使用以下生成式 AI 设置:
常规
-
选择生成式功能使用的模型。 如需了解详情,请参阅模型版本。
令牌限制
-
LLM 的温度可用于控制回答的创意级别。 较低的值可提供更可预测的回答。 值越高,回答的创造性或随机性就越高。
-
该设置会从 LLM 提示中剔除一些过去的对话轮次,以防止提示大小随着代理处理的每个连续对话轮次而不断增大。此功能可用于缓解不必要的提示大小增长。
通常,如果不进行截断,无论后续轮次是否与当前轮次相关,都会附加到 LLM 提示的“对话历史记录”中。这最终会导致提示随着每次对话而越来越大。随着对话历史记录占用更多提示空间,可用于小样本示例的提示空间会减少(因此这些示例可能会被舍弃)。最终,提示可能还会超出当前的令牌限制。您可以增加令牌大小来解决此问题,但请注意,提示大小增加也会增加 LLM 的响应延迟。
通过上下文截断,您可以设置要为对话历史记录预留的 token 预算百分比(上限)。对话轮次会按从近到远的顺序保留。 此设置有助于防止超出令牌限制。 无论您选择哪种设置,系统都会保留至少两次对话轮次,并按从最近到最远的顺序排列。
您必须先设置 token 限制,然后才能修改此设置。
如果被截断的上下文包含某些参数,则这些参数可能会在不知不觉中丢失。启用此选项后,请仔细评估您的剧本互动。
以下功能也会使用令牌输入预算:
- 系统指令和示例:自动添加到提示中。 此行为无法修改。
- Playbook 说明和目标:您撰写的任何说明和目标都将完整地添加到提示中。
- 剧本少样本示例:按顺序(默认)或按您选择的算法(例如正则表达式最佳匹配排序)添加。在包含所有其他项后,示例会被精简以符合输入令牌预算。
- 对话历史记录,由用户和代理的话语、流程和剧本转换上下文、工具调用和输出组成,这些内容来自当前剧本按顺序处理的所有先前回合的同一会话。
-
生成式 AI 禁用的短语列表。 如果提示或生成的回答中出现禁用短语,生成操作将失败。 请注意,被禁短语列表会对每个查询和 LLM 调用产生影响,并会增加延迟时间。
-
配置安全过滤器针对不同 Responsible AI (RAI) 类别的敏感度级别。 我们会根据以下四个类别评估内容:
类别 说明 仇恨言论 针对身份和/或受保护属性的负面或有害评论。 危险内容 宣传或允许访问有害商品、服务和/或活动 露骨色情内容 包含对性行为和/或其他淫秽内容的引用 骚扰内容 针对其他人的恶意、恐吓、欺凌和/或辱骂性评论 根据内容有害的概率来屏蔽内容。您可以为每个类别选择屏蔽少部分、屏蔽一部分和屏蔽大部分,从而自定义敏感程度。您还可以获得对不屏蔽受限选项的访问权限,在为项目提交风险确认请求并获得批准后,该选项会针对相应类别停用 RAI 检查。
如需了解详情,请参阅配置安全属性。
-
您可以勾选启用提示安全检查设置,以启用提示安全检查。 启用后,代理会尝试阻止提示注入攻击。 这些攻击可能会用于泄露部分代理提示,或提供代理不应提供的回答。 为此,系统会发送一个额外的 LLM 提示,以检查用户查询是否可能具有恶意性。
生成式后备
-
请参阅生成式回退:定义自己的提示。
-
-
数据存储区
请参阅数据存储区代理设置。
确定性对话流
这些设置适用于相应代理中的所有流,但机器学习设置除外,后者是按流应用的。如需修改其他特定于流程的设置,请在控制台中找到相应流程,然后在其中修改设置。
意图训练
Flows 使用机器学习 (ML) 算法来了解最终用户输入、将这些输入与意图相匹配,以及提取结构化数据。 流程会根据您提供的训练语句和内置在流程中的语言模型进行学习。它会根据这些数据构建一个模型,用于决定应将哪个意图与最终用户输入匹配。 您可以为代理的每个流应用独有的机器学习设置。
以下意图训练设置可用:
-
如果此功能已启用并且用户输入中含有拼写或语法错误,则系统将按照正确写入的方式匹配意图。检测意图响应将包含更正后的最终用户输入。例如,如果最终用户输入“I want a applle”,则系统将按照最终用户输入“I want an apple”那样执行处理。这也适用于涉及系统和自定义实体的匹配项。
拼写更正功能支持英语、法语、德语、西班牙语和意大利语。它在所有 Conversational Agents (Dialogflow CX) 区域中均可用。
警告和最佳做法:
- 拼写更正无法更正 ASR(自动语音识别)错误,因此我们不建议为使用 ASR 输入的代理启用该功能。
- 更正后的输入可能匹配错误的意图。您可以通过将常见的误匹配短语添加到反例来解决此问题。
- 拼写更正会略微增加代理的响应时间。
- 如果某个代理使用了行业术语来定义,则可能并不希望采用更正。
特定于流的机器学习设置
-
这可以是以下类型之一:
- 高级 NLU(默认):高级 NLU 技术。这一 NLU 类型的性能高于标准,尤其是对于大型代理和流。
- 标准 NLU:标准 NLU 技术。将不再接收质量改进或新功能。
-
如果启用,则流会在使用控制台进行更新时进行训练。对于大型流,这可能会导致控制台界面延迟,因此您应该停用此设置,然后根据需要手动训练大型流。
-
为了过滤掉假正例结果,同时仍然保证可与代理相匹配的自然语言输入的多样性,您可以调整机器学习分类阈值。此设置用于控制意图匹配所需的最小意图检测置信度。
如果意图匹配的置信度分数小于阈值,则会调用无匹配事件。
您可以为代理中启用的每种语言的每个流设置单独的分类阈值。这是为了适应在不同分类阈值下表现最佳的不同语言。如需详细了解如何创建多语言代理,请参阅多语言代理文档。
-
指示自流数据的最新更新以来,流是否经过训练。
-
使用此按钮手动训练流。
-
-
代理支持的语言。 代理创建后,其默认语言便无法更改。不过,您可以执行以下操作:
- 将代理导出为 JSON 格式。
- 解压缩下载的文件。
- 找到
agent.json
文件。 - 将
defaultLanguageCode
和supportedLanguageCodes
字段更新为所需的值。 - 将代理恢复为与第 1 步中相同的代理,或恢复为不同的代理。
- 根据需要更新特定语言的训练短语和实体值。
您还可以启用语言自动检测和切换功能。
-
连接
-
在本部分中,您可以为自定义载荷模板创建说明和载荷。
-
明确说明哪些会话参数将从会话参数发送到 webhook,以及 webhook 的响应可以设置哪些会话参数。
-
用于上传 SSL 证书。
语音和 IVR
语音选项
-
-
您可以选择用于语音合成的语言和声音。
您可以从语音选择下拉框中选择自定义语音选项,并在相应字段中指定自定义语音名称,从而为代理启用自定义语音。自定义语音名称必须遵循以下格式:
projects/PROJECT_ID/locations/LOCATION/models/MODEL_NAME
。您还可以使用声音克隆。
- 如果您使用的是电话网关,请确保在自定义语音项目中,Dialogflow Service Agent 服务账号
service-PROJECT_NUMBER@gcp-sa-dialogflow.iam.gserviceaccount.com
已被授予“AutoML Predictor”角色。 - 对于常规 API 调用,请确保用于调用对话式代理 (Dialogflow CX) 的服务账号在自定义语音项目中被授予“AutoML Predictor”角色。
- 如果您使用的是电话网关,请确保在自定义语音项目中,Dialogflow Service Agent 服务账号
-
控制语音音调的相对高低。
-
控制语音的语速。
-
您可以使用这些设置,通过 X-SAMPA 语音编码为代理提供特定短语的发音。
-
-
-
请参阅自动语音自适应。
-
如需详细了解高级语音选项,请参阅高级语音设置指南。
-
如需了解详情,请参阅用于电话集成的 DTMF。
-
请参阅手动语音自适应。
-
-
Call Companion
请参阅通话助手。
界面设置
您可以使用这些设置自定义 Messenger 和通话助手界面。
安全
Dialogflow CX 控制台代理设置
要访问代理设置,请执行以下操作:
控制台
- 打开控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 点击代理设置。
- 根据需要更新设置。
- 点击保存。
API
请参阅 Agent
类型的 get
和 patch/update
方法。
为代理参考选择协议和版本:
协议 | V3 | V3beta1 |
---|---|---|
REST | 代理资源 | 代理资源 |
RPC | 代理界面 | 代理界面 |
C++ | AgentsClient | 不可用 |
C# | AgentsClient | 不可用 |
Go | AgentsClient | 不可用 |
Java | AgentsClient | AgentsClient |
Node.js | AgentsClient | AgentsClient |
PHP | 不可用 | 不可用 |
Python | AgentsClient | AgentsClient |
Ruby | 不可用 | 不可用 |
常规设置
以下通用设置可用于代理:
显示名
代理的用户可读名称。
时区
代理的默认时区。
默认语言
代理支持的默认语言。 代理创建后,其默认语言便无法更改。不过,您可以执行以下操作:
客服人员锁定
锁定代理
指示代理是否已锁定。 无法修改已锁定的代理。
日志记录设置
启用 Cloud Logging
指示是否为代理启用 Cloud Logging。
启用互动日志记录
指示您是否希望 Google 收集和存储已隐去的最终用户查询,以提高质量。
启用基于意见征求的最终用户输入内容编辑功能
如果启用此设置,您可以使用特殊的会话参数来控制是否从对话历史记录和 Cloud Logging 中隐去最终用户输入内容和参数,默认情况下,会话参数为
true
。如果停用此设置,系统不会进行任何遮盖处理。用户同意情况通过布尔会话参数
$session.params.conversation-redaction
收集。如果此设置处于启用状态,且会话参数设置为false
,则不会进行任何编辑(其他编辑策略仍会应用)。如果启用此设置,并且会话参数设置为true
,则会发生遮盖。一个同意声明请求流程的示例可以是:首先询问用户是否愿意保留最终用户输入,然后将回答与两个意图匹配,一个是“同意意图”,另一个是“拒绝意图”。然后,在fulfillment 中“yes 意图”路由的参数预设中,将会话参数设置为
false
(不进行数据处理),在“no 意图”路由的参数预设中,将会话参数设置为true
(进行数据处理)。
BigQuery Export
启用 BigQuery Export
表示是否已启用 BigQuery 导出。
BigQuery 数据集
BigQuery 数据集名称。
BigQuery 表
BigQuery 表名。
意图建议
您可以启用意图建议。
自定义载荷模板
在本部分中,您可以为自定义载荷模板创建说明和载荷。
机器学习设置
Conversational Agents (Dialogflow CX) 使用机器学习 (ML) 算法来了解最终用户输入、将这些输入与意图相匹配,以及提取结构化数据。 Conversational Agents (Dialogflow CX) 会从您提供的训练语句和内置在 Conversational Agents (Dialogflow CX) 中的语言模型进行学习。它会根据这些数据构建一个模型,用于决定应将哪个意图与最终用户输入匹配。 您可以为代理的每个流应用独有的机器学习设置,并且 Conversational Agents (Dialogflow CX) 创建的模型在每个流中都是唯一的。
您可以使用以下代理范围的机器学习设置:
允许机器学习更正拼写 (Allow ML to correct spelling)
如果此功能已启用并且用户输入中含有拼写或语法错误,则系统将按照正确写入的方式匹配意图。检测意图响应将包含更正后的最终用户输入。例如,如果最终用户输入“I want a applle”,则系统将按照最终用户输入“I want an apple”那样执行处理。这也适用于涉及系统和自定义实体的匹配项。
拼写更正功能支持英语、法语、德语、西班牙语和意大利语。它在所有 Conversational Agents (Dialogflow CX) 区域中均可用。
警告和最佳做法:
- 拼写更正无法更正 ASR(自动语音识别)错误,因此我们不建议为使用 ASR 输入的代理启用该功能。
- 更正后的输入可能匹配错误的意图。您可以通过将常见的误匹配短语添加到反例来解决此问题。
- 拼写更正会略微增加代理的响应时间。
- 如果某个代理使用了行业术语来定义,则可能并不希望采用更正。
您可以使用以下特定于流的机器学习设置:
NLU 类型
这可以是以下类型之一:
- 高级 NLU(默认):高级 NLU 技术。这一 NLU 类型的性能高于标准,尤其是对于大型代理和流。
- 标准 NLU:标准 NLU 技术。将不再接收质量改进或新功能。
自动训练
如果启用,则流会在使用控制台进行更新时进行训练。对于大型流,这可能会导致控制台界面延迟,因此您应该停用此设置,然后根据需要手动训练大型流。
分类阈值
为了过滤掉假正例结果,同时仍然保证可与代理相匹配的自然语言输入的多样性,您可以调整机器学习分类阈值。此设置用于控制意图匹配所需的最小意图检测置信度。
如果意图匹配的置信度分数小于阈值,则会调用无匹配事件。
您可以为代理中启用的每种语言的每个流设置单独的分类阈值。这是为了适应在不同分类阈值下表现最佳的不同语言。如需详细了解如何创建多语言代理,请参阅多语言代理文档。
训练状态
指示自流数据的最新更新以来,流是否经过训练。
训练 NLU
使用此按钮手动训练流。
生成式 AI 设置
您可以使用以下生成式 AI 设置:
常规
禁用短语
生成式 AI 禁用的短语列表。 如果提示或生成的回答中包含禁用短语,则生成会失败。
安全过滤器
配置安全过滤器针对不同 Responsible AI (RAI) 类别的敏感度。我们会根据以下四个类别评估内容:
类别 说明 仇恨言论 针对身份和/或受保护属性的负面或有害评论。 危险内容 宣传或允许访问有害商品、服务和活动 露骨色情内容 包含对性行为或其他淫秽内容的引用 骚扰内容 针对其他人的恶意、恐吓、欺凌或辱骂性评论 根据内容有害的概率来屏蔽内容。您可以为每个类别选择屏蔽少部分、屏蔽一部分和屏蔽大部分,从而自定义敏感程度。您还可以获得对不屏蔽受限选项的访问权限,在为项目提交风险确认请求并获得批准后,该选项会针对相应类别停用 RAI 检查。
如需了解详情,请参阅配置安全属性。
提示安全
您可以勾选启用提示安全检查设置,以启用提示安全检查。 启用后,代理会尝试阻止提示注入攻击。 这些攻击可能会用于泄露部分代理提示,或提供代理不应提供的回答。 为此,系统会发送一个额外的 LLM 提示,以检查用户查询是否可能具有恶意性。
生成式客服
生成模型选择
选择生成式功能使用的模型。 如需了解详情,请参阅模型版本。
截断 playbook 上下文
剧本上下文截断会从剧本提示中删除一些过去的对话轮次,以防止提示大小随着剧本处理的每个连续对话轮次而不断增大。此功能可用于缓解不必要的提示大小增长。
通常,如果不进行截断,无论后续轮次是否与当前轮次相关,都会附加到 LLM 提示的“对话历史记录”中。这最终会导致提示在每次对话轮次中不断增大。随着对话历史记录占据的提示空间越来越多,可用于小样本示例的提示空间越来越少(因此这些示例可能会被舍弃)。最终,提示可能还会超出当前的令牌限制。您可以增加令牌大小来解决此问题,但请注意,提示大小增加也会增加 LLM 的响应延迟。
通过剧本上下文截断,您可以设置预留给对话历史记录的 token 预算百分比(上限)。对话轮次会按从近到远的顺序保留。 此设置有助于防止超出令牌限制。 无论您选择哪种设置,系统都会保留至少两次对话轮次,并按从最近到最远的顺序排列。
您必须先设置令牌限制,然后才能修改此设置。
重要提示:如果某些参数属于被剔除的对话轮次,截断上下文可能会导致这些参数意外丢失。启用此选项后,请仔细评估您的剧本互动。
以下功能也会使用令牌输入预算:
- 系统指令和示例:自动添加到提示中。 此行为无法修改。
- Playbook 说明和目标:您撰写的任何说明和目标都将完整地添加到提示中。
- 剧本少样本示例:按顺序(默认)或按您选择的算法(例如正则表达式最佳匹配排序)添加。在包含所有其他项后,示例会被精简以符合输入令牌预算。
- 对话历史记录,由用户和代理的话语、流程和剧本转换上下文、工具调用和输出组成,这些内容来自当前剧本按顺序处理的所有先前回合的同一会话。
生成式后备
文本提示配置
请参阅生成式回退:定义自己的提示。
数据存储区
请参阅数据存储区代理设置。
语音和 IVR 设置
以下语音和 IVR 设置可用:
Text-to-Speech
语音选择
您可以选择用于语音合成的语言和声音。
您可以从语音选择下拉框中选择自定义语音选项,并在相应字段中指定自定义语音名称,从而为代理启用自定义语音。自定义语音名称必须遵循以下格式:
projects/PROJECT_ID/locations/LOCATION/models/MODEL_NAME
。- 如果您使用的是电话网关,请确保在自定义语音项目中,Dialogflow Service Agent 服务账号
service-PROJECT_NUMBER@gcp-sa-dialogflow.iam.gserviceaccount.com
已被授予“AutoML Predictor”角色。 - 对于常规 API 调用,请确保用于调用对话式代理 (Dialogflow CX) 的服务账号在自定义语音项目中被授予“AutoML Predictor”角色。
- 如果您使用的是电话网关,请确保在自定义语音项目中,Dialogflow Service Agent 服务账号
Speech-to-Text
DTMF
如需了解详情,请参阅用于电话集成的 DTMF。
多模态
请参阅通话助手。
共享设置
请参阅访问权限控制。
语言设置
向代理添加其他语言支持。如需完整的语言列表,请参阅语言参考。
自动检测语言
配置语言自动检测后,聊天机器人会检测最终用户的语言并自动切换到该语言。如需了解详情,请参阅语言自动检测文档。
安全设置
请参阅安全设置。
高级设置
目前,唯一的高级设置适用于情感分析。
AI Applications 控制台设置
本部分介绍了代理应用可用的设置。
常规
以下通用设置可用于代理应用:
显示名
代理应用的人类可读名称。
位置
代理应用区域。
应用锁定
如果启用,则不允许更改代理应用。
日志记录
以下日志记录设置适用于代理应用:
启用 Cloud Logging
如果启用,日志将发送到 Cloud Logging。
启用对话历史记录
如果启用,系统会提供对话记录。 指示您是否希望 Google 收集和存储已隐去的最终用户查询,以提高质量。 此设置不会影响是否使用对话记录来生成代理回答。
启用 BigQuery Export
如果启用此设置,系统会将对话记录导出到 BigQuery。 还必须启用启用对话历史记录设置。
生成式 AI
以下生成式 AI 设置可用于代理应用:
生成模型选择
选择代理应默认使用的生成式模型。
输入 token 限制
为生成式模型选择输入令牌限制。 这是发送给模型的输入的最大 token 大小。 根据模型,token 可以介于一个字符和一个字词之间。 较小的令牌限制具有较低的延迟时间,但模型输入大小有限。 令牌限制越大,延迟时间越长,但模型输入大小可以更大。
输出 token 限制
为生成式模型选择输出令牌限制。 这是从模型收到的输出的词法单元大小上限。 根据模型,token 可以介于一个字符和一个字词之间。 较小的令牌限制可缩短延迟时间,但会限制模型输出大小。 令牌限制越大,延迟时间越长,但模型输出大小可以更大。
温度
LLM 的温度可用于控制回答的创意级别。 较低的值可提供更可预测的回答。 值越高,回答的创造性或随机性就越高。
禁用短语
生成式 AI 禁用的短语列表。 如果提示或生成的回答中包含禁用短语,代理将改为返回后备回答。
安全过滤器
配置安全过滤器针对不同 Responsible AI (RAI) 类别的敏感度。我们会根据以下四个类别评估内容:
类别 说明 仇恨言论 针对身份和/或受保护属性的负面或有害评论。 危险内容 宣传或允许访问有害商品、服务和活动 露骨色情内容 包含对性行为或其他淫秽内容的引用 骚扰内容 针对其他人的恶意、恐吓、欺凌或辱骂性评论 根据内容有害的概率来屏蔽内容。您可以为每个类别选择屏蔽少部分(仅屏蔽有害内容概率较高的内容)、屏蔽部分(屏蔽有害内容概率中等和较高的内容)和屏蔽大部分(屏蔽有害内容概率较低、中等和较高的内容)来定制敏感度级别。您还可以获得对不屏蔽受限选项的访问权限,在为项目提交风险确认请求并获得批准后,该选项会针对相应类别停用 RAI 检查。
如需了解详情,请参阅配置安全属性。
提示安全
您可以勾选启用提示安全检查设置,以启用提示安全检查。 启用后,代理将尝试阻止提示注入攻击。 这些攻击可能会用于泄露部分代理提示,或提供代理不应提供的回答。 为此,系统会发送一个额外的 LLM 提示,以检查用户查询是否可能具有恶意性。
Git
这些设置提供 Git 集成。 按照说明配置集成。