{"record":{"id":"77b115150f66295c","repo":"home-assistant/core","slug":"intent-not-supported","errorCode":"intent-not-supported","errorMessage":"Intent recognition engine {engine} is not found","messagePattern":"Intent recognition engine (.+?) is not found","errorType":"exception","errorClass":"IntentRecognitionError","httpStatus":null,"severity":"error","filePath":"homeassistant/components/assist_pipeline/pipeline.py","lineNumber":1069,"sourceCode":"                raise IntentRecognitionError(\n                    code=\"intent-agent-not-found\",\n                    message=(\n                        f\"Intent recognition engine\"\n                        f\" {self._conversation_data.continue_conversation_agent}\"\n                        \" asked for follow-up but is no longer found\"\n                    ),\n                )\n            self._intent_agent_only = True\n\n        else:\n            agent_info = conversation.async_get_agent_info(\n                self.hass,\n                self.pipeline.conversation_engine or conversation.HOME_ASSISTANT_AGENT,\n            )\n\n            if agent_info is None:\n                engine = self.pipeline.conversation_engine or \"default\"\n                raise IntentRecognitionError(\n                    code=\"intent-not-supported\",\n                    message=f\"Intent recognition engine {engine} is not found\",\n                )\n\n        self.intent_agent = agent_info\n\n    async def recognize_intent(\n        self,\n        intent_input: str,\n        conversation_id: str,\n        conversation_extra_system_prompt: str | None,\n    ) -> tuple[str, bool]:\n        \"\"\"Run intent recognition portion of pipeline.\n\n        Returns (speech, all_targets_in_satellite_area).\n        \"\"\"\n        if self.intent_agent is None or self._conversation_data is None:\n            raise RuntimeError(\"Recognize intent was not prepared\")","sourceCodeStart":1051,"sourceCodeEnd":1087,"githubUrl":"https://github.com/home-assistant/core/blob/58a3fdb3ea0538617f0a07efcfba6294de64fd59/homeassistant/components/assist_pipeline/pipeline.py#L1051-L1087","documentation":"IntentRecognitionError with code intent-not-supported is raised in prepare_recognize_intent when async_get_agent_info cannot resolve the pipeline's configured conversation_engine (or the default HOME_ASSISTANT_AGENT if none set). The pipeline names a conversation engine that is not registered, so intent recognition cannot be prepared.","triggerScenarios":"A pipeline whose conversation_engine references a missing conversation agent entity, or the default conversation integration itself failed to load, and a run enters the INTENT stage.","commonSituations":"Conversation agent entity deleted or renamed while a pipeline still points at it; the default conversation integration disabled; a custom conversation agent integration that failed setup; importing a pipeline config from another instance.","solutions":["Open Settings > Voice assistants, edit the pipeline, and select an existing conversation agent (or clear the field to use the default).","Confirm the conversation integration is enabled and the agent entity is listed in Developer Tools > States.","Restart Home Assistant if a conversation agent integration failed to load on boot.","Fix the stored value in .storage/assist_pipeline.json if it references a stale entity id."],"exampleFix":"# before\npipeline = Pipeline(conversation_engine=\"conversation.chatgpt\")  # deleted entity\n\n# after\nfrom homeassistant.components import conversation\nif conversation.async_get_agent_info(hass, pipeline.conversation_engine or conversation.HOME_ASSISTANT_AGENT) is None:\n    pipeline = dataclasses.replace(pipeline, conversation_engine=None)  # default agent","handlingStrategy":"validation","validationCode":"from homeassistant.components import conversation\nagent_info = conversation.async_get_agent_info(\n    hass, pipeline.conversation_engine or conversation.HOME_ASSISTANT_AGENT\n)\nif agent_info is None:\n    _LOGGER.warning(\"Conversation engine missing: %s\", pipeline.conversation_engine)","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-not-supported\":\n        # reselect conversation agent\n        ...","preventionTips":["Validate pipeline.conversation_engine resolves before exposing the pipeline to users.","Update pipelines when conversation agent entities are removed."],"tags":["assist-pipeline","conversation","configuration"],"backgroundTag":null,"analyzedSha":"58a3fdb3ea0538617f0a07efcfba6294de64fd59","analyzedAt":"2026-08-14T20:54:38.818Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}