AI聊天机器人方案是一个基于UniRTOS与Coze平台构建的智能语音交互与端侧工具调用方案。
本项目以UniRTOS作为端侧运行基础,结合Coze平台完成模型对话与云端能力接入,在移远EG800Z模组上实现按键交互、语音对话、模型问答、端侧工具调用及音频链路处理。系统支持通过按键和语音两种方式发起模型对话,并可在对话过程中调用端侧工具,例如控制LED打开/关闭、打印端侧日志等;同时支持灵活扩展,用户可自行添加端侧或云端工具调用、更改音频编码等。依托API接口丰富的UniRTOS,方案具备良好的跨模组适配能力,便于在不同移远模组上运行,适用于智能语音助手、AI交互终端、端侧工具控制及移远模组快速集成等场景。
开发资源
| 资源名称 | 数量 | 简要描述 | 获取方法 |
|---|---|---|---|
| QuecDuino开发板 | 1 | 项目运行硬件平台。 | 点此购买 |
| USB数据线 | 1 | 用于连接PC和开发板,非“仅充电”类型的USB-A转USB-C。 | 点此购买 |
| PC | 1 | 系统为Windows 10/Windows 11。 | 自行准备 |
| SIM卡 | 1 | 可正常上网的USIM卡。 | 自行准备 |
| 喇叭 | 1 | 功率 2-5 W的喇叭 | 点此购买 |
| LED模块 | 1 | GPIO驱动的LED模块 | 点此购买 |
| ASRPRO | 1 | 可选,用于语音唤醒 | 自行准备 |
快速上手
硬件连接

- 使用跳线帽短接开发板的PA引脚。
- 将LTE天线安装到开发板的天线底座。
- 将SIM卡插入SIM卡卡槽。
- 将喇叭接入扬声器接口。
- 使用USB数据线连接开发板和PC。
- (可选)将ASRPRO模块连接至UART1,UART交叉连接:模块TX接主控RX,模块RX接主控TX。
软件部署
开发环境搭建
参考UniRTOS快速入门完成开发环境安装,并确认unirtos-cli可在PowerShell中使用。
代码拉取
新开启PowerShell窗口,执行以下命令:
unirtos-cli new -r
unirtos-maker-examples cd unirtos-maker-examples/voice_chatbot
修改配置参数
项目配置集中在main/inc/chatbot_config.h。
| 配置类别 | 配置项 | 说明 |
|---|---|---|
| 唤醒模块 | CHATBOT_WAKE_UART_PORT、CHATBOT_WAKE_UART_BAUDRATE | ASRPRO的UART端口与波特率,当前为UART1、9600 bps。 |
| 唤醒关键字 | CHATBOT_WAKE_KEYWORD | ASRPRO上报并用于匹配的关键字,当前示例为"WAKE"。 |
| 状态LED | CHATBOT_LED_PIN_NUM | 状态指示灯物理引脚,当前默认为 55。 |
| PTT按键 | CHATBOT_TALK_BUTTON_PIN_NUM、CHATBOT_TALK_BUTTON_GPIO | 按键物理引脚与GPIO映射,当前为 50 号引脚对应GPIO37。 |
| Coze接入 | CHATBOT_COZE_BOT_ID、CHATBOT_COZE_AUTH_TOKEN | 分别配置Bot ID和访问令牌。令牌属于敏感信息,必须使用自己的有效令牌。 |
| 音频编码 | CHATBOT_AUDIO_CODEC_G711A | 设为 1 时使用G711A、8 kHz;设为 0 时使用PCM16、16 kHz。 |
| 音频帧 | CHATBOT_AUDIO_FRAME_MS | 单帧时长,当前为 100 ms。 |
| 会话参数 | CHATBOT_SESSION_IDLE_TIMEOUT_MS、CHATBOT_RECONNECT_BACKOFF_MS | 分别配置空闲超时和重连退避,当前为 60 s和 5 s。 |
构建项目
在PowerShell中执行:
unirtos-cli env-setup
unirtos-cli build -m EG800ZCN_LA
构建成功后,命令行末尾将显示:
SUCCESS: Unirtos project built successfully!
通过QFlash工具将生成的固件烧录至开发板。
应用演示
修改项目Coze平台相关信息(访问令牌、bot_id等),其他端侧外设可自由修改配置(唤醒键、状态灯等),以下演示使用默认配置。
上电开机
长按开发板上的按键S1,此时编号为D1的开机指示灯(红色)亮起,表示模块已开机。

唤醒连接
长按开发板上的按键S2,此时编号为D3的状态指示灯(绿色)亮起,松开按键,模块开始连接Coze平台,等待喇叭播放固定开场白,表示已成功连接Coze平台。

与智能体对话
再次长按开发板上的按键S2,对着板载麦克风说出问题,完成之后松开按键,智能体会对识别的问题进行回复,继续对话重复上述操作即可。在智能体输出回复期间也可长按打断本轮对话,开始下一轮新对话。

断开连接
在无对话空闲状态下,60 s后模块将主动断开与Coze平台的连接,此时状态指示灯D3将会熄灭。

软件详解
若想了解项目的核心逻辑和软件架构,请移步参考AI聊天机器人。