Appearance
3.21 扫地机器人
3.21.1 造型介绍
这是一台会“听令清扫”的智能扫地机器人，上电后进入待命状态。WonderLLM大模型支持任意语音指令控制扫地功能，360°积木舵机驱动小车自动前进并左右摆动模拟扫地动作，就像一位勤劳的清洁管家，用语音指挥轻松完成地面清扫任务。
3.21.2 学习目标
认识360° 双积木舵机与 WonderLLM 联网大模型，掌握两路舵机的扩展板接线方式。
使用日常口语自由控制机器人启动清扫、原地停机。
3.21.3 造型搭建
3.21.4 模式切换
本造型需要用在线大模型，如果已经进入在线大模型模式即可跳过此步骤直接进入设备接线步骤，否则请参考"4.5.10 模式切换"重新烧录对应固件。
3.21.5 设备接线
将 WonderLLM 模块接线插入 micro:bit 扩展板 接口；
将左边的360°积木舵机分接线插入 micro:bit 扩展板 接口，舵机 接线插入 S1 的 引脚处；
将右边的360°积木舵机分接线插入 micro:bit 扩展板 接口，舵机 接线插入 S2 的 引脚处。
如图所示：
3.21.6 程序编写
(1) 程序原理图
(2) 核心代码块解析
| 指令块 | 所在类别 | 功能说明 |
 |  | 定义/获取用于存储数据的变量 |
 | 对自定义变量进行赋值操作 | |
 |  | 初始化 DaDabit 模块，为后续使用做准备。 |
 | 初始化 WonderLLM 接口，建立模块通信连接。 | |
 | 配置 AI 模块可调用的自定义功能工具参数 | |
 | 向 AI 模块同步 MCP 工具配置信息 | |
 | 读取 AI 模块调用工具后传回的运行数据 | |
 | 根据指定的键，从目标字典中提取对应的数字类型数值并返回 | |
 | 告知 AI 模块单次工具调用流程结束 | |
 | 控制指定编号的360°积木舵机，按设定的旋转方向与速度持续运行 | |
 |  | 判断目标文本内是否包含指定字符 |
(3) MCP工具参数配置
- 工具名称：self.robot.setAction
工具描述：You can control the sweeping action. Parameters are as follows: 1 is returned when starting to sweep the floor, and 0 is returned when stopping the sweeping.
简述：你可以控制扫地动作。参数如下：开始扫地时返回1，停止扫地时返回0。
AIModule返回参数： [["action", "int", "0", "0", "1"]]
注意：字段名 action，整型，第一个 0 为默认值，第二个 0 为最小值，1 为最大值
是否阻塞直到调用完成：true
是否有数据返回给AIModule：false
功能：这段 MCP 配置是给 AI 模块定义扫地机器人的启停控制工具：让 AI 能下发 0 或 1 指令控制扫地动作（启动扫地返回 1，停止扫地返回 0），调用时程序会等待操作执行完毕，且无需向 AI 回传额外运行数据。
(4) 完整程序展示
上电初始化 DaDabit 扩展库、WonderLLM 模块的硬件接口为 3，开启 MCP 工具并配置 setAction 开关参数；
程序循环读取大模型下发 0/1 清扫开关参数，获取工具运行数据；
参数为 1 时双 360° 积木舵机同步前进模拟清扫，参数为 0 时立刻停机；
清扫动作阻塞执行完毕，小车静止重新监听语音。
程序链接：https://makecode.microbit.org/_VLg4KPFss9kw 你也可以通过以下网页直接下载程序：
3.21.7 程序下载
3.21.8 扩展提升
项目一：清扫计时统计
语音启动 A 键开启计时，点阵逐秒刷新清扫时长，停机显示总用时，清扫时绿色 RGB 常亮，练习变量计时、数字动态刷新。
项目二：档位清扫
语音 “轻扫” 低速黄灯，“深度清扫” 高速橙灯，长按 B 清零计时，掌握语义解析、舵机速度分级控制。
3.21.9 技术支持与产品讨论
如果您在产品使用过程中遇到困难，欢迎您通过如下方式向我们反馈：
如果您在产品体验后有更好的创意，欢迎您进入幻尔社区将您的创意分享：
