教 Assist 聽懂你家的說法：自訂語句從資料夾建到講得動

charles · 發表於 2026-9-21 08:39:21

這篇的內容（9 段）

步驟 0：確認 Assist 本身會動
步驟 1：把實體公開給 Assist
查法一：看你的語音助理設定
步驟 6：套用——不用重啟
步驟 8：讓語句帶參數
步驟 9：中文特有的三個問題
2. 太短的語句會誤觸發
3. 參數前後要有明確的字
怎麼決定要教哪些語句

這一篇做完，你可以對 Home Assistant 說「我要睡了」「等一下要出門」「現在有幾盞燈開著」，而且它會真的做事或真的回答你。整條鏈路不用寫程式，也不用重啟。

Assist 是 Home Assistant 內建的語音／文字助理。它本來就聽得懂「開客廳的燈」這種標準說法，但你家一定有些自己的講法它不懂：

「我要睡了」
「等一下要出門」
「現在有幾盞燈開著」

這些可以自己教。要教的有三個東西：

語句（Sentence） — 你會講的那句話
意圖（Intent） — 那句話代表的「意思」，你自己給它取一個英文名字
意圖腳本（intent_script） — 對到這個意思之後，要做什麼、要回你什麼

流程是：聽到語句 → 對到意圖 → 執行動作 → 回話。

步驟 0：確認 Assist 本身會動

先別急著寫檔案。點畫面右上角的對話圖示（在側邊欄最上方 Home Assistant 標誌旁邊，長得像一顆星星加對話框），打字輸入「開客廳的燈」按 Enter。

你會看到兩種結果之一：

它回「好的」而且燈真的亮了 → 往下走
它回「找不到名為客廳的裝置」之類 → 先做步驟 1

完全找不到那個對話圖示，代表你的 `configuration.yaml` 不是預設設定。加一行 `assist_pipeline:` 在最上層，重啟一次。

步驟 1：把實體公開給 Assist

Home Assistant 的每一個實體都是 opt-in 的——沒有明確公開的實體，Assist 完全看不到，所以講它的名字一定對不上。這是預設就這樣，為了避免門鎖、車庫門被人在門外喊一聲就打開。

到 設定 → 語音助理 → 公開 分頁。

你會看到一份已公開的實體清單。按公開實體可以一次加多個。

只公開你真的會用嘴巴講的那些。 公開得越多，比對要掃的名字越多、反應越慢；如果你的對話代理換成大型語言模型，那還會直接變成每次請求的成本。

公開完回步驟 0 再講一次「開客廳的燈」。這次應該會成功。

步驟 2：查出你的語言代碼（這一關不過，後面全部白做）

這是整篇最容易卡住的地方，而且卡住的時候一點症狀都沒有。

自訂語句檔要放在 `config/custom_sentences/<語言代碼>/` 底下。Home Assistant 在處理一句話時，只會去載入跟當下請求的語言代碼完全對得上的那個資料夾。對不上的話——資料夾整個被略過，沒有錯誤、沒有警告、日誌一個字都沒有，你講什麼都沒反應。

麻煩的是中文有兩套代碼在流通：

Home Assistant 核心用的是 zh-Hant（繁體）／zh-Hans（簡體）
官方語句倉庫用的是 zh-TW ／ zh-CN ／ zh-HK

所以「資料夾要叫 `zh-tw`」這個說法對某些安裝是對的、對某些是錯的，而且沒辦法從外觀分辨。

查法一：看你的語音助理設定

到 設定 → 語音助理，點你在用的那個助理（預設叫「Home Assistant」），你會看到一個語言欄位。記下它顯示的語言。

查法二（更直接）：用句子剖析器實測

到 設定 → 工具 → Assist。這是一個只比對不執行的測試工具，隨便亂試都不會把家裡的燈打開。

上面有一個語言下拉選單。你會看到裡面的中文選項實際寫成什麼。把它選成你要用的那個，下面輸入「開客廳的燈」。

以下還有約 80% 的內容
登入後即可閱讀完整教學

登入繼續閱讀使用 Google 登入

		自動登入	找回密碼
密碼			立即註冊

教 Assist 聽懂你家的說法：自訂語句從資料夾建到講得動

延伸閱讀

瀏覽過的版塊