feat: improve assistant conversation experience

This commit is contained in:
ajnart committed 2026-08-20 14:39:59 +02:00
1 parent 53b518960c
commit 80b90802e5
11 files changed
+845 -313

No files matched your search

+18 -1
View File
@@ -41,15 +41,32 @@ host gateway address.
- Ask from `Cmd/Ctrl + K`.
- Add the [Assistant widget](../widgets/assistant) to a board.
On desktop, the full conversation opens as a side panel so the current dashboard remains visible. On mobile, it uses
the full screen. Homarr keeps one active conversation surface: while the side panel is open, the board widget becomes
a compact return control, and a visible board widget replaces the floating activity bar. If a board contains multiple
Assistant widgets, use a compact widget's action to move the active conversation there. Minimize returns the
conversation to its widget or activity state; Close also dismisses completed activity.
The assistant can work with boards, apps, integrations, widgets, Custom Widgets, and connected services. Use `@` to
add Homarr items as context, `/` for shortcuts, and the paperclip for supported files.
In supported browsers, use the microphone to dictate a prompt and the response action menu to read an answer aloud.
Suggested prompts fill the composer first so you can review or edit them before sending. Questions and approval requests
stay next to the composer without hiding the transcript.
Use **Conversations** to search and switch threads. Open a conversation's action menu to rename it, export it as
Markdown, or delete it after confirmation.
Each request includes the user's name, current page and board, home board, server time, browser time zone, and a small
summary of accessible Homarr resources. Live status is fetched only when needed.
## Permissions and privacy
- Read-only actions can run automatically. Changes require approval.
- Read-only actions can run automatically. Changes require approval by default.
- **Automatic approvals** can prepare proposed form details and approve protected changes for the current conversation.
It turns off when you switch conversations and still respects Homarr permissions.
- Questions always wait for your answer, even when automatic approvals are enabled.
- Homarr permissions apply to every tool call and mentioned item.
- API keys and custom headers are encrypted and never returned to the browser.
- Conversations are stored per user and can be exported or deleted.