代理有许多会影响行为的设置。 每个控制台提供不同的设置。
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
,系统会进行隐去处理。意见征求请求流程示例如下:首先询问用户是否想要保留最终用户输入,并将响应与两个意图匹配,一个是“yes intent”,另一个为“no intent”。然后,在 fulfillment 中“yes intent”路由的参数预设中将会话参数设置为
false
(不隐去),并在“no intent”路由的参数预设中将其设置为true
(进行隐去)。
-
启用 BigQuery Export
指示是否已启用 BigQuery 导出。
BigQuery 数据集
BigQuery 数据集名称。
BigQuery 表
BigQuery 表名称。
-
您可以启用 intent 建议。
-
您可以启用此设置,以提供有关代理的答案质量的反馈,包括“顶/踩”。
-
使用此设置可添加 Git 集成。
生成式 AI 设置
您可以使用以下生成式 AI 设置:
常规
-
选择生成特征使用的模型。 如需了解详情,请参阅模型版本。
词元限制
-
通过 LLM 的温度,你可以控制回答的创造性。 值越小,响应的可预测性越高。数值越高,回答的创意或随机性越强。
-
此设置会剔除 LLM 提示中的一些过往回合,以防止提示大小随着代理处理的每一轮连续回合而增加。此功能提供了一种方法来减少不必要的提示大小增长。
通常,在不截断的情况下,后续的每个回合都会附加到 LLM 提示的“对话记录”,无论该回合是否与当前回合相关都是如此。这最终会导致提示大小每次都会变大。随着对话记录占用的提示越来越多,可用于少样本样本的提示就会越来越少(因此这些提示可能会被丢弃)。最终,提示还可能会突破当前的词元限制。您可以增加词元大小来应对这种情况,但请注意,增加的提示大小也会增加 LLM 响应延迟时间。
借助上下文截断功能,您可以设置要为对话历史记录预留的令牌预算百分比(上限)。轮流的对话会按从新到旧的顺序保留。 此设置可帮助您防止超出令牌数量上限。 无论您选择哪种设置,系统都按从新到旧的顺序保留至少两个对话回合。
您必须先设置词元限制,然后才能修改此设置。
如果某些参数是挑选回合的一部分,则截断上下文可能会导致这些参数无意中丢失。启用此选项后,请仔细评估您的 playbook 交互。
令牌输入预算也用于以下人员:
- 系统说明和示例:自动添加到提示中。 此行为无法修改。
- playbook 说明和目标:您编写的所有说明和目标都会完整地添加到提示中。
- playbook 小样本示例:按顺序(默认)或按照您选择的算法(例如正则表达式最佳匹配排序)添加。在包含所有其他项后,系统会过滤样本以符合输入令牌预算。
- 对话记录由用户和代理话语、流程和 playbook 转换上下文、同一会话中的工具调用和输出组成,之前所有回合中的工具调用和输出均按当前 playbook 按顺序处理。
-
禁止在生成式 AI 中使用的词组列表。 如果提示或生成的响应中出现禁止的短语,则生成将失败。请注意,被禁短语列表会对每次查询和 LLM 调用造成影响,并会增加延迟时间。
-
针对不同的 Responsible AI (RAI) 类别,配置安全过滤器的敏感度等级。我们将根据以下四个类别对内容进行评估:
类别 说明 仇恨言论 针对身份和/或受保护属性的负面或有害评论。 危险内容 宣传或允许访问有害的商品、服务和/或活动 露骨色情内容 提及性行为和/或其他淫秽内容 骚扰内容 针对他人的恶意、恐吓、欺凌和/或侮辱性评论 根据内容有害的概率来屏蔽内容。您可以自定义敏感度等级,只需为每个类别选择屏蔽很少、部分屏蔽和屏蔽最多这一项即可。在为项目提交风险确认请求并获得批准后,您还可以使用全部不屏蔽受限选项来停用该类别的 RAI 检查。
如需了解详情,请参阅配置安全属性。
-
您可以勾选启用提示安全检查设置,以启用提示安全检查。启用后,代理将尝试防止提示注入攻击。这些攻击可用于泄露代理提示的部分内容,或提供代理不应提供的响应。其实现方法是发送额外的 LLM 提示,以检查用户查询是否可能是恶意的。
生成式后备
-
请参阅生成式回退:定义您自己的提示。
-
-
数据存储区
请参阅数据存储区代理设置。
确定性流
这些设置将应用于此代理中的所有流,但按流应用的机器学习设置除外。如需修改其他特定于流程的设置,请在控制台中导航到相应流程并在其中修改设置。
意图训练
Flow 使用机器学习 (ML) 算法理解最终用户输入、将输入与意图匹配,以及提取结构化数据。数据流会从您提供的训练短语和内置于数据流中的语言模型中学习。它会根据这些数据构建一个模型,用于决定应将哪个意图与最终用户输入匹配。 您可以为代理的每个流应用唯一的机器学习设置。
您可以使用以下意图训练设置:
-
如果此功能已启用并且用户输入中含有拼写或语法错误,则系统将按照正确写入的方式匹配意图。检测意图响应将包含更正后的最终用户输入。例如,如果最终用户输入“I want a applle”,则系统将按照最终用户输入“I want an apple”那样执行处理。这也适用于涉及系统和自定义实体的匹配项。
拼写更正功能支持英语、法语、德语、西班牙语和意大利语。它在所有对话代理 (Dialogflow CX) 区域中提供。
警告和最佳做法:
- 拼写更正无法更正 ASR(自动语音识别)错误,因此我们不建议为使用 ASR 输入的代理启用该功能。
- 更正后的输入可能匹配错误的意图。您可以通过将常见的误匹配短语添加到反例来解决此问题。
- 拼写更正会略微增加代理的响应时间。
- 如果某个代理使用了行业术语来定义,则可能并不希望采用更正。
特定于流程的机器学习设置
-
这可以是以下类型之一:
- 高级 NLU(默认):高级 NLU 技术。这种 NLU 类型的效果更好,尤其是对于大型代理和流程。
- 标准 NLU:标准 NLU 技术。将不会再收到质量改进或新功能。
-
如果启用,则流会在使用控制台进行更新时进行训练。对于大型流,这可能会导致控制台界面延迟,因此您应该停用此设置,并根据需要手动训练大型流。
-
为了过滤掉假正例结果,同时仍然保证可与代理相匹配的自然语言输入的多样性,您可以调整机器学习分类阈值。此设置用于控制意图匹配所需的最低意图检测置信度。
如果意图匹配的置信度分数小于阈值,则会调用非匹配事件。
您可以为代理启用的每种语言的每个流设置单独的分类阈值。这是为了适应不同语言在不同的分类阈值下效果最佳。如需详细了解如何创建多语言代理,请参阅多语言代理文档。
-
指示自流数据的最新更新以来,流是否经过训练。
-
使用此按钮手动训练流。
-
-
您的代理支持的语言。 创建代理后,便无法更改默认语言。 但是,您可以执行以下操作:
- 以 JSON 格式导出代理。
- 解压缩下载的文件。
- 找到
agent.json
文件。 - 将
defaultLanguageCode
和supportedLanguageCodes
字段更新为所需的值。 - 将该代理恢复到第 1 步中的相同或不同代理。
- 根据需要更新特定于语言的训练短语和实体值。
您还可以启用语言自动检测和切换功能。
-
连接
-
在本部分中,您可以为自定义载荷模板创建说明和载荷。
-
明确说明会话参数中的哪些参数将发送到 webhook,以及该 webhook 的响应可以设置哪些会话参数。
-
用于上传 SSL 证书。
语音和 IVR
语音选项
-
-
您可以选择语音合成所用的语言和语音。
您可以从语音选择 Dropbox 中选择自定义语音选项,并在相应字段中指定自定义语音名称,从而为代理启用自定义语音。自定义语音名称必须遵循以下格式:
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 服务账号
-
-
-
请参阅自动语音自适应。
-
如需详细了解高级语音选项,请参阅高级语音设置指南。
-
如需了解详情,请参阅适用于电话集成的 DTMF 功能。
-
请参阅手动语音自适应。
-
-
通话伴侣
请参阅通话副屏模式。
界面设置
您可以使用这些设置来自定义 Messenger 和 Call Companion 界面。
安全
请参阅安全设置。
Dialogflow CX 控制台代理设置
要访问代理设置,请执行以下操作:
控制台
- 打开 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
,系统会进行隐去处理。意见征求请求流程示例如下:首先询问用户是否想要保留最终用户输入,并将响应与两个意图匹配,一个是“yes intent”,另一个为“no intent”。然后,在 fulfillment 中“yes intent”路由的参数预设中将会话参数设置为
false
(不隐去),并在“no intent”路由的参数预设中将其设置为true
(进行隐去)。
BigQuery Export
启用 BigQuery Export
指示是否已启用 BigQuery 导出。
BigQuery 数据集
BigQuery 数据集名称。
BigQuery 表
BigQuery 表名称。
intent 建议
您可以启用 intent 建议。
自定义载荷模板
在本部分中,您可以为自定义载荷模板创建说明和载荷。
机器学习设置
对话代理 (Dialogflow CX) 使用机器学习 (ML) 算法理解最终用户输入、将其与意图相匹配,以及提取结构化数据。 对话代理 (Dialogflow CX) 会从您提供的训练短语和对话代理 (Dialogflow CX) 中内置的语言模型中进行学习。它会根据这些数据构建一个模型,用于决定应将哪个意图与最终用户输入匹配。 您可以为每个代理流应用唯一的机器学习设置,并且对话代理 (Dialogflow CX) 创建的模型对于每个流都是唯一的。
您可以使用以下代理范围的机器学习设置:
允许机器学习更正拼写 (Allow ML to correct spelling)
如果此功能已启用并且用户输入中含有拼写或语法错误,则系统将按照正确写入的方式匹配意图。检测意图响应将包含更正后的最终用户输入。例如,如果最终用户输入“I want a applle”,则系统将按照最终用户输入“I want an apple”那样执行处理。这也适用于涉及系统和自定义实体的匹配项。
拼写更正功能支持英语、法语、德语、西班牙语和意大利语。它在所有对话代理 (Dialogflow CX) 区域中提供。
警告和最佳做法:
- 拼写更正无法更正 ASR(自动语音识别)错误,因此我们不建议为使用 ASR 输入的代理启用该功能。
- 更正后的输入可能匹配错误的意图。您可以通过将常见的误匹配短语添加到反例来解决此问题。
- 拼写更正会略微增加代理的响应时间。
- 如果某个代理使用了行业术语来定义,则可能并不希望采用更正。
您可以使用以下特定于流的机器学习设置:
NLU 类型
这可以是以下类型之一:
- 高级 NLU(默认):高级 NLU 技术。这种 NLU 类型的效果更好,尤其是对于大型代理和流程。
- 标准 NLU:标准 NLU 技术。将不会再收到质量改进或新功能。
自动训练
如果启用,则流会在使用控制台进行更新时进行训练。对于大型流,这可能会导致控制台界面延迟,因此您应该停用此设置,并根据需要手动训练大型流。
分类阈值
为了过滤掉假正例结果,同时仍然保证可与代理相匹配的自然语言输入的多样性,您可以调整机器学习分类阈值。此设置用于控制意图匹配所需的最低意图检测置信度。
如果意图匹配的置信度分数小于阈值,则会调用非匹配事件。
您可以为代理启用的每种语言的每个流设置单独的分类阈值。这是为了适应不同语言在不同的分类阈值下效果最佳。如需详细了解如何创建多语言代理,请参阅多语言代理文档。
训练状态
指示自流数据的最新更新以来,流是否经过训练。
训练 NLU
使用此按钮手动训练流。
生成式 AI 设置
您可以使用以下生成式 AI 设置:
常规
禁止的词组
禁止在生成式 AI 中使用的词组列表。 如果提示或生成的响应中出现禁止的短语,则生成将失败。
安全过滤器
根据不同的 Responsible AI (RAI) 类别,配置安全过滤器的敏感度等级。我们将根据以下四个类别对内容进行评估:
类别 说明 仇恨言论 针对身份和/或受保护属性的负面或有害评论。 危险内容 宣传或允许访问有害商品、服务和活动 露骨色情内容 包含对性行为或其他淫秽内容的引用 骚扰内容 针对其他人的恶意、恐吓、欺凌或辱骂性评论 根据内容有害的概率来屏蔽内容。您可以自定义敏感度等级,只需为每个类别选择屏蔽很少、部分屏蔽和屏蔽最多这一项即可。在为项目提交风险确认请求并获得批准后,您还可以使用全部不屏蔽受限选项来停用该类别的 RAI 检查。
如需了解详情,请参阅配置安全属性。
提示安全
您可以勾选启用提示安全检查设置,以启用提示安全检查。启用后,代理将尝试防止提示注入攻击。这些攻击可用于泄露代理提示的部分内容,或提供代理不应提供的响应。其实现方法是发送额外的 LLM 提示,以检查用户查询是否可能是恶意的。
生成式客服
生成模型选择
选择生成特征使用的模型。 如需了解详情,请参阅模型版本。
playbook 上下文截断
playbook 上下文截断会剔除 playbook 提示中的一些以往的回合,以防止提示大小在 playbook 所处理的每个连续回合中增加。此功能提供了一种方法来减少不必要的提示大小增长。
通常,在不截断的情况下,后续的每个回合都会附加到 LLM 提示的“对话记录”,无论该回合是否与当前回合相关都是如此。这最终会导致提示大小每次都会变大。随着对话记录占用的提示越来越多,可用于少样本样本的提示就会越来越少(因此这些提示可能会被丢弃)。最终,提示还可能会突破当前的词元限制。您可以增加词元大小来应对这种情况,但请注意,增加的提示大小也会增加 LLM 响应延迟时间。
借助 playbook 上下文截断,您可以设置要预留给会话历史记录的令牌预算百分比上限。轮流的对话会按从新到旧的顺序保留。 此设置可帮助您防止超出令牌数量上限。 无论您选择哪种设置,系统都按从新到旧的顺序保留至少两个对话回合。
您必须先设置令牌上限,然后才能修改此设置。
重要提示:如果某些参数是挑选回合的一部分,则截断上下文可能会导致这些参数无意中丢失。启用此选项后,请仔细评估您的 playbook 交互。
令牌输入预算也用于以下人员:
- 系统说明和示例:自动添加到提示中。 此行为无法修改。
- playbook 说明和目标:您编写的所有说明和目标都会完整地添加到提示中。
- playbook 小样本示例:按顺序(默认)或按照您选择的算法(例如正则表达式最佳匹配排序)添加。在包含所有其他项后,系统会过滤样本以符合输入令牌预算。
- 对话记录由用户和代理话语、流程和 playbook 转换上下文、同一会话中的工具调用和输出组成,之前所有回合中的工具调用和输出均按当前 playbook 按顺序处理。
生成式后备
文本提示配置
请参阅生成式回退:定义您自己的提示。
数据存储区
请参阅数据存储区代理设置。
语音和 IVR 设置
您可以使用以下语音和 IVR 设置:
Text-to-Speech
语音选择
您可以选择语音合成所用的语言和语音。
您可以从语音选择 Dropbox 中选择自定义语音选项,并在相应字段中指定自定义语音名称,从而为代理启用自定义语音。自定义语音名称必须遵循以下格式:
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 应用控制台设置
本部分介绍了适用于代理应用的设置。
常规
以下常规设置适用于代理应用:
显示名
您的代理应用的人类可读名称。
位置
代理应用区域。
应用锁定
启用后,系统将不允许对代理应用进行更改。
日志记录
以下日志记录设置适用于代理应用:
启用 Cloud Logging
如果启用,日志将发送到 Cloud Logging。
启用对话记录
如果启用,将提供对话记录。 指明您是否希望 Google 收集和存储隐去的最终用户查询以提升质量。 此设置不会影响是否使用对话历史记录来生成代理响应。
启用 BigQuery Export
启用后,对话记录会导出到 BigQuery。此外,还必须启用启用对话历史记录设置。
生成式 AI
代理应用提供以下生成式 AI 设置:
生成模型选择
选择代理默认使用的生成模型。
输入词元限制
为生成模型选择输入词元限制。这是发送到模型的输入的令牌大小上限。根据模型的不同,一个词元可以介于一个字符到一个单词之间。词元限制越小,延迟时间就越短,但模型输入大小会受到限制。词元限制越大,延迟时间就越长,但模型输入大小可能越大。
输出词元限制
为生成模型选择输出词元限制。这是从模型接收输出的令牌大小上限。根据模型的不同,一个词元可以介于一个字符到一个单词之间。词元限制越小,延迟时间就越短,但模型输出大小会受到限制。词元限制越大,延迟时间就越长,但模型输出大小可能越大。
温度
通过 LLM 的温度,你可以控制回答的创造性。 值越小,响应的可预测性越高。数值越高,回答的创意或随机性越强。
禁止的词组
禁止在生成式 AI 中使用的词组列表。 如果提示或生成的响应中出现禁止的短语,则代理将改为返回后备响应。
安全过滤器
根据不同的 Responsible AI (RAI) 类别,配置安全过滤器的敏感度等级。我们将根据以下四个类别对内容进行评估:
类别 说明 仇恨言论 针对身份和/或受保护属性的负面或有害评论。 危险内容 宣传或允许访问有害商品、服务和活动 露骨色情内容 包含对性行为或其他淫秽内容的引用 骚扰内容 针对其他人的恶意、恐吓、欺凌或辱骂性评论 根据内容有害的概率来屏蔽内容。您可以自定义敏感度等级,只需为每个类别选择屏蔽少数(仅屏蔽高概率的有害内容)、屏蔽部分(中高概率实例)和屏蔽大部分(低、中、高概率)即可自定义敏感度等级。在为项目提交风险确认请求并获得批准后,您还可以使用全部不屏蔽受限选项来停用该类别的 RAI 检查。
如需了解详情,请参阅配置安全属性。
提示安全
您可以勾选启用提示安全检查设置,以启用提示安全检查。启用后,代理将尝试防止提示注入攻击。这些攻击可用于泄露代理提示的部分内容,或提供代理不应提供的响应。其实现方法是发送额外的 LLM 提示,以检查用户查询是否可能是恶意的。
Git
这些设置提供了 Git 集成。 按照说明配置集成。