Add ask question to release notes #39792
Conversation
|
It seems that this PR is targeted against an incorrect branch. Documentation updates which apply to our current stable release should target the |
✅ Deploy Preview for home-assistant-docs ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
|
Caution Review failedThe pull request is closed. 📝 WalkthroughWalkthroughThe updates introduce a new Home Assistant blueprint for asking yes/no questions via voice assistants, along with enhanced release notes. The release notes now include detailed descriptions, a screenshot, a demonstration video, a blueprint import badge, and example YAML. The blueprint supports advanced response recognition and retry logic for conversational automations. Changes
Sequence Diagram(s)sequenceDiagram
participant Automation
participant VoiceAssistant
participant User
Automation->>VoiceAssistant: Ask yes/no question (via assist_satellite.ask_question)
VoiceAssistant->>User: Announces question (optional preannouncement)
User-->>VoiceAssistant: Responds (various yes/no/other phrases)
VoiceAssistant->>Automation: Returns response (matched to yes/no/other)
alt Response is "yes"
Automation->>VoiceAssistant: Execute "yes" actions and announce positive answer
else Response is "no"
Automation->>VoiceAssistant: Execute "no" actions and announce negative answer
else Response unrecognized and retries left
Automation->>VoiceAssistant: Repeat question (increment retry count)
else Retries exhausted
Automation->>VoiceAssistant: Execute "other" actions and announce fallback answer
end
📜 Recent review detailsConfiguration used: CodeRabbit UI 📒 Files selected for processing (1)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. 🪧 TipsChatThere are 3 ways to chat with CodeRabbit:
SupportNeed help? Create a ticket on our support page for assistance with any issues or questions. Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments. CodeRabbit Commands (Invoked using PR comments)
Other keywords and placeholders
CodeRabbit Configuration File (
|
There was a problem hiding this comment.
Actionable comments posted: 2
🧹 Nitpick comments (3)
source/blueprints/blog/2025-07/ask_yes_no_question.yaml (1)
2-2: Double/in blueprint name looks like a typoThe public-facing name will render with a double slash (“Yes//No”), which feels accidental and might confuse users.
- name: Ask a Yes//No question + name: Ask a Yes/No questionsource/_posts/2025-07-02-release-20257.markdown (2)
112-112: Trailing whitespace triggers markdown-lintStatic analysis (
MD009) already flagged this. Trim to keep the linter green.-This blueprint allows you to focus on what you want to do if you answer positively or negatively to any question your voice assistant will ask, the blueprint supports 50 different ways of saying "Yes" and "No". ␠ +This blueprint allows you to focus on what you want to do if you answer positively or negatively to any question your voice assistant will ask; the blueprint supports 50 different ways of saying "Yes" and "No".
110-110: Bare URL violatesMD034Embed the URL in markdown to avoid a bare link warning:
-{% my blueprint_import badge blueprint_url="https://www.home-assistant.io/blueprints/blog/2025-07/ask_yes_no_question.yaml" %} +{% my blueprint_import 'Ask a Yes/No question' 'https://www.home-assistant.io/blueprints/blog/2025-07/ask_yes_no_question.yaml' %}
📜 Review details
Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro
Cache: Disabled due to data retention organization setting
Knowledge Base: Disabled due to data retention organization setting
⛔ Files ignored due to path filters (1)
source/images/blog/2025-07/ask_question.pngis excluded by!**/*.png
📒 Files selected for processing (2)
source/_posts/2025-07-02-release-20257.markdown(1 hunks)source/blueprints/blog/2025-07/ask_yes_no_question.yaml(1 hunks)
🧰 Additional context used
🪛 markdownlint-cli2 (0.17.2)
source/_posts/2025-07-02-release-20257.markdown
110-110: Bare URL used
(MD034, no-bare-urls)
112-112: Trailing spaces
Expected: 0 or 2; Actual: 1
(MD009, no-trailing-spaces)
🔇 Additional comments (1)
source/blueprints/blog/2025-07/ask_yes_no_question.yaml (1)
216-218: Verify templating of the sentence lists
sentences: "{{yes_sentences}}"(and the same forno_sentences) returns a Python list at runtime.
While recent HA versions accept non-string template output, older ones serialise it to a string, breaking phrase matching.Please confirm on a live instance ≥ 2025.6 that
assist_satellite.ask_questionreceives an actual list.
If not, convert explicitly:sentences: "{{ yes_sentences | list }}"
There was a problem hiding this comment.
Pull Request Overview
This PR completes the release notes for the 2025.7 release by adding the new “Ask Question” blueprint and updating the blog post with an image, blueprint badge, and demo video.
- Introduces a new blueprint (
ask_yes_no_question.yaml) for asking closed Yes/No questions via Assist with customizable responses. - Updates the July release blog post to include the blueprint badge, screenshot, example YAML, and demo video.
Reviewed Changes
Copilot reviewed 2 out of 3 changed files in this pull request and generated 1 comment.
| File | Description |
|---|---|
| source/blueprints/blog/2025-07/ask_yes_no_question.yaml | Adds a new Ask Yes/No question blueprint with inputs, variables, and sequence logic. |
| source/_posts/2025-07-02-release-20257.markdown | Embeds screenshot, blueprint badge, example YAML, and demo video into the release notes. |
Comments suppressed due to low confidence (2)
source/_posts/2025-07-02-release-20257.markdown:112
- [nitpick] This sentence is a run-on. Consider splitting into two sentences for readability, for example:
This blueprint lets you focus on what happens when you reply positively or negatively to a question. It supports 50 different ways of saying "Yes" and "No".
This blueprint allows you to focus on what you want to do if you answer positively or negatively to any question your voice assistant will ask, the blueprint supports 50 different ways of saying "Yes" and "No".
source/_posts/2025-07-02-release-20257.markdown:118
- [nitpick] Add the missing article for clarity:
how to ask a questioninstead ofhow to ask question.
In case you want to dive deeper into conversation building, here is an example on how to ask question and process the different answers:
Co-authored-by: Copilot <[email protected]>
|
It seems that this PR is targeted against an incorrect branch. Documentation updates which apply to our current stable release should target the |
Proposed change
Complete the section related to
ask_questionon the release note for the 2025.7 release.Type of change
currentbranch).currentbranch).nextbranch).nextbranch).Additional information
Checklist
currentbranch.nextbranch.Summary by CodeRabbit