Merge pull request #121

Optimize default prompts to significantly reduce tokens usage.

Author: luuquangvu

ac_mode_and_fan_control_full_llm.yaml

@@ -75,31 +75,31 @@ blueprint:
             text:
               multiline: true
           default: |-
-            Mandatory. Provide AC names to control. Use semicolons (;) to separate multiple names.
+            Required: AC names to control. Separate multiple with semicolon (;).
         hvac_mode_prompt:
           name: HVAC Mode Prompt
           description: The prompt which will be used for the LLM can provide the AC mode.
           selector:
             text:
               multiline: true
           default: |-
-            Set AC mode (auto, cool, heat, dry, fan_only, off). Include ONLY if explicitly requested. Return error if unsupported; do not guess.
+            AC mode (`auto`, `cool`, `heat`, `dry`, `fan_only`, `off`). Only if requested. Error if unsupported; no guessing.
         temperature_prompt:
           name: Temperature Prompt
           description: The prompt which will be used for the LLM can provide the target temperature.
           selector:
             text:
               multiline: true
           default: |-
-            Target temperature as a number (e.g. 24). Convert F to C if needed. Omit units (C/F). Include ONLY for explicit requests.
+            Target temp as number (e.g. `24`). Convert F to C. No units. Only if requested.
         fan_mode_prompt:
           name: Fan Mode Prompt
           description: The prompt which will be used for the LLM can provide the fan speed/mode of the AC.
           selector:
             text:
               multiline: true
           default: |-
-            Set fan speed (auto, low/1, lowmid/2, mid/3, highmid/4, high/5). Map to the closest supported mode. Include ONLY if requested. Error if no match; do not guess.
+            Fan speed (`auto`, `low`/`1`, `lowmid`/`2`, `mid`/`3`, `highmid`/`4`, `high`/`5`). Map to closest. Only if requested. No guessing.
 mode: parallel
 max_exceeded: silent
 description: Controls mode, temperature, and fan speed for air conditioners. Supports auto, cool, heat, dry, and fan_only modes.

advanced_google_search_full_llm.yaml

@@ -56,15 +56,15 @@ blueprint:
             text:
               multiline: true
           default: |-
-            Mandatory. Search query. Silence-correct misspellings if likely intended. Do not ask for clarification.
+            Required: Search query. Silence-correct misspellings. No clarification.
         language_prompt:
           name: Language Prompt
           description: The prompt which will be used for the LLM can provide the language for the query.
           selector:
             text:
               multiline: true
           default: |-
-            Mandatory. Language tag (e.g. vi-VN, en-US). Must match user language.
+            Required: Language tag (e.g. `en-US`). Match user language.
 mode: parallel
 max_exceeded: silent
 description: Searches Google to retrieve real-time information, facts, or answers from the web. Use when local knowledge is insufficient.

advanced_youtube_search_full_llm.yaml

@@ -71,15 +71,15 @@ blueprint:
             text:
               multiline: true
           default: |-
-            Mandatory. Search query. Silence-correct misspellings. For results, use ordinal numbers for selection; omit Media IDs. Confirm before proceeding if query is ambiguous.
+            Required: Search query. Silence-correct misspellings. Use ordinals for results, omit Media IDs. Confirm if ambiguous.
         page_token_prompt:
           name: Page Token Prompt
           description: The prompt which will be used for the LLM can provide the page token to get additional videos that could be obtained.
           selector:
             text:
               multiline: true
           default: |-
-            Optional. Use to fetch more videos if initial results are unsatisfactory.
+            Optional: Token to fetch more videos.
 mode: parallel
 max_exceeded: silent
 description: Searches YouTube for videos and returns a list of matching results with titles and descriptions. Use to find specific content or playlists.

calendar_events_lookup_full_llm.yaml

@@ -51,31 +51,31 @@ blueprint:
             text:
               multiline: true
           default: |-
-            Mandatory. 'daily' for full days/long periods; 'hourly' for partial days/specific times. Response must only include day of week and start date.
+            Required: `daily` (full days) or `hourly` (partial). Output only day of week and start date.
         time_period_length_prompt:
           name: Time Period Length Prompt
           description: The prompt which will be used for the LLM can provide the length of the period.
           selector:
             text:
               multiline: true
           default: |-
-            Mandatory. Length in days (if daily) or hours (if hourly). E.g. 1 (today), 7 (week), 6 (afternoon).
+            Required: Length in days/hours (e.g. 1, 7, 6).
         date_prompt:
           name: Date Prompt
           description: The prompt which will be used for the LLM can provide the start date for the events period.
           selector:
             text:
               multiline: true
           default: |-
-            Mandatory. Start date (YYYY-MM-DD). Default to today if unspecified. For "night", use next day unless current time < 05:00:00.
+            Required: Start date (`YYYY-MM-DD`). Default today. `Night` = next day if >= `05:00:00`.
         time_prompt:
           name: Time Prompt
           description: The prompt which will be used for the LLM can provide the start time for the events period.
           selector:
             text:
               multiline: true
           default: |-
-            Mandatory. Start time (HH:MM:SS). Full day = 00:00:00. Morning = 06:00:00, Afternoon = 12:00:00, Evening = 18:00:00, Night = 00:00:00.
+            Required: Start time (`HH:MM:SS`). Morning=`06:00:00`, Afternoon=`12:00:00`, Evening=`18:00:00`, Night/Full day=`00:00:00`.
 mode: parallel
 max_exceeded: silent
 description: Retrieves upcoming or past calendar events for a specific time period. Useful for checking schedules and appointments.

camera_snapshot_full_llm.yaml

@@ -100,7 +100,7 @@ blueprint:
             text:
               multiline: true
           default: |-
-            Mandatory. Camera friendly name. If unclear, determine from context or suggest. For multiple cameras, use separate tool calls. Returns local image path.
+            Required: Camera friendly name. Multiple cameras = multiple calls. Returns local image path.
 mode: parallel
 max_exceeded: silent
 description: Captures and saves a camera snapshot. Returns the local file path for analysis or messaging tools. Useful for visual verification of a scene.

control_music_full_llm.yaml

@@ -82,25 +82,25 @@ blueprint:
               multiline: true
               multiple: false
           default: |-
-            Mandatory. Values: track (single/list), album, artist, playlist, radio. Default to 'track' for genre/mood requests and list matching songs in media_id.
+            Required: track, album, artist, playlist, radio. Default: `track` for genre/mood/list.
         artist_prompt:
           name: Artist Prompt
           description: The prompt that the LLM will use to provide the artist.
           selector:
             text:
               multiline: true
               multiple: false
-          default:
-            Requested artist or track artist. Empty string if unknown or multiple artists requested.
+          default: |-
+            Requested artist(s). Empty if unknown/multiple.
         album_prompt:
           name: Album Prompt
           description: The prompt that the LLM will use to provide the album.
           selector:
             text:
               multiline: true
               multiple: false
-          default:
-            Requested album. Empty string if unknown or multiple albums requested.
+          default: |-
+            Requested album. Empty if unknown/multiple.
         media_id_prompt:
           name: Media ID Prompt
           description: The prompt that the LLM will use to provide the media_id.
@@ -109,49 +109,43 @@ blueprint:
               multiline: true
               multiple: false
           default: |-
-            Mandatory. Specific name(s).
-            - Tracks/Albums: Provide names (semicolon separated). If ambiguous, use "Artist - Track".
-            - Artists/Playlists/Radio: Provide exact name. Remove "playlist" keyword (e.g., "Favorites").
+            Required: Specific name(s). Tracks/Albums: semicolon separated. Artists/Playlists/Radio: exact name (omit `playlist` keyword).
         media_description_prompt:
           name: Media Description Prompt
           description: The prompt that the LLM will use to provide the media description.
           selector:
             text:
               multiline: true
               multiple: false
-          default:
-            The "media_description" key is used to describe the media which
-            will be played. This can be taken from the voice command query, but it
-            should be only the part which is relevant for the media. So if the voice
-            request is "Play the best Queen songs on the living room player" the value
-            for "media_description" should be "the best Queen songs"
+          default: |-
+            Required: Extracted media description from query (e.g. `the best Queen songs`). Omit area/player details.
         area_prompt:
           name: Area Prompt
           description: The prompt that the LLM will use to provide the area.
           selector:
             text:
               multiline: true
               multiple: false
-          default:
-            Requested area(s). Default to the area of the initiating device. Omit if player is specified unless both are explicitly named.
+          default: |-
+            Requested area(s). Default to initiating device area. Omit if player specified.
         media_player_prompt:
           name: Media Player Prompt
           description: The prompt that the LLM will use to provide the media player.
           selector:
             text:
               multiline: true
               multiple: false
-          default:
-            Target Music Assistant media_player entity_id(s). Use ONLY if specifically mentioned.
+          default: |-
+            Target Music Assistant `media_player` entity_id(s). ONLY if explicitly mentioned.
         shuffle_prompt:
           name: Shuffle Prompt
           description: The prompt that the LLM will use to determine whether to turn on shuffle or not.
           selector:
             text:
               multiline: true
               multiple: false
-          default:
-            Mandatory. Boolean. Set true ONLY if the user specifically mentions shuffling. Otherwise false. Do not guess.
+          default: |-
+            Required: `true` or `false`. `true` ONLY if shuffling explicitly requested. No guessing.
     addition_conditions_actions:
       name: Additional actions
       icon: mdi:wrench

create_calendar_event_full_llm.yaml

@@ -63,47 +63,47 @@ blueprint:
             text:
               multiline: true
           default: |-
-            Mandatory. Subject or title of the event.
+            Required: Event subject/title.
         description_prompt:
           name: Description Prompt
           description: Detailed description of the event.
           selector:
             text:
               multiline: true
           default: |-
-            Optional. Full details of the event.
+            Optional: Event details.
         start_date_time_prompt:
           name: Start Time Prompt
           description: Start date and time for timed events.
           selector:
             text:
               multiline: true
           default: |-
-            Use ONLY for timed events (YYYY-MM-DD HH:MM:SS). Excludes start_date.
+            For timed events only (`YYYY-MM-DD HH:MM:SS`). No `start_date`.
         end_date_time_prompt:
           name: End Time Prompt
           description: End date and time for timed events.
           selector:
             text:
               multiline: true
           default: |-
-            Mandatory for timed events. Default: start + 2h. Excludes end_date.
+            Required for timed events. Default: start + 2h. No `end_date`.
         start_date_prompt:
           name: Start Date Prompt
           description: Start date for all-day events.
           selector:
             text:
               multiline: true
           default: |-
-            Use ONLY for all-day events (YYYY-MM-DD). Excludes start_date_time.
+            For all-day events only (`YYYY-MM-DD`). No `start_date_time`.
         end_date_prompt:
           name: End Date Prompt
           description: End date for all-day events.
           selector:
             text:
               multiline: true
           default: |-
-            Mandatory for all-day events. Default: start + 1 day. Excludes end_date_time.
+            Required for all-day events. Default: start + 1d. No `end_date_time`.
 mode: queued
 max: !input simultaneous
 max_exceeded: silent

date_lookup_and_conversion_full_llm.yaml

@@ -48,23 +48,23 @@ blueprint:
             text:
               multiline: true
           default: |-
-            Mandatory. 's2l' (Solar to Lunar) or 'l2s' (Lunar to Solar). Response must include: day of week, both dates, and days remaining/elapsed.
+            Required: `s2l` (Solar->Lunar) or `l2s` (Lunar->Solar). Output day of week, both dates, days diff.
         date_prompt:
           name: Date Prompt
           description: The prompt which will be used for the LLM can provide the input date for the conversion.
           selector:
             text:
               multiline: true
           default: |-
-            Mandatory. Date (YYYY-MM-DD). If year unspecified, use current year. Use today/tomorrow as needed.
+            Required: Date (`YYYY-MM-DD`). If no year, use current.
         leap_month_prompt:
           name: Leap Month Prompt
           description: The prompt which will be used for the LLM can provide the leap month for the conversion.
           selector:
             text:
               multiline: true
           default: |-
-            Optional for l2s. 'true' for leap month, 'false' for regular. Do not use for s2l.
+            Optional for `l2s`: `true`=leap month, `false`=regular. Skip for `s2l`.
 mode: parallel
 max_exceeded: silent
 description: Converts dates between Solar and Lunar calendars, looks up auspicious days, and determines the day of the week.

device_control_timer_full_llm.yaml

@@ -87,23 +87,23 @@ blueprint:
             text:
               multiline: true
           default: |-
-            Mandatory. Provide device names to control. Use semicolons (;) to separate multiple names.
+            Required: Device names. Semicolon-separated.
         control_prompt:
           name: Control Prompt
           description: The prompt which will be used for the LLM can provide the action.
           selector:
             text:
               multiline: true
           default: |-
-            Mandatory. Action: 'true' (ON), 'false' (OFF). Do not guess.
+            Required: Action `true` (ON), `false` (OFF). No guessing.
         timer_prompt:
           name: Timer Prompt
           description: The prompt which will be used for the LLM can provide the delay of action.
           selector:
             text:
               multiline: true
           default: |-
-            Mandatory. Delay as HH:MM:SS. Calculate from current time if a target time is specified. Relative to now.
+            Required: Delay as `HH:MM:SS`. Calculate from now if target specified.
 mode: parallel
 max_exceeded: silent
 description: Simple one-time timer for turning devices on or off after a delay. Use for basic "turn off in X minutes" requests.

device_location_lookup_full_llm.yaml

@@ -81,7 +81,7 @@ blueprint:
             text:
               multiline: true
           default: |-
-            Mandatory. Provide names of tracked devices (phones, tags, etc.). Use semicolons (;) if multiple. If none specified, provide all relevant tracked devices. Prompt to ring if supported.
+            Required: Tracked device names (semicolon-separated). Ring if supported.
 mode: parallel
 max_exceeded: silent
 description: Retrieves real-time device locations (phones, tags, etc.) within the home. Use to find missing devices or check room presence.