【EG800Z-CN】语音聊天机器人

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 可选,用于语音唤醒 自行准备

快速上手

硬件连接

  1. 使用跳线帽短接开发板的PA引脚。
  2. 将LTE天线安装到开发板的天线底座。
  3. 将SIM卡插入SIM卡卡槽。
  4. 将喇叭接入扬声器接口。
  5. 使用USB数据线连接开发板和PC。
  6. (可选)将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聊天机器人。