@Mentions & Context
@mentions let you tell the AI exactly which elements you want to work with, so it doesn't have to guess. They're the fastest way to get a precise result in a busy diagram.
How to Use @Mentions
Type
@in the chat input.A list of available diagram elements appears as a dropdown.
Use the arrow keys to navigate and Enter or Tab to select.
The selected element is inserted into your message as a highlighted chip. You can add multiple mentions in a single message.
Referencing Your Selection
If you already have elements selected on the canvas, type @Selected to reference all of them at once — no need to mention each by name:
"@Selected change the color to red"
"@Selected connect these nodes with curved links"
"@Selected group into a boundary called 'Core Services'"
@Selected always reflects what's currently highlighted on the canvas at the moment you send the message.
When to Use @Mentions vs. Plain Text
The element name is long, generic, or ambiguous
The element name is unique and easy to type
You want to reference multiple specific elements
You're creating new elements (nothing to mention yet)
You have a selection and want to act on it
You're asking a general question about the board
Related
AI Chat – The main chat panel
Reviewing & Staging Changes – How proposed changes appear on the canvas
Last updated