# Mini assistant

{/* AUTO-SYNCED SOURCE: this page lives in apps/app/src/modules/agent/docs/ and is mirrored into the docs app by `bun sync:module-docs`. Edit it in the module, not in apps/docs. */}

<Lead>
The mini assistant is the floating orb with the compass rose icon that accompanies you on every page of the platform. One click opens a chat panel right where you are working: the assistant knows the page, helps with matching quick actions, and fills form fields on request, never unasked.
</Lead>

## The orb

The orb floats above every page and can be moved freely: drag it somewhere out of your way or dock it at the edge. A click opens the chat panel instead of navigating to a new page, so you stay exactly where you are.

<Tip title="The orb can be turned off per person">
You can hide the orb just for yourself: **Account > Assistant** (Konto > Assistent), section **Verhalten** (behavior). The assistant stays reachable via `/agent` and the keyboard shortcut. If the orb is missing for you, check this setting first (see also [Troubleshooting](/tools/agent/troubleshooting)).
</Tip>

## The panel

Four buttons sit at the top of the panel: **Neuer Chat** (new chat), **Im Vollbild öffnen** (open full screen, moves the current chat to `/agent`), **Minimieren** (minimize), and **Schließen** (close).

On opening, the assistant greets you with **Womit kann ich helfen?** (how can I help?) and the hint **Frag mich zu dieser Seite, deinen Objekten oder lass mich einen Text schreiben.** (ask me about this page, your properties, or have me write some copy). Below that you find starter suggestions and, if available, the **Letzten Chat fortsetzen** (resume last chat) button. The composer waits for your input with **Frag mich etwas …** (ask me anything).

## Page context

The mini assistant knows where you are: a badge in the header shows the title of the current page (or **Kennt die Seite, auf der du bist**, knows the page you are on). The most important information about the page automatically travels along with your question: which page it is, its title, the visible entries, fillable fields, and relevant images. So you do not need to explain the situation: "Summarize this" is enough on a property page.

## Quick actions per page

Matching the page, the assistant suggests concrete actions. On a property page, for example, **Exposé für dieses Objekt schreiben** (write a listing for this property) or **Objekt in drei Sätzen zusammenfassen** (summarize this property in three sentences). One click starts the task immediately, with the page context on board.

## Keyboard shortcuts

<DefinitionList>
  <DefItem term="Cmd/Ctrl+K">Opens the mini assistant from any page: <Kbd>Cmd</Kbd>+<Kbd>K</Kbd> on Mac, <Kbd>Ctrl</Kbd>+<Kbd>K</Kbd> on Windows.</DefItem>
  <DefItem term="Esc">Closes the panel again.</DefItem>
</DefinitionList>

## Ask about this

When you select text anywhere on a page, the **Dazu fragen** (ask about this) chip appears. One click takes the quote into the chat, and you ask your question directly about the selected content, for example an activity note or a listing paragraph. If the chip bothers you, turn it off just for yourself under **Account > Assistant** in the **Verhalten** (behavior) section.

## Having fields filled in

On pages with form fields the assistant can suggest values, for example a property description or master data from an attached document. The suggestions first land in a bar above the composer: **Feld ausfüllen?** (fill this field?) for one field, **N Felder ausfüllen?** (fill N fields?) for several.

<Info title="Never unasked">
The assistant never writes values into your forms on its own. Only your click on **Übernehmen** (apply) writes the suggestions into the fields, **Verwerfen** (discard) removes them. Until then, nothing has happened on the page.
</Info>

## Further reading

For longer work, switch to the [full-screen view with chats and projects](/tools/agent/chat-und-projekte). Which tools the assistant has at its disposal is listed in the [capabilities reference](/tools/agent/faehigkeiten). Back to the [overview](/tools/agent).