{"record":{"id":"5bdc2a20ac9a4074","repo":"home-assistant/core","slug":"intent-failed","errorCode":"intent-failed","errorMessage":"Unexpected error during intent recognition","messagePattern":"Unexpected error during intent recognition","errorType":"exception","errorClass":"IntentRecognitionError","httpStatus":null,"severity":"error","filePath":"homeassistant/components/assist_pipeline/pipeline.py","lineNumber":1329,"sourceCode":"                    if tts_input_stream and self._streamed_response_text:\n                        tts_input_stream.put_nowait(None)\n\n                if agent_id == conversation.HOME_ASSISTANT_AGENT:\n                    # Check if all targeted entities were in the same area as\n                    # the satellite device.\n                    # If so, the satellite should respond with an acknowledge beep\n                    # instead of a full response.\n                    all_targets_in_satellite_area = (\n                        self._get_all_targets_in_satellite_area(\n                            conversation_result.response,\n                            self._satellite_id,\n                            self._device_id,\n                        )\n                    )\n\n        except Exception as src_error:\n            _LOGGER.exception(\"Unexpected error during intent recognition\")\n            raise IntentRecognitionError(\n                code=\"intent-failed\",\n                message=\"Unexpected error during intent recognition\",\n            ) from src_error\n\n        _LOGGER.debug(\"conversation result %s\", conversation_result)\n\n        self.process_event(\n            PipelineEvent(\n                PipelineEventType.INTENT_END,\n                {\n                    \"processed_locally\": processed_locally,\n                    \"intent_output\": conversation_result.as_dict(),\n                },\n            )\n        )\n\n        if conversation_result.continue_conversation:\n            self._conversation_data.continue_conversation_agent = agent_id","sourceCodeStart":1311,"sourceCodeEnd":1347,"githubUrl":"https://github.com/home-assistant/core/blob/58a3fdb3ea0538617f0a07efcfba6294de64fd59/homeassistant/components/assist_pipeline/pipeline.py#L1311-L1347","documentation":"IntentRecognitionError with code intent-failed wraps any unexpected exception raised while the conversation agent processes the utterance (async_converse or the surrounding handling in recognize_intent). The original traceback is logged with 'Unexpected error during intent recognition' before rethrowing, so the log carries the true cause.","triggerScenarios":"The selected conversation agent raises during processing: an LLM integration's API call fails unexpectedly, the default intent handler hits a bug in an intent/entity action, or response post-processing (_get_all_targets_in_satellite_area and similar) throws.","commonSituations":"OpenAI/Google/Ollama agent hitting a malformed API response or unhandled client error, Ollama server down with an error type not translated to HomeAssistantError, custom conversation agents raising arbitrary exceptions, or bugs in entity actions invoked by intents.","solutions":["Read the chained traceback in the Home Assistant log — it identifies the failing integration and line.","If it is an LLM backend failure, verify the backend is reachable and the API key/model config is valid, then retry.","Update or fix the custom agent/integration that the traceback points to.","As a workaround, switch the pipeline to the default Home Assistant conversation agent to isolate the fault."],"exampleFix":null,"handlingStrategy":"try-catch","validationCode":null,"typeGuard":null,"tryCatchPattern":"from homeassistant.components.assist_pipeline.error import IntentRecognitionError\ntry:\n    await pipeline_job.run()\nexcept IntentRecognitionError as err:\n    if err.code == \"intent-failed\":\n        _LOGGER.error(\"Intent failed: %s\", err.__cause__)  # true cause is chained","preventionTips":["Keep LLM backend integrations updated; many unexpected exceptions are fixed client bugs.","Read the logged traceback 'Unexpected error during intent recognition' before changing config.","Isolate flaky agents by switching the pipeline to the default agent temporarily."],"tags":["assist-pipeline","intent","conversation","debugging"],"backgroundTag":null,"analyzedSha":"58a3fdb3ea0538617f0a07efcfba6294de64fd59","analyzedAt":"2026-08-14T20:54:38.818Z","schemaVersion":2},"datasetVersion":"2026-08-15T17:31:12.345Z"}