Skip to main content

How to use Dust for team collaboration?

In Dust, users and AI agents work together in shared conversations through mentions, notifications, and conversation sharing. These features keep everyone in the loop and let agents escalate to the right people when needed.

Tutorial & Guides

1. Mention Colleagues in Conversations

Bring team members into a conversation by @mentioning them. When you mention someone, they’re automatically added as a participant and receive a notification. How to mention a user:
  1. In the composer, type @ to open the mention picker
  2. Search for a colleague by name
  3. Select their name to insert the mention
  4. Send your message - they’ll be notified instantly

2. Share Conversations with Your Team

Share a conversation so colleagues can read it and collaborate with you and the agents. People you share it with see the full conversation history and can reply. How to share:
  1. Go to the conversation you want to share
  2. Click Share at the top right
  3. Under Add people, search for colleagues or groups, or pick Everyone at your workspace
  4. Optionally, click Copy link to copy the conversation’s URL and paste it wherever you want to point people to it
The link only opens the conversation for people it’s shared with. Anyone else sees β€œThis conversation hasn’t been shared with you yet” and needs to ask for access. Managing access:
  • People with access lists everyone the conversation is shared with. Use the remove button next to a person or group to take their access away.
  • Leaving a conversation removes your own access, unless it’s still shared with a group you belong to or with everyone.
  • Conversations in a Pod are shared with the Pod’s members. Their access is managed from the Pod, not from the conversation.
Tip: Combine sharing with mentions to notify specific people that a conversation needs their attention.

3. Agent Escalation to Users

Configure agents to identify situations requiring human input and mention the appropriate team member. This is ideal for support escalations, approval workflows, or when expert knowledge is needed. How to set up escalation:
  1. Create or edit an agent
  2. Add instructions telling the agent when and whom to mention
Example instructions:

4. Track Conversations Requiring Your Attention

Your conversation sidebar shows visual indicators to help you quickly identify what needs attention: Managing your conversations:
  • Conversations are automatically marked as read when you view them
  • Leave a conversation you no longer need to follow
  • Join a conversation you want to participate in
  • Delete a conversation to remove it from your history Email notifications: If you have unread messages, you’ll receive an email digest with links to conversations needing your attention. You can set up your notification preferences in your Profile.

5. Who Has Access to My Conversation?

Understanding who can see your conversations helps you work confidently and share appropriately.

Access Rules

Key Points

  • Your conversations are private by default. When you start a conversation, only you can see it.
  • Sharing a link isn’t enough. A colleague can only open the conversation once it’s shared with them, directly, through a group, or with everyone.
  • Sharing gives access to the whole conversation. People you share it with see everything in it.
  • Mentions require your approval. When an agent mentions a colleague, you’ll see a prompt asking β€œDo you want to invite them?”. They are only added once you approve, and get access to the conversation.
  • See who has access. Open Share to see everyone the conversation is shared with.

What Admins Can See

Workspace administrators can view aggregate usage analytics (like message counts and active users). They can’t open a conversation that isn’t shared with them, unless they use Access as admin, which gives them access and is recorded in the workspace’s audit log.

Best Practices

For users:
  • Share with the smallest group that needs the conversation
  • Use mentions sparingly to avoid notification fatigue
  • Mention specific people when their expertise is genuinely needed
  • Check your inbox regularly for conversations requiring your attention
For agent builders:
  • Only enable user mention tools when escalation is a key part of the workflow
  • Include clear instructions on when agents should mention users
  • Consider using mentions for: escalation workflows, approval requests, and expert consultations