代理具有许多会影响其行为的设置。每种游戏机都提供不同的设置。
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 设置:
常规
-
选择生成式功能使用的模型。 如需了解详情,请参阅模型版本。
token 数量上限
-
LLM 的温度可用于控制回答的创意程度。 较低的值可提供更可预测的回答。 值越高,回答就越具创意或随机性。
-
该设置会从 LLM 提示中剔除一些过去的对话轮次,以防止提示大小随着代理处理的每个连续对话轮次而不断增大。此功能可用于缓解不必要的提示大小增长。
通常,如果不进行截断,无论后续轮次是否与当前轮次相关,都会附加到 LLM 提示的“对话历史记录”中。这最终会导致提示在每次对话轮次中不断增大。随着对话历史记录占据的提示空间越来越多,可用于小样本示例的提示空间越来越少(因此这些示例可能会被舍弃)。最终,提示可能还会超出当前的令牌限制。您可以增加令牌大小来解决此问题,但请注意,提示大小的增加也会增加 LLM 的响应延迟。
通过上下文截断,您可以设置要为对话记录预留的令牌预算百分比(上限)。对话轮次会按从近到远的顺序保留。 此设置有助于防止超出令牌限制。 无论您选择哪种设置,系统都会保留至少两次对话轮次,并按从最近到最远的顺序排列。
您必须先设置 token 限制,然后才能修改此设置。
如果被截断的上下文包含被剔除对话轮次中的某些参数,则可能会导致这些参数意外丢失。启用此选项后,请仔细评估剧本互动。
以下功能也会使用 token 输入预算:
- 系统指令和示例:自动添加到提示中。 此行为无法修改。
- Playbook 说明和目标:您撰写的任何说明和目标都将完整地添加到提示中。
- 剧本少样本示例:按顺序(默认)或按您选择的算法(例如正则表达式最佳匹配排序)添加。在包含所有其他项后,示例会被精简以适应输入令牌预算。
- 对话历史记录,由用户和代理的话语、流程和剧本转换上下文、工具调用和输出组成,这些内容来自当前剧本按顺序处理的所有先前回合的同一会话。
-
生成式 AI 禁用的短语列表。 如果提示或生成的回答中包含禁用短语,则生成会失败。 请注意,被禁短语列表会对每个查询和 LLM 调用产生影响,并会增加延迟时间。
-
配置安全过滤条件针对不同 Responsible AI (RAI) 类别的敏感度级别。 我们会根据以下四个类别评估内容:
类别 说明 仇恨言论 针对身份和/或受保护属性的负面或有害评论。 危险内容 宣传或允许访问有害商品、服务和/或活动 露骨色情内容 包含对性行为和/或其他淫秽内容的引用 骚扰内容 针对其他人的恶意、恐吓、欺凌和/或辱骂性评论 根据内容有害的概率来屏蔽内容。您可以为每个类别选择不屏蔽、屏蔽少量、屏蔽部分和屏蔽大部分,从而自定义敏感度级别。
如需了解详情,请参阅配置安全属性。
-
您可以勾选启用提示安全检查设置,以启用提示安全检查。 启用后,代理会拒绝触发安全过滤器的用户查询,包括提示注入攻击。这些攻击可能会用于泄露部分智能体提示,或提供智能体不应提供的回答。为此,我们发送了一个额外的 LLM 提示,用于检查用户查询是否可能具有恶意性。启用后,您可以提供以下选项:
- 提示安全设置:您可以选择默认以使用默认安全设置,也可以选择自定义以明确哪些用户查询应被视为安全或不安全。
- 选择生成式模型:此设置用于控制用于分类的 LLM。 如果您选择默认(推荐),系统会为您选择一个默认模型,该模型可能会随着更新、更出色的模型的推出而自动更改。
- 安全提示:您可以选择默认以使用默认安全提示,也可以选择自定义以提供有助于对恶意用户查询进行分类的说明。 如果您选择默认,系统可能会自动更新提示以进行改进。
- 输入阈值:在应用安全检查之前,用户查询的最小字符长度。 简短的查询更加模糊,可能会被错误地归类。 任何小于输入阈值的查询都将被视为本质上是安全的。
生成式后备
-
请参阅生成式回退:定义自己的提示。
-
-
数据存储区
请参阅数据存储区代理设置。
确定性对话流
这些设置适用于相应代理中的所有流,但机器学习设置除外,后者是按流应用的。 如需修改其他特定于流程的设置,请在控制台中找到相应流程,然后在其中修改设置。
意图训练
Flows 使用机器学习 (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
语音选项
-
-
您可以选择用于语音合成的语言和声音。
您可以从语音名称下拉框中选择自定义语音选项,并在相应字段中指定自定义语音名称,从而为代理启用自定义语音。自定义语音名称必须遵循以下格式:
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 服务账号
-
控制语音音调的相对高低。
-
控制语音的语速。
-
启用后,代理设置中指定的合成语音配置会替换 API、合作伙伴集成或对话配置文件中指定的配置。
-
您可以使用这些设置,通过 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 intent”路由的参数预设中,将会话参数设置为
false(不进行数据处理),在“no intent”路由的参数预设中,将会话参数设置为true(进行数据处理)。
BigQuery Export
启用 BigQuery Export
表示是否已启用 BigQuery 导出。
BigQuery 数据集
BigQuery 数据集名称。
BigQuery 表
BigQuery 表名。
意图建议
您可以启用意图建议。
自定义载荷模板
在本部分中,您可以为自定义载荷模板创建说明和载荷。
机器学习设置
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) 类别的敏感度级别。我们会根据以下四个类别评估内容:
类别 说明 仇恨言论 针对身份和/或受保护属性的负面或有害评论。 危险内容 宣传或允许访问有害商品、服务和活动 露骨色情内容 包含对性行为或其他淫秽内容的引用 骚扰内容 针对其他人的恶意、恐吓、欺凌或辱骂性评论 根据内容有害的概率来屏蔽内容。您可以为每个类别选择不屏蔽、屏蔽少量、屏蔽部分和屏蔽大部分,从而自定义敏感度级别。
如需了解详情,请参阅配置安全属性。
提示安全
您可以勾选启用提示安全检查设置,以启用提示安全检查。 启用后,代理会尝试阻止提示注入攻击。 这些攻击可能会用于泄露部分代理提示,或提供代理不应提供的回答。为此,我们发送了一个额外的 LLM 提示,用于检查用户查询是否可能具有恶意性。
生成式客服
生成模型选择
选择生成式功能使用的模型。 如需了解详情,请参阅模型版本。
Playbook 上下文截断
Playbook 上下文截断会从 playbook 提示中删除一些过去的对话轮次,以防止提示大小随着 playbook 处理的每个连续对话轮次而不断增大。此功能可用于缓解不必要的提示大小增长。
通常,如果不进行截断,无论后续轮次是否与当前轮次相关,都会附加到 LLM 提示的“对话历史记录”中。这最终会导致提示在每次对话轮次中不断增大。随着对话历史记录占据的提示空间越来越多,可用于小样本示例的提示空间越来越少(因此这些示例可能会被舍弃)。最终,提示可能还会超出当前的令牌限制。您可以增加令牌大小来解决此问题,但请注意,提示大小的增加也会增加 LLM 的响应延迟。
通过 playbook 上下文截断,您可以设置要为对话历史记录预留的 token 预算百分比(上限)。对话轮次会按从近到远的顺序保留。 此设置有助于防止超出令牌限制。 无论您选择哪种设置,系统都会保留至少两次对话轮次,并按从最近到最远的顺序排列。
您必须先设置令牌限制,然后才能修改此设置。
重要提示:如果某些参数属于被剔除的对话轮次,截断上下文可能会导致这些参数意外丢失。启用此选项后,请仔细评估剧本互动。
以下功能也会使用 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。
多模态
请参阅通话助手。
共享设置
请参阅访问权限控制。
语言设置
向代理添加其他语言支持。如需完整的语言列表,请参阅语言参考。
自动检测语言
配置语言自动检测后,聊天机器人会自动检测最终用户的语言并切换到该语言。如需了解详情,请参阅语言自动检测文档。
安全设置
请参阅安全设置。
高级设置
目前,唯一的高级设置适用于情感分析。
Vertex AI Agent Builder 控制台设置
本部分介绍了代理应用可用的设置。
常规
以下通用设置可用于代理应用:
显示名
代理应用的人类可读名称。
位置
代理应用区域。
应用锁定
如果启用,则不允许更改代理应用。
日志记录
以下日志记录设置适用于代理应用:
启用 Cloud Logging
如果启用,日志将发送到 Cloud Logging。
启用对话记录
如果启用此设置,系统会提供对话记录。 指示您是否希望 Google 收集和存储已隐去的最终用户查询,以提高质量。 此设置不会影响是否使用对话历史记录来生成智能体回答。
启用 BigQuery Export
如果启用此设置,系统会将对话记录导出到 BigQuery。 还必须启用启用对话历史记录设置。
生成式 AI
以下生成式 AI 设置可用于代理应用:
生成模型选择
选择代理应默认使用的生成式模型。
输入 token 限制
为生成式模型选择输入令牌限制。 这是发送给模型的输入的最大 token 大小。 根据模型,token 可以介于一个字符和一个字词之间。 token 限制越小,延迟时间越短,但模型输入大小会受到限制。令牌限制越大,延迟时间越长,但模型输入大小可以更大。
输出 token 限制
为生成式模型选择输出令牌限制。 这是从模型接收的输出的词元大小上限。 根据模型,token 可以介于一个字符和一个字词之间。 较小的令牌限制具有较低的延迟时间,但模型输出大小有限。 令牌限制越大,延迟时间越长,但模型输出大小可以更大。
温度
LLM 的温度可用于控制回答的创意级别。 较低的值可提供更可预测的回答。 值越高,回答就越具创意或随机性。
禁用短语
生成式 AI 禁用的短语列表。 如果提示或生成的回答中出现禁用短语,代理将改为返回后备回答。
安全过滤器
配置安全过滤条件针对不同 Responsible AI (RAI) 类别的敏感度级别。我们会根据以下四个类别评估内容:
类别 说明 仇恨言论 针对身份和/或受保护属性的负面或有害评论。 危险内容 宣传或允许访问有害商品、服务和活动 露骨色情内容 包含对性行为或其他淫秽内容的引用 骚扰内容 针对其他人的恶意、恐吓、欺凌或辱骂性评论 根据内容有害的概率来屏蔽内容。您可以为每个类别选择不屏蔽(停用 RAI 检查)、屏蔽少部分(仅屏蔽有害内容概率较高的实例)、屏蔽部分(屏蔽有害内容概率中等和较高的实例)和屏蔽大部分(屏蔽有害内容概率较低、中等和较高的实例)中的一个,从而自定义敏感度级别。
如需了解详情,请参阅配置安全属性。
提示安全
您可以勾选启用提示安全检查设置,以启用提示安全检查。 启用后,代理会尝试阻止提示注入攻击。 这些攻击可能会用于泄露部分代理提示,或提供代理不应提供的回答。为此,我们发送了一个额外的 LLM 提示,用于检查用户查询是否可能具有恶意性。
Git
这些设置提供 Git 集成。 按照说明配置集成。