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

無垠的廣袤制作

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

原貼地址：

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

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

目錄

一、開箱

1.1包裝

1.2開發(fā)板

二、開發(fā)板介紹

2.1功能特點

2.2技術參數(shù)

2.3適應場景

2.4原理圖

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

四、效果

五、MCP 介紹

六、準備工作

七、小智 MCP 接入 HA

八、補充介紹：小智 MCP 啟動器和小智 AI 客戶端

01開箱

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

包裝

外層防靜電袋，保護精密器件在運輸途中遠離摩擦靜電影響；

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

開發(fā)板

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

02開發(fā)板介紹

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

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

功能特點

離線語音交互

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

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

靈活供電模式

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

電池供電設計，滿足移動場景需求。

輕量級硬件配置

小尺寸板載設計，易于集成到各類設備中。

2W/8Ω 揚聲器提供清晰音效輸出。

便捷開發(fā)與配置

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

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

全新模組連接方案

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

低成本快速落地

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

高兼容性

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

技術參數(shù)

智能家居控制

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

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

教育/兒童玩具

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

工業(yè)設備交互

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

原理圖

電源管理

供電

Sound

麥克風

主控

外設

源碼及固件詳見：

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

固件上傳方案詳見：

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

03上電及配網(wǎng)

上電

檢查麥克風、揚聲器、屏幕是否已連接；

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

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

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

配網(wǎng)

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

對麥克風說：【你好小安】

回復：我在

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

回復：進入配網(wǎng)模式，請使用安信可小程序或App 進行配網(wǎng)

小程序

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

選擇 AI 硬件智能體 ，點擊 添加設備 - 掃描設備 ；

點擊連接 BL602_XZ_V1.0_XXXXXXXXXX 設備；

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

回復：連網(wǎng)中

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

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

小智 AI 界面

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

網(wǎng)頁端，點擊 控制臺 - 新建智能體 - 輸入相應的個性化配置；

點擊添加設備 - 輸入播報的 6 位數(shù)字 - 手動復位設備；

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

語音喚醒：你好小安

回復：我在

之后便可進行連續(xù)對話。

04效果

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

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

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

查看視頻?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) 是一個開放協(xié)議，用于標準化應用程序如何向 LLM 提供上下文。

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

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

詳見：

MCP中文簡介 – MCP 中文站（Model Context Protocol 中文）

Model Context Protocol

MCP - python-sdk

06準備工作

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

Home Assistant 安裝

1.安裝 Docker 容器

2.本地下載并部署 EMQX 平臺

3.部署 HomeAssistant 智能家居平臺

詳見：

【BW21-CBV-Kit 開發(fā)套件測評】OLED藍牙溫濕度計與Home Assistant連接藍牙溫濕度計 DIY

HACS 部署

在 Docker 安裝 HomeAssistant 的基礎上，部署 HACS 應用商店。

shell_command服務

復制代碼到 HA 配置文件 configuration.yaml

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

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

action: shell_command.update_hacs_china

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

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

參考：

hacs-china

hacs-china 極速版

07小智 MCP 接入 HA

原理

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

參數(shù)

XIAOZHI_MCP_ENDPOINT

小智 MCP 接入點，登錄 小智 官方服務器獲??；

HA_MCP_ENDPOINT

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

API_ACCESS_TOKEN

長效 API 令牌，訪問 Home Assistant 賬戶配置文件設置，進入 安全 標簽，創(chuàng)建長期訪問令牌。

詳見：

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

安裝

在 Home Assistant 已安裝 HACS 的基礎上

打開HACS, 點擊 Custom repositories

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

Category 選擇 Integration 。

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

設置 - 右上角 更多 選項 - 重啟 Home Assistant ；

進入HACS，可見 MCP Server for Xiaozhi 已下載和安裝；

配置

設置 - 設備與服務 - 添加集成 - 搜索 MCP 安裝 MCP Server for Xiaozhi ；

填寫小智接入點地址 - 提交 - 添加成功。

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

在 設置 - 語音助手 選項下開啟 HA 語音助手；

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

詳見：

Homeassistant MCP server for 小智AI

08補充介紹：小智 MCP 啟動器和小智 AI 客戶端

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

小智 AI MCP 啟動器

參考：

小智AI配置MCP接入點使用說明

可視化xiaozhi接入mcp

小智 AI 客戶端

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

介紹

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

IoT 功能

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

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

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

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

自定義設備擴展：提供完整的設備定義和注冊框架。

詳見：

python版本的小智ai

小智Android端

審核編輯 黃宇