Conversation and AI tasks

Send text to conversation agents and generate data or images with AI tasks.

Conversation

conversation process sends text to a conversation agent, as if you’d typed it into Assist, and prints the reply as JSON:

ha-bridge conversation process "turn on the desk light"
ha-bridge conversation process "what's on today?" --agent-id conversation.openai

--conversation-id continues a conversation, using the ID from a previous reply. conversation reload reloads the agent’s intents.

AI tasks

ai_task generate-data asks an AI task entity to generate data and prints it as JSON. --structure asks for structured output, as a JSON object of selectors:

ha-bridge ai_task generate-data dinner "Suggest a dinner using chicken"
ha-bridge ai_task generate-data names "Suggest a name for a cat" --structure '{"name":{"selector":{"text":null}}}'
ha-bridge ai_task generate-image poster "A cosy living room at dusk" openai_image

generate-data uses the preferred AI task entity unless you pass --entity.

ai_task clear-images deletes generated images, or with --days, only those older than that many days. It needs a token that belongs to an admin, and Home Assistant 2026.11 or newer:

ha-bridge ai_task clear-images --days 30

See ha-bridge conversation and ha-bridge ai_task for every argument and flag.