智能体触发器

智能体触发器在设备满足特定事件条件时自动唤起智能体执行任务，例如提醒用户、控制设备、联动其他系统等。你将触发器绑定到设备事件后，每当该事件触发，智能体即以其配置的角色语气进行响应。

典型使用场景

• 电量管理：设备电量过低时自动提醒，强化用户充电意识。
• 环境监控：根据温湿度等传感数据提醒用户调节空调、除湿等操作。
• 异常预警：及时告知用户设备故障、运行异常等情况。

与消息高级推送的区别

• 规则灵活：事件由你自主配置，精细匹配 DP 条件。
• 配置简洁：一键绑定已有事件，无需重复配置。
• 响应智能：Prompt 模板自动生成智能对话。
• 体验自然：结合智能体角色背景，给予更人性化、个性化的表达，提升用户交互体验。

使用条件

• 设备条件：请使用 Wukong SDK v3.12.14 及以上版本开发设备固件。
• 平台配置：
  • 智能体已配置触发器，且对应产品的事件规则已启用。
  • 产品已关联智能体，详情请参考 产品 AI 功能开发。

流程概览

1. 创建设备规则事件：基于 DP 条件配置设备事件，如电量过低、声音过大、温度过高等规则。
2. 配置智能体触发器：将触发器关联已有事件，并设置任务执行逻辑，如发送提示话术。
3. 运行时，设备满足触发条件即启动触发器，用户收到智能提醒或动作执行结果。

创建设备规则事件

基于 设备 PID 和 DP 条件 配置设备事件，步骤如下。

1. 前往 涂鸦开发者平台，在左侧导航栏选择 智能体 > 智能体配置 > 设备事件管理，进入 设备事件管理 页面。

2. 单击页面右上角的 创建，前往创建事件。当前支持 设备事件触发 类型。

   

   在平台创建设备事件

3. 填写设备事件名称，并选择目标产品的 PID。选择 PID 后，可基于该 PID 的 DP 设置触发条件，规则仅对该 PID 下的设备生效。

4. 定义触发条件：选择 通用类型触发条件 或 功能点触发条件，并添加相应的 DP 条件规则。

   以 AI 娃娃的电量过低提醒为例：dp2（电量） < 20 且 dp3（充电状态） = none。

   

   低电量规则的 DP 触发条件

5. （可选）设置触发时段：选择 触发方式 为 连续触发 或 边缘触发。例如，可设置事件仅在特定时间段 08:08 - 21:00 内触发，避免干扰用户。

   

   触发方式与时段设置

6. 保存并启用事件。

   

   处于未启用状态的已保存事件

   备注

   保存配置后，默认事件状态为 未启用。请手动启用事件并在触发器中关联，设备运行时才可触发。启用后，事件将作为可选项出现在触发器配置中。

配置智能体触发器

1. 前往 我的智能体 页面，找到目标智能体，单击 开发版本 进入其开发页面。

2. 在 01 模型能力配置 > 技能配置 > 触发器 下，单击右侧的添加（+）按钮，进入触发器添加页面。

   

   技能配置下的触发器入口

   

   添加触发器弹窗

3. 创建触发器：

   • 触发器名称：填写触发器名称。
   • 触发器类型：选择 设备事件触发。

4. 选择 触发事件：从账号下选择设备事件（如 电量过低）。

   • 若无可选事件，请单击 事件配置 创建规则。
   • 事件默认为未启用状态，请确保启用后才可触发。

5. 定义 任务执行 逻辑：默认任务为 智能体推消息。

   当前仅支持提示消息，暂不支持插件或工作流任务。

6. 编辑提示内容（Prompt）：编写提示词，作为消息内容发送给智能体。

   • 根据需求明确回复内容的格式与要素。
   • 引入动态变量，如 {{sys.dp2}} 表示当前电量值。
   • 提示语应简洁明确，结合动态变量可提升用户个性化体验。
   • 可根据设备属性与使用语境，自定义提示语的语气与表达风格。

   

   触发器任务的 Prompt 编辑器

   更多指引，请参考 如何编写 Prompt。

   触发场景	示例提示语	Prompt 模板
   电量过低提醒	我快没电了，快给我充电吧～	你当前的电量是 {{dp2}}%，请你用一句话提醒我（用户）给你充电。不允许回复其他无关内容。
   温度过高提示	屋里太热了，能开下空调吗？	当前室温为 {{dp4}}℃，请你说一句话提醒主人降温。不允许回复其他无关内容。
   空气质量差	空气好差，要不要开个窗？	当前空气质量为 {{dp5}}，请你说一句提醒主人注意通风换气。不允许回复其他无关内容。
   掉线提醒	设备连接异常，请检查网络。	你掉线了，请你生成一句简洁的提示语，提醒用户检查网络。不允许回复其他无关内容。

7. 配置完成后，单击 确定 保存。

8. 测试执行效果：

   1. 单击触发事件的执行按钮开始调试。

      

      事件上的执行按钮

   2. 在 模拟触发测试 弹窗中，输入虚拟设备 ID，并配合虚拟设备面板查看回复效果，或直接单击 执行 查看 AI 的响应效果。

      

      模拟触发测试弹窗

      备注

      当前仅支持 虚拟设备调试，暂不支持真实设备测试。

即将支持

以下功能为规划中：

• 执行工作流。
• 通过插件等形式执行任务。

相关文档

• 如何编写 Prompt——触发器消息的示例提示语与变量参考。
• MCP 管理——为智能体扩展外部工具与服务。