Appearance
为低代码智能体添加技能
技能让智能体能够查询实时信息、调用业务服务或执行多步骤任务。常见技能包括插件、工作流和触发器。
选择技能类型
在智能体编辑页向下滚动到技能区域，可分别展开插件和工作流进行配置。
| 类型 | 适用场景 | 示例 |
|---|---|---|
| 插件 | 调用一个或一组 API 完成查询或操作 | 搜索、天气查询、业务数据查询、提交工单 |
| 工作流 | 按明确步骤组合多个节点和服务 | 信息收集、数据处理、报告生成、审批处理 |
| 触发器 | 在指定时间或事件发生时自动启动任务 | 定时简报、周期提醒、事件通知 |
添加前先确认模型是否已经能够完成任务。无需外部数据或真实操作时，不建议为智能体添加多余技能。
添加插件
操作步骤
- 在智能体编排页面找到技能或插件区域。
- 单击添加按钮，从资源库或插件列表中选择插件。
- 查看插件说明、授权要求、输入参数和返回数据。
- 选择需要使用的工具并完成授权或凭据配置。
- 保存后，在人设与回复逻辑中说明插件的调用条件。
- 使用真实问题测试插件是否被正确调用。
可通过搜索、资源库分类、企业插件或收藏定位目标插件；查看插件说明和权限要求后，选择需要添加的插件。
参数配置
插件参数通常来自以下位置：
- 用户本轮输入。
- 历史对话或上下文。
- 系统变量和用户变量。
- 固定配置值。
- 前一步插件或工作流的输出。
参数名称和类型必须与插件定义一致。不要假设模型总能从自然语言中推断必填参数；如果参数缺失，应先向用户追问，不应提交不完整请求。
提示词示例
text
当用户询问实时订单状态时，调用“订单查询”插件。
调用前必须取得订单号；如果用户未提供订单号，先询问用户。
插件返回成功时，仅提取订单状态、更新时间和下一步建议。
插件返回为空或失败时，说明当前无法查询，不得编造订单状态。绑定结果卡片
当插件返回列表、状态或操作结果，并且当前渠道支持卡片时，可以将返回字段绑定到结果卡片。绑定前应确认字段路径、数据类型和空值处理；调试时同时检查卡片和纯文本兜底效果。
添加工作流
前提条件
- 工作流已完成试运行，并发布了可用版本。
- 开始节点的输入参数和结束节点的输出参数清晰。
- 智能体对工作流及其引用资源拥有访问权限。
操作步骤
- 在智能体技能区域选择工作流。
- 从资源库中选择目标工作流和正确版本。
- 检查工作流的输入、输出和运行方式。
- 添加后，在提示词中说明何时调用以及如何使用返回结果。
- 预览测试正常输入、缺少参数和工作流失败场景。
在弹窗中可按类型、状态和创建人筛选工作流。优先选择已发布版本，核对输入参数后单击“添加”绑定到当前智能体。
同步与异步运行
- 同步运行：智能体等待工作流完成后再组织回复，适合耗时较短且结果必须立即返回的任务。
- 异步运行：工作流在后台执行，适合耗时较长的任务。智能体应明确告知用户任务已受理，并提供查看状态或结果的方式。
运行方式以当前工作流和编辑器提供的选项为准。不能为了减少等待而把必须立即返回结果的流程错误地改为异步。
添加触发器
触发器用于让智能体在没有用户即时提问的情况下自动执行任务。是否支持触发器取决于项目类型、版本和账号权限。
| 类型 | 说明 |
|---|---|
| 定时触发器 | 按指定日期、时间或周期执行 |
| 事件触发器 | 在外部事件或业务状态变化时执行 |
添加触发器时应明确：
- 时区、执行时间和重复周期。
- 触发所需的输入参数和数据来源。
- 执行结果发送到哪里，由谁查看。
- 重复触发、失败重试和停用条件。
- 触发器所用技能和数据的权限范围。
正式启用前先执行试运行，并检查是否会重复发送消息或产生重复业务操作。
移除或替换技能
移除插件或工作流前，先搜索人设与回复逻辑、快捷指令和其他节点是否仍然引用该技能。替换技能后，应重新检查参数映射、返回字段和卡片绑定，不能只替换名称。
常见问题
智能体没有调用技能
检查以下内容：
- 提示词是否明确说明调用条件和技能用途。
- 技能描述是否清晰，是否与其他技能用途重叠。
- 必填参数是否能够从用户输入或上下文获得。
- 当前模型是否支持工具调用。
- 技能、版本和授权状态是否有效。
插件提示未授权
确认插件要求的账号授权或凭据已经配置，当前操作者和发布后的运行身份均拥有访问权限。预览环境可用不代表发布环境一定可用。
工作流运行失败
从调试详情中检查工作流版本、输入参数、失败节点和资源权限。如果工作流单独试运行也失败，应先在工作流编辑器中修复，再回到智能体验证。
技能返回了数据，但回答不正确
检查返回字段是否被正确引用，以及提示词是否说明如何筛选、解释和展示结果。不得要求模型猜测不存在的返回字段。