輔助元件（Helper）實作：七種型別，從建立到接進自動化全部做完

charles

輔助元件是 Home Assistant 裡「沒有實體硬體對應」的虛擬實體。它不接任何東西，但它讓你的自動化可以被調整、被暫停、被家人操作。這一篇把七種最常用的型別從頭做一次，每一種都做到「有一個會動的自動化」為止。



這篇不需要買任何東西，也不需要動到硬體。你只要有一台跑得起來的 Home Assistant。

這篇用的版本

寫這篇時的穩定版是 Home Assistant 2026.9.3。畫面路徑與 YAML 語法都以這一版為準。

自動化 YAML 用的是 2026 年的新語法：triggers / conditions / actions 都是複數，觸發器寫 - trigger: state（不是舊的 - platform: state），動作寫 action:（不是舊的 service:）。舊語法目前還能跑，但新建的東西沒有理由用舊的。

步驟 0：先找到輔助元件在哪裡

左下角 設定 → 裝置與服務 → 畫面最上方那一排分頁，最右邊是 輔助元件。

你會看到一個清單（全新的機器是空的），右下角有一顆藍色的 + 建立輔助元件 按鈕。按下去會跳出一個很長的型別清單。

看不到「輔助元件」這個分頁 → 你的帳號不是管理員。到 設定 → 人員 → 你的帳號，確認管理員那個開關是開的。

清單裡大致分兩群，先認得出來後面會省很多時間：

• 輸入型（切換、下拉選單、數字、文字、日期／時間、計時器、計數器、排程）：由你或自動化寫值進去，它只負責把值記住
  
• 轉換型（門檻、導數、篩選、群組、歷史統計、最小／最大、範本、時段、趨勢、耗用計量⋯⋯）：吃一個既有的實體，吐出一個新的實體
  

下面七步涵蓋最常用的六個輸入型和一個轉換型。

步驟 1：做一個切換（Toggle）當總開關

這是最常用的一種。它不控制任何東西，就是一個旗標。

+ 建立輔助元件 → 選 切換 → 名稱填 度假模式 → 圖示可以填 mdi:airplane → 建立。

你會看到清單裡多一列「度假模式」，右邊有一個可以按的開關。

接著要知道它的實體 ID，後面寫 YAML 都靠這個。到 開發者工具 → 狀態，在「實體」欄位打 input_boolean。

你會看到一列長這樣：

1. 實體                          狀態
2. input_boolean.du_jia_mo_shi   off

複製代碼

⚠ 你的實體 ID 幾乎一定跟我這裡不一樣。 Home Assistant 會把中文名稱轉成拼音，不同版本、不同名字轉出來的結果都不同。下面每一段 YAML 裡的實體 ID，都要換成你自己在這個畫面上看到的那一串。

搜尋 input_boolean 一列都沒有 → 輔助元件沒有建立成功，回上一步重來。

步驟 2：把這個切換接進自動化

光有開關沒有用，要有東西讀它。

到 設定 → 自動化與場景 → 右下角 + 建立自動化 → 從頭開始建立 → 右上角三個點 → 以 YAML 編輯。

把預設內容整個刪掉，貼上這一段（這是單一一條自動化的格式，因為 UI 編輯器一次只編一條）：

1. alias: 天黑開客廳燈
2. description: 度假模式開著的時候不要動作
3. mode: single
4. triggers:
5.   - trigger: sun
6.     event: sunset
7.     offset: "-00:15:00"
8. conditions:
9.   - condition: state
10.     entity_id: input_boolean.du_jia_mo_shi
11.     state: "off"
12. actions:
13.   - action: light.turn_on
14.     target:
15.       entity_id: light.ke_ting
16.     data:
17.       brightness_pct: 60

複製代碼

存檔 → 取名 → 儲存。

你會看到自動化清單裡多一列「天黑開客廳燈」，右邊的開關是開著的。

存檔時跳出紅色的「訊息格式錯誤」 → 縮排錯了。YAML 對空格很敏感，一律用空白鍵，不要用 Tab。錯誤訊息會告訴你第幾行。

怎麼驗證條件真的有生效：把「度假模式」打開，然後回到這條自動化，右上角三個點 → 執行。

• 度假模式開著時按執行：燈會亮。因為手動執行會跳過條件
  
• 要驗條件，改看追蹤：三個點 → 追蹤 → 最近一次真正被觸發的紀錄
  

你會看到追蹤畫面上那條流程線在 conditions 這一格就停住並標成灰色，旁邊寫著條件不成立。看不到灰色的中斷點、流程一路走到底，代表條件那段的實體 ID 打錯了 —— 實體不存在時 state 條件的結果是「不成立」，但有些情況會被當成錯誤略過，去設定 → 系統 → 日誌搜尋那串實體 ID 就會看到警告。

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

登入繼續閱讀使用 Google 登入