添加 AI 助手回复
这是用于测试的测试版本
当一个操作被触发时,该操作的主体由多个步骤组成,这些步骤构成了您的 AI 助手与用户之间的对话。 每个步骤的一部分是,当该步骤被处理时, AI助手对客户说的话。
若要在某一步中创建 AI 助手的回复,请使用 “助手说 ”部分。 这代表了 AI助手在特定步骤中向用户提供的文本或语音内容。 根据不同的步骤,您可以为用户的问题添加完整的答案或提出后续问题。
您只需输入希望 AI 助手向用户显示的文本,即可输入简单的文本回复。 您还可以添加格式设置和网页内容,并通过变量引用用户信息。
设置答复的格式
使用文本编辑工具为文本应用字体样式,如粗体或斜体,或添加链接。
在幕后,字体样式和链接语法都以 Markdown 格式存储。 如果使用网络聊天集成,则支持 HTML 和 Markdown 标记。 更多信息,请参阅Markdown 格式化。
发送到 Facebook、WhatsApp,和 Slack 集成的文本回复会自动移除 HTML 标记(链接除外),因为这些渠道不支持 HTML 格式。 HTML 标记仍在支持 HTML 标记的通道(如网络聊天)中处理,并存储在会话历史记录中。
如果使用的是不支持 Markdown 的定制客户机应用程序,请不要将文本样式应用于文本响应。
添加和引用变量
在对话过程中,您的 AI 助手会将信息存储为变量。 变量是运行时可用的数据值的容器。 变量的值会随着时间的推移而变化。 变量包括操作变量 (仅在特定操作期间存在) 和会话变量 (可在任何操作中使用)。 有关变量的更多信息,请参阅 “对话中的信息管理”。
在 AI 助手的输出中,您可以引用变量来个性化对话,或加入运行时可用的信息。 如需了解有关在 AI 助手发言中引用变量的更多信息,请参阅 《使用变量自定义对话》。
测试对策
要检查 AI 助手的回复格式是否正确,您可以使用“预览”功能。
单击 "预览"按钮。
要开始操作,请输入第一个短语,例如:"
What are your store hours?。当 AI 助手作出回应时,请确认消息的显示效果是否符合您的预期,包括格式和变量的使用。
添加回复的提示
使回答保持简短、有用。
在响应中反映出用户的意向。 这样做可让用户确信机器人理解他们的意图,如果理解有误,用户也有机会立即更正误解之处。
如果答案取决于经常变化的数据,请在答案中包含外部网站链接。
认真对响应进行措辞。 您可以根据您的回复措辞改变他人对系统的反应。 更改一行文本可能会使您不必编写多行代码来实施复杂的程序化解决方案。
增加变化
如果用户经常使用您的 AI助手 ,他们可能会因为每次看到相同的问候语和回复而感到厌倦。 您可以添加多种回复选项 ,以便您的 AI 助手能够以不同的方式回应同一请求。
可以选择按顺序或按随机顺序循环提供响应变体。 缺省情况下,响应按顺序循环,如同从排序的列表中进行选择一样。
添加响应变化:
在 Assistant 中 ,点击 “添加回复变体 ”图标
。对于 "反应变体类型",请选择是按顺序还是按随机顺序旋转 "反应变体"。 更多信息,请参阅顺序或随机。

将每个变体添加到自己的字段中。 例如:
答复编号 |
变体 |
|---|---|
答复 1 |
有什么需要我们帮助的? |
答复 2 |
今天我能为您做什么? |
答复 3 |
告诉我能帮上什么忙。 |
答复 4 |
有什么事吗? |
完成后,单击 "应用"。 变体显示为 "Assistant(助理)"中的一个块。 您可以单击 "编辑"图标更新变体,或单击 "删除"图标删除所有变体。 此外,您还可以为一个步骤添加多组响应变化。

顺序或随机
对于响应变化类型,您可以选择顺序或随机。
按顺序返回第一次触发操作时的第一个响应变量,第二次触发操作时的第二个响应变量,以此类推,顺序与输入变量的顺序相同。 这样,在处理节点时,就会按以下顺序返回响应:
第一次:
How can I help you?
第二次:
What can I do for you today?
第三次:
Tell me what I can help with.
第四次
Can I help you?
首次触发操作时随机选择变体,下次触发时随机选择另一个变体,但不会连续重复相同的变体。 此示例显示了回复可能出现的顺序:
第一次:
Tell me what I can help with.
第二次:
Can I help you?
第三次:
How can I help you?
第四次
What can I do for you today?
媒体回应
除了文本回复外,您还可以使用其他_回复类型_来发送包含多媒体或交互元素的回复。
操作编辑器支持以下媒体响应类型:
图像:将图像嵌入到响应中。 源图像文件必须在某个位置进行托管,并具有可用于引用该图像文件的 URL。 这不能是存储在不可公开访问的目录中的文件。
视频:在回复中嵌入视频播放器。 源视频必须托管在某个地方,既可以是受支持的视频流服务上的可播放视频,也可以是带有 URL 的视频文件,你可以用它来引用。 这不能是存储在不可公开访问的目录中的文件。
音频:在回复中嵌入音频片段。 源音频文件必须托管在某个地方,并有一个 URL ,您可以用来引用它。 这不能是存储在不可公开访问的目录中的文件。
iframe:直接在聊天中嵌入外部网站的内容,如表单或其他互动组件。 源内容必须可通过 HTTP 公开访问,并可作为 HTML
iframe元素嵌入。
不同的渠道集成具有不同的媒体响应显示功能。 要查看哪些渠道集成支持哪些响应类型,请参阅响应类型的渠道集成支持。
如果要为不同通道定义不同的自定义响应,可以使用 JSON 编辑器编辑响应。 更多信息,请参阅锁定特定集成。
通过在 JSON 编辑器中编辑响应,您还可以访问更多响应类型,以处理特定通道的交互。
有关如何使用 JSON 编辑器编辑响应的更多信息,请参阅《 使用 JSON 编辑器定义响应 》。
添加图片回复
添加图像响应,向客户显示图像。
以下通道集成支持图像响应类型:
Web 聊天
SMS
Slack
Microsoft Teams
脸书
WhatsApp
要添加图像回复,请完成以下步骤:
在 “助理说 ”字段中,点击 “
图片”图标。
在源 URL 字段中,键入托管图像的完整 URL。
图像必须是 "JPEG、"GIF或 "PNG格式。 图像文件必须存储在 https: URL (如 https://www.example.com/assets/common/logo.png )可公开寻址的位置。
https://s3.eu.cloud-object-storage.appdomain.cloud/your-bucket-name/image-name.png要访问存储在 IBM Cloud® Cloud Object Storage 中的图像,请启用该图像存储对象的公共访问权限,然后通过指定图像源并使用如下语法进行引用:.
可选择在提供的字段中指定图片标题、描述和 alt 文本。 在网络聊天集成中,标题和描述会与图片一起显示。
不支持变量引用。 某些集成通道会忽略标题或描述。
单击应用。
添加语音响应
添加音频回复,以包含口语或其他声音内容。 在网络聊天中,音频回复会显示为嵌入式音频播放器。 在电话集成中,电话中会播放音频回复。
以下通道集成支持音频响应类型:
Web 聊天
电话
SMS
Slack
脸书
WhatsApp
要添加音频应答,请完成以下步骤:
在 “Assistant 说 ”字段中,点击 “
音频”图标。在源 URL 字段中,键入托管音频片段的完整 URL :
要直接链接到音频文件,请指定 URL ,链接到任何标准格式的文件,如 MP3 或 WAV。 在网络聊天中,链接的音频片段会显示为嵌入式音频播放器。
要链接到受支持的音频托管服务上的音频片段,请指定音频片段的 URL。 在网络聊天中,链接的音频片段会使用托管服务的嵌入式播放器播放。
指定用于在浏览器中访问音频文件的 URL (例如 https://soundcloud.com/ibmresearch/fallen-star-amped )。您无需将 URL 转换为可嵌入的形式;网络聊天会自动进行转换。
您可以嵌入以下服务托管的音频:
可在提供的字段中指定标题、描述和 alt 文本。 在网络聊天集成中,标题和描述会与音频播放器一起显示。
不支持变量引用。 某些集成通道会忽略标题或描述。
添加视频回复
添加视频回复,以显示操作演示、宣传剪辑或其他视频内容。 在网络聊天中,视频回复会显示为嵌入式视频播放器。
以下通道集成支持视频响应类型:
Web 聊天
SMS
Slack
脸书
WhatsApp
要添加视频回复,请完成以下步骤:
在 “Assistant says ”字段中,点击视频图标
。
在源 URL 字段中,键入托管视频的完整 URL :
要直接链接到视频文件,请在 URL 中指定任何标准格式(如 MPEG 或 AVI)的文件。 在网络聊天中,链接的视频会渲染为嵌入式视频播放器。
不支持 HLS(.m3u8)和 DASH (MPD) 流媒体视频。
要链接到在受支持的视频托管服务上托管的视频,请指定视频的 URL。 在网络聊天中,链接的视频会使用托管服务的嵌入式播放器播放。
指定用于在浏览器中观看视频的 URL (例如 https://www.youtube.com/watch?v=52bpMKVigGU )。您无需将 URL 转换为可嵌入的形式;网络聊天会自动进行转换。
您可以嵌入以下服务托管的视频:
可选择在提供的字段中指定视频标题、描述和 alt 文本。 在网络聊天集成中,标题和描述会与视频播放器一起显示。
不支持变量引用。 某些集成通道会忽略标题或描述。
如果要将视频缩放至特定的显示尺寸,请在 "基本高度"字段中指定一个数字。
添加 iframe 响应
添加iframe响应,将其他网站的内容作为 HTML "iframe元素直接嵌入聊天窗口。 如果您想让客户在不离开聊天的情况下与外部服务进行交互,iframe 响应就非常有用。 例如,您可以使用iframe响应在网络聊天中显示以下示例:
Google 地图上的交互式地图
一项使用 SurveyMonkey 的调查
通过 OpenTable 进行预订的表格
一个使用 Calendly 的日程安排表单
在网络聊天中,有两种方式可以包含 iframe:
比如描述嵌入内容的预览卡。 客户可以点击此卡来显示框架并与内容互动。
内联,即在对话中。 该选项适用于较小的 iframe 内容。
以下通道集成支持iframe响应类型:
Web 聊天
脸书
要添加iframe响应类型,请完成以下步骤:
在 “Assistant says ”字段中,点击 iframe 图标(
)。
在 iframe 源字段中添加外部内容的完整 URL。
URL 必须指定可嵌入 HTML iframe 元素的内容。 不同的网站对嵌入内容有不同的限制,生成可嵌入 URL 的流程也不同。 可嵌入的 URL 是指可以指定为 iframe 元素的 src 属性值的。
例如,要嵌入使用Google地图的交互式地图,可以使用Google地图嵌入 API。 如需了解更多信息,请参阅 《地图嵌入式 API 概述》。 其他网站创建可嵌入内容的流程各不相同。
有关如何使用 Content-Security-Policy: frame-src 该功能将网站内容嵌入到您的 AI 助手中的技术细节,请参阅 CSP:frame-src。
可选择在标题字段中添加描述性标题。
在网络聊天中,您添加的标题会显示在预览卡中。 客户点击预览卡即可显示外部内容。
如果没有指定标题,网络聊天会尝试从指定的 URL 中检索元数据,并根据源中的指定显示内容标题。
不支持变量引用。
要在对话流程中显示 iframe,而不是作为预览卡,请将 "内嵌显示 iframe"设置为"开"。 您还可以设置 iframe 的高度。 默认值为 180 像素。
技术细节: iframe 沙箱技术
由网络聊天在 iframe 中加载的内容处于“沙箱”环境中,这意味着其权限受到限制,从而降低了安全漏洞的风险。 Web 聊天使用 元素 iframe 的 属性 sandbox ,仅授予以下权限:
许可权 |
描述 |
|---|---|
|
如果下载由用户发起,则允许从网络下载文件。 |
|
允许提交表格。 |
|
允许运行脚本,但_不_允许打开弹出窗口。 |
|
允许内容访问自己的数据存储(如 cookie),并允许对JavaScriptAPI 进行有限访问。 |
如果外部页面与 iframe 的源不同,那么在沙箱化 iframe 中运行的脚本将无法更改 iframe 外部的任何内容。 如果您使用 iframe 响应来嵌入与托管网络聊天小部件的页面具有相同源的内容,请务必谨慎。 在这种情况下,嵌入的内容就能打败沙盒,访问框架外的内容。 有关此潜在漏洞的更多信息,请参阅该 sandbox 属性的文档。
技术详情: iframe 预览卡
网络聊天中的 "iframe响应类型会显示预览卡,其中包括用户在网络聊天中访问的网页的图片、标题和描述。
要在 "预览卡中显示图片、标题和说明,网页需要在 "<head>标记内添加以下 "<meta>标记:
<meta property="og:image" content="https://.../image.jpg" />
<!--or-->
<meta property="og:image:url" content="https://.../image.jpg" />
<meta property="og:title" content="The webpage title" />
<meta property="og:description" content="The webpage description" />
这些指定的元数据属性源自 《开放图谱协议》。
元数据是可选的。 网络聊天会显示一张预览卡,上面有网络聊天成功获取的网页网址和元数据。
暂停响应
使用 “暂停 ”响应,让您的 AI 助手在给出下一个响应前等待指定的时间间隔。 这种暂停可以为请求的完成留出时间,也可以像实时代理一样,在回复之间暂停一下。 暂停时长必须在 0 到 60 秒之间,可以包含秒的小数部分,以便将暂停时长设置为最多 milliseconds。
暂停响应通常与其他响应结合使用。 默认情况下,暂停期间会出现打字指示动画,以模拟实时代理。
以下通道集成支持暂停响应类型:
Web 聊天
脸书
WhatsApp
在电话渠道中,您可以在 AI 助手的输出中加入 SSML break 元素来添加停顿。 Text to Speech 文档如需了解更多信息,请参阅。
要添加暂停回复:
在 “Assistant 说 ”字段中,点击 “
暂停”图标。
在 "持续时间"字段中,用 "
seconds输入暂停的时间长度。
持续时间不得超过 "60 seconds。 此外,您还可以在 "持续时间字段中输入 "second的小数位数,以暂停响应,直至 "milliseconds。 例如,如果您输入 "10.50 seconds,响应会暂停到 "10500 milliseconds。 客户通常愿意等待大约 8 秒钟才有人输入回复。
打字指示器默认设置为开。 如果需要,可以将其设置为 "关闭"。
在暂停后添加其他响应类型(例如,文本响应类型)即明确表示暂停结束。