Appearance
提升低代码智能体对话体验
完成核心能力后,可以通过开场白、问题建议、快捷指令和角色设置降低使用门槛,让用户更快理解智能体能做什么以及如何提问。
开场白
对话体验区域还包含用户问题建议、快捷指令和背景图片设置,可与开场白一起配置并在右侧预览区验证。

开场白是用户进入新对话时首先看到的内容,建议包含:
- 智能体身份和主要能力。
- 最适合处理的任务范围。
- 用户开始使用前需要准备的信息。
- 必要的能力边界或风险提示。
示例:
text
你好,我是设备维护助手,可以查询设备手册、解释告警并生成排查步骤。
请告诉我设备型号和告警代码;涉及停机、拆机或高压操作时,请先联系现场安全负责人。避免使用只有欢迎语、没有能力说明的开场白,也不要承诺智能体实际不具备的功能。
开场白预置问题
预置问题用于给用户提供可直接点击的示例。建议设置 3~5 个高频且差异明显的问题,覆盖智能体的主要能力。
好的预置问题:
- 查询某型号设备的保养周期。
- 根据告警代码生成排查步骤。
- 汇总本周未完成的维护任务。
不建议使用“你能做什么”“帮帮我”等过于宽泛的问题作为全部入口。
用户问题建议
在智能体回复后,平台可以根据当前对话给出后续问题建议。启用前应检查:
- 建议问题是否仍在智能体服务范围内。
- 是否会引导用户执行高风险或无权限操作。
- 多 Agent 模式下,问题建议由哪个节点生成。
- 对话流模式或特定发布渠道是否支持该能力。
如果页面允许自定义提示词,应要求建议简短、可执行,并避免重复用户已经问过的问题。
开场白、预置问题和用户问题建议位于同一对话体验页面,可连续完成配置,并在右侧预览区检查展示效果。

快捷指令
快捷指令为高频任务提供固定入口。用户选择指令后,可以直接发送预设问题,或先填写必要参数再发起任务。
简单指令
适合不需要额外参数的高频问题,例如“查看服务范围”“生成今日简报”。配置时填写清晰的指令名称和实际发送内容。
组件指令
适合需要用户选择或填写参数的任务,例如:
- 选择产品型号和问题类型。
- 填写开始日期与结束日期。
- 上传文件并选择处理方式。
组件指令中的字段应与插件、工作流或变量类型一致,并对必填项、格式和取值范围进行校验。
组件型快捷指令需要先绑定可调用的插件或工作流,再将组件字段逐一对应到工具输入参数。

多 Agent 中的指令
快捷指令可以由系统根据输入自动分配 Agent;如果某个指令只适用于一个节点,应明确指定处理节点,减少错误转交。
背景与输入方式
项目支持设置背景图片;支持文本、图片、文件等输入方式。启用前应确认模型和后续技能能够处理对应内容,不能只在界面上开放入口而缺少实际处理能力。
背景图片支持宽屏与竖屏预览。上传后可拖动调整显示位置、缩放图片,并在确认前查看对话页的实际效果。

对于文件和图片输入,还需设置:
- 支持的格式与大小。
- 文件用途和处理范围。
- 无法识别或内容为空时的提示。
- 敏感文件的访问权限和保存策略。
结果卡片
插件或工作流返回结构化数据时,可在支持的渠道中使用卡片展示列表、状态、按钮或关键指标。卡片配置应包含纯文本兜底,以兼容不支持卡片的渠道或渲染失败场景。
渠道适配
不同发布渠道可能对快捷指令、卡片、语音、文件输入和问题建议有不同支持范围。发布前应从真实渠道验证:
- 开场白和预置问题是否正常显示。
- 输入框、文件上传和语音入口是否可用。
- 卡片布局、按钮和跳转是否正确。
- 长回复是否被截断或折叠。
- 失败提示是否清晰且可继续操作。
体验检查清单
- 用户进入页面后能够快速理解智能体用途。
- 示例问题能够覆盖主要能力,而不是只展示一种任务。
- 智能体会在参数不足时主动追问。
- 连续对话中不会重复索要已经提供的信息。
- 回复包含明确结论、必要依据和下一步建议。
- 高风险操作前有确认,失败后有可执行的恢复建议。
- 文本、卡片、语音和文件能力均在实际渠道中测试。