Skip to main content

Attach Resources to a Conversation Using @-Mentions

Type @ in the message composer to quickly attach agents, datasources, spaces, or integrations to a conversation.

Attach Resources to a Conversation Using @-Mentions

Adding resources to a conversation — agents, datasources, spaces, or integrations — used to require opening a separate menu, dragging and dropping, or clicking through an "Add Resources" modal. For users who think in terms of what they want to reference, not where the button is, this friction slowed things down.

You can now type @ directly in the message composer to attach a resource. It works the same way @-mentions work in tools like Slack or Notion: type @ followed by a few characters, pick from the list that appears, and the resource is attached.

You might use this when:

  • You want to pull in a specific agent mid-conversation without leaving the composer

  • You're referencing a datasource and want to attach it quickly while typing your message

  • You want to bring a space into context without opening the resource picker

  • You need the agent to take an action in a connected tool — like sending a Slack message, creating a Jira ticket, or querying Salesforce — without leaving your thread

How It Works

Typing @ at the start of a word in the composer opens a small resource picker anchored near your cursor. As you type more characters, the list filters to matching agents, datasources, spaces, and integrations. Selecting a result attaches the resource to your message — the same outcome as using the Add Resources modal or drag-and-drop — and replaces the @query text with the resource's name.

Integrations appear in their own group in the picker, with provider logos to help you spot them. You can filter by integration name or by action name — for example, typing "send a mess" will still find Slack's "Send a Message" action.

How to Use @-Mentions

  1. Click into the message composer in any conversation.

  2. Type @ followed by the name of the agent, datasource, space, or integration you want to attach.

  3. A picker will appear near your cursor showing matching resources, with integrations listed in their own group.

  4. Click or press Enter to select a result — the resource is attached and the @name text is inserted in place.

  5. Continue typing your message and send as normal.

Common Questions

Does @-mentioning a resource change how the agent responds?

Yes. Attaching a resource gives the agent access to it for that conversation. Attaching an agent delegates work to it; attaching a datasource makes its content available for retrieval; attaching a space brings in the space's context; attaching an integration gives the agent access to that integration's actions for the thread.

Why would I @-mention an integration instead of just asking the agent?

Mentioning the integration explicitly attaches it to the thread, so the agent knows exactly which tool you mean instead of guessing from your words. This is especially useful when you have multiple integrations connected or when the action you want is specific to one tool.

What if the integration I need is not connected?

Unconnected integrations still appear in the picker so you can discover them. Select one and follow the connection flow to authorize it. Integrations your admin has not authorized for your company stay hidden from the picker.

Can I attach multiple resources with @-mentions in one message?

Yes. You can type multiple @ mentions in the same message to attach several resources at once.

What if the resource I'm looking for doesn't appear?

The picker searches resources you have access to. If a resource isn't appearing, check that you have permission to access it, or use the Add Resources modal for a broader search.

Did this answer your question?