以下作品由安信可社區(qū)用戶

無垠的廣袤制作

感謝安信可社區(qū)的支持，免費(fèi)領(lǐng)到了安信可的最新產(chǎn)品小安AI - AiPi-PalChatV1 語音開發(fā)板。

原貼地址：

【AiPi-PalChatV1語音開發(fā)板】開箱、配網(wǎng)、對(duì)話

【AiPi-PalChatV1語音開發(fā)板】小智 MCP 接入 Home Assistant

目錄

一、開箱

1.1包裝

1.2開發(fā)板

二、開發(fā)板介紹

2.1功能特點(diǎn)

2.2技術(shù)參數(shù)

2.3適應(yīng)場(chǎng)景

2.4原理圖

三、上電及配網(wǎng)

四、效果

五、MCP 介紹

六、準(zhǔn)備工作

七、小智 MCP 接入 HA

八、補(bǔ)充介紹：小智 MCP 啟動(dòng)器和小智 AI 客戶端

01開箱

介紹了 AiPi-PalChatV1 語音開發(fā)板的包裝及外觀等。

包裝

外層防靜電袋，保護(hù)精密器件在運(yùn)輸途中遠(yuǎn)離摩擦靜電影響；

PP 環(huán)保塑料外殼包裝，加上內(nèi)層隔振海綿，確保運(yùn)輸過程中開發(fā)板的穩(wěn)固安全。

開發(fā)板

該套件包括開發(fā)板、麥克風(fēng)、揚(yáng)聲器，已連接至相應(yīng)的快接插頭。

02開發(fā)板介紹

AiPi-PalChatV1 是一款接入了小智AI智能體的微型語音交互開發(fā)板，專為輕量級(jí)智能語音場(chǎng)景設(shè)計(jì)。

基于安信可 Ai-WB2-12F 模組主控，具備高集成度、高性價(jià)比等特性，支持離線語音喚醒與語音打斷功能，結(jié)合2W/8Ω 揚(yáng)聲器與雙供電模式（Type-C + 電池），適用于快速部署語音交互能力的硬件創(chuàng)新場(chǎng)景。

功能特點(diǎn)

離線語音交互

支持離線語音喚醒，解放雙手。

支持語音打斷，提升交互自然度。

靈活供電模式

Type-C 有線供電，適配常規(guī)電源環(huán)境。

電池供電設(shè)計(jì)，滿足移動(dòng)場(chǎng)景需求。

輕量級(jí)硬件配置

小尺寸板載設(shè)計(jì)，易于集成到各類設(shè)備中。

2W/8Ω 揚(yáng)聲器提供清晰音效輸出。

便捷開發(fā)與配置

微信小程序一鍵配網(wǎng)，簡(jiǎn)化設(shè)備聯(lián)網(wǎng)流程。

智能體配置可視化，支持自定義音色與場(chǎng)景邏輯。

全新模組連接方案

安信可 Ai-WB2 系列模組，多種尺寸。

低成本快速落地

開箱即用的語音方案，降低開發(fā)周期與硬件成本。

高兼容性

支持主流物聯(lián)網(wǎng)協(xié)議，可擴(kuò)展接入智能家居生態(tài)。

技術(shù)參數(shù)

智能家居控制

作為語音中控模塊，嵌入燈具、窗簾、家電等設(shè)備，實(shí)現(xiàn)本地化語音控制。

低成本改造傳統(tǒng)家居為智能語音交互場(chǎng)景。

教育/兒童玩具

集成到早教機(jī)、故事機(jī)中，支持離線語音問答與互動(dòng)內(nèi)容播放。

工業(yè)設(shè)備交互

為小型工業(yè)設(shè)備（如檢測(cè)儀、控制面板）添加語音指令操作，提升人機(jī)交互效率。

原理圖

電源管理

供電

Sound

麥克風(fēng)

主控

外設(shè)

源碼及固件詳見：

https://gitee.com/Ai-Thinker-Open/xiaoan-ai_wb2

固件上傳方案詳見：

AI語音開發(fā)板AiPi-PalChatV1教程：燒錄與調(diào)試

03上電及配網(wǎng)

上電

檢查麥克風(fēng)、揚(yáng)聲器、屏幕是否已連接；

使用 Type-C 數(shù)據(jù)線接入設(shè)備的 Type-C 口，打開電源開關(guān)，紅燈亮起。

播報(bào)語音：【 我是你的人工智能語音助手，請(qǐng)對(duì)我說，你好小安，開始配網(wǎng) 】

若接入電池，在 Type-C 數(shù)據(jù)線接入后，藍(lán)色充電指示燈亮起表示正在充電，熄滅表示充滿，閃爍表示未插入電池。

配網(wǎng)

首次啟動(dòng)需配置網(wǎng)絡(luò)連接

對(duì)麥克風(fēng)說：【你好小安】

回復(fù)：我在

說：【開始配網(wǎng)】

回復(fù)：進(jìn)入配網(wǎng)模式，請(qǐng)使用安信可小程序或App 進(jìn)行配網(wǎng)

小程序

打開 安信可 IOT 微信小程序；

選擇 AI 硬件智能體 ，點(diǎn)擊 添加設(shè)備 - 掃描設(shè)備 ；

點(diǎn)擊連接 BL602_XZ_V1.0_XXXXXXXXXX 設(shè)備；

填寫 WiFi 名稱和密碼 - 配置 WiFi

回復(fù)：連網(wǎng)中

回復(fù)：連網(wǎng)成功

若連接失敗，則需重啟設(shè)備，重新配網(wǎng)

小智 AI 界面

完成設(shè)備配網(wǎng)后，開發(fā)板會(huì)循環(huán)播報(bào)驗(yàn)證碼，如 028030 ，此時(shí)需進(jìn)行小智 AI 配對(duì)；注冊(cè)和登錄 小智 AI

網(wǎng)頁(yè)端，點(diǎn)擊 控制臺(tái) - 新建智能體 - 輸入相應(yīng)的個(gè)性化配置；

點(diǎn)擊添加設(shè)備 - 輸入播報(bào)的 6 位數(shù)字 - 手動(dòng)復(fù)位設(shè)備；

上電之后，播報(bào) 聯(lián)網(wǎng)成功，再喚醒設(shè)備。

語音喚醒：你好小安

回復(fù)：我在

之后便可進(jìn)行連續(xù)對(duì)話。

04效果

聯(lián)網(wǎng)后可通過對(duì)話調(diào)整音量

查看視頻?www.bilibili.com/video/BV1Vrjfz7EmK/?spm_id_from=888.80997.embed_other.whitelist&t=1.950844&bvid=BV1Vrjfz7EmK&vd_source=54c5db21948db2378659b7e8e42bafbf

彩蛋：可以播放歌曲，音質(zhì)還不錯(cuò)哦~

查看視頻?www.bilibili.com/video/BV1Vrjfz7EXy/?spm_id_from=888.80997.embed_other.whitelist&t=1.335934&bvid=BV1Vrjfz7EXy&vd_source=54c5db21948db2378659b7e8e42bafbf

05MCP 介紹

消息上下文協(xié)議 (Model Context Protocol, MCP) 是一個(gè)開放協(xié)議，用于標(biāo)準(zhǔn)化應(yīng)用程序如何向 LLM 提供上下文。

MCP 為 AI 模型連接不同的數(shù)據(jù)源和工具提供了標(biāo)準(zhǔn)化的方式。

MCP 可用于構(gòu)建 AI 驅(qū)動(dòng)的 IDE、增強(qiáng)聊天界面、創(chuàng)建自定義 AI 工作流等場(chǎng)景。它能幫助開發(fā)者更好地管理和利用 LLM 的上下文信息。

詳見：

MCP中文簡(jiǎn)介 – MCP 中文站（Model Context Protocol 中文）

Model Context Protocol

MCP - python-sdk

06準(zhǔn)備工作

包括 Home Assistant 安裝以及 HACS 部署、小智 MCP 接入等流程。

Home Assistant 安裝

1.安裝 Docker 容器

2.本地下載并部署 EMQX 平臺(tái)

3.部署 HomeAssistant 智能家居平臺(tái)

詳見：

【BW21-CBV-Kit 開發(fā)套件測(cè)評(píng)】OLED藍(lán)牙溫濕度計(jì)與Home Assistant連接藍(lán)牙溫濕度計(jì) DIY

HACS 部署

在 Docker 安裝 HomeAssistant 的基礎(chǔ)上，部署 HACS 應(yīng)用商店。

shell_command服務(wù)

復(fù)制代碼到 HA 配置文件 configuration.yaml

shell_command:  update_hacs_china:|-    wget -O - https://get.hacs.vip | bash -

重啟 HA 使配置生效，在開發(fā)者工具中執(zhí)行動(dòng)作

action: shell_command.update_hacs_china

再次重啟HA使更新后的 HACS 生效

或下載 HACS 至本地，將其復(fù)制到 HA 安裝目錄 config/custom_components/hacs 路徑，重啟 HA ，添加集成即可。

參考：

hacs-china

hacs-china 極速版

07小智 MCP 接入 HA

原理

使用小智官方給的示例代碼，結(jié)合 mcp_proxy，實(shí)現(xiàn)小智官方服務(wù)器和 Home Assistant 的 MCP Server 打通。

參數(shù)

XIAOZHI_MCP_ENDPOINT

小智 MCP 接入點(diǎn)，登錄 小智 官方服務(wù)器獲取；

HA_MCP_ENDPOINT

HA MCP SERVER 地址 ，通過 HA 官方的 mcp_server 集成獲取，通過鏈接 Home Assistant MCP Server 集成 直達(dá)安裝，列表中選擇 Model Context Protocol 并完成配置；

API_ACCESS_TOKEN

長(zhǎng)效 API 令牌，訪問 Home Assistant 賬戶配置文件設(shè)置，進(jìn)入 安全 標(biāo)簽，創(chuàng)建長(zhǎng)期訪問令牌。

詳見：

shawn996/mcp_ha_xiaozhi: 小智官方服務(wù)器(蝦哥)對(duì)接home assistant的mcp server

安裝

在 Home Assistant 已安裝 HACS 的基礎(chǔ)上

打開HACS, 點(diǎn)擊 Custom repositories

Repository 輸入項(xiàng)目地址: https://github.com/c1pher-cn/ha-mcp-for-xiaozhi ；

Category 選擇 Integration 。

點(diǎn)擊 ADD 添加外部鏈接，選擇 MCP Server for Xiaozhi 并 Download 下載安裝該插件；

設(shè)置 - 右上角 更多 選項(xiàng) - 重啟 Home Assistant ；

進(jìn)入HACS，可見 MCP Server for Xiaozhi 已下載和安裝；

配置

設(shè)置 - 設(shè)備與服務(wù) - 添加集成 - 搜索 MCP 安裝 MCP Server for Xiaozhi ；

填寫小智接入點(diǎn)地址 - 提交 - 添加成功。

訪問小智 AI 控制臺(tái)，查看 MCP 接入點(diǎn)狀態(tài)，顯示 在線 表明 小智與 HA 連接配置成功。

在 設(shè)置 - 語音助手 選項(xiàng)下開啟 HA 語音助手；

之后可通過 AiPi-PalChatV1 開發(fā)板控制 HomeAssistant 平臺(tái)的設(shè)備、訪問獲取傳感器參數(shù)等。

詳見：

Homeassistant MCP server for 小智AI

08補(bǔ)充介紹：小智 MCP 啟動(dòng)器和小智 AI 客戶端

介紹下小智 MCP 啟動(dòng)器和小智 AI 客戶端，便于設(shè)備調(diào)試與小智連接 HA 項(xiàng)目的測(cè)試。

小智 AI MCP 啟動(dòng)器

參考：

小智AI配置MCP接入點(diǎn)使用說明

可視化xiaozhi接入mcp

小智 AI 客戶端

Python版本的小智ai，可以在沒有硬件支持的條件下實(shí)現(xiàn)小智 AI 對(duì)話功能。

介紹

py-xiaozhi 是一個(gè)使用 Python 實(shí)現(xiàn)的小智語音客戶端，旨在通過代碼學(xué)習(xí)和在沒有硬件條件下體驗(yàn) AI 小智的語音功能。

IoT 功能

py-xiaozhi 提供豐富的 IoT 設(shè)備控制功能：

虛擬設(shè)備：燈光控制、音量調(diào)節(jié)、倒計(jì)時(shí)器等；

物理設(shè)備集成：溫度傳感器、攝像頭等；

Home Assistant集成：通過HTTP API接入智能家居系統(tǒng)；

自定義設(shè)備擴(kuò)展：提供完整的設(shè)備定義和注冊(cè)框架。

詳見：

python版本的小智ai

小智Android端

審核編輯 黃宇