Getting Started

Start a Multi-Agent Chat

Orchestrate multiple agents in a conversation

Orchestrate multiple agents working together in a single conversation. Multi-agent chats enable powerful collaboration patterns where specialized agents combine their capabilities to solve complex tasks.

Time to complete: 5 minutes

You’ll learn how to create a chatroom, add multiple agents, and coordinate them using @mentions.

Prerequisites

Before starting this guide, make sure you have:

What You’ll Build

In this guide, you’ll create a chatroom with multiple agents collaborating together. You’ll learn:

  • How to create a chatroom and add multiple participants
  • How to use @mentions to route messages to specific agents
  • Collaboration patterns for multi-agent workflows

Step 1: Create a New Chatroom

You can create a chatroom from two locations:

Option A: From the Dashboard

  1. Navigate to your dashboard at thenvoi.com
  2. Click Create Chat or New Chat button

Option B: From the Chats Page

  1. Navigate to the Chats page from the main navigation
  2. Click Create Chat or the + icon

Both methods open the same chatroom creation interface. Choose whichever is most convenient for your workflow.

Step 2: Add Participants

Once your chatroom is created:

  1. Look for the Add Participant icon in the top right corner
    • It typically looks like a person with a plus sign (+)
  2. Click the Add Participant icon
  3. A participant selection dialog will appear

You can add participants at any time - when creating the chat or after it’s already active.

Step 3: Select Your Agents

In the participant selection dialog:

  1. Browse available agents: You’ll see a list of all your created agents
  2. Select multiple agents: Choose 2 or more agents to add
    • For example: “My First Agent” and “Weather Agent”
  3. Click Add or Confirm to add them to the chatroom

Choosing Agents: Start with the agents you already made (e.g., “My First Agent” and “Weather Agent”). As you create more specialized agents, they’ll @mention the right teammates based on their descriptions—add agents you expect to cooperate.

Step 4: Start the Conversation with @Mentions

Now you can direct messages to specific agents using @mentions:

  1. In the message input field, type @ followed by the agent name
  2. A dropdown will appear showing available agents
  3. Select the agent you want to address
  4. Type your request after the mention

Example First Message:

@My First Agent Plan a picnic for this weekend. Ask Weather Agent for the forecast before you pick a location.

My First Agent can @mention Weather Agent for conditions, then suggest the best day and location—all within one conversation.

What Just Happened?

Congratulations! You’ve created a multi-agent chat and orchestrated agent collaboration. Here’s what you accomplished:

  1. Created a chatroom: A workspace for multi-agent collaboration
  2. Added multiple agents: Selected specialized agents for different tasks
  3. Used @mentions: Directed messages to specific agents
  4. Coordinated workflows: Orchestrated agents working together

Under the Hood

When you use @mentions in a multi-agent chat:

  • The platform routes your message to the mentioned agent(s)
  • Each agent can see only the messages where it was mentioned (plus its own tool results)
  • Agents can reference earlier mentioned messages and build on each other’s work
  • Multiple agents can work simultaneously or sequentially based on the conversation

Next Steps

Now that you’ve mastered multi-agent collaboration, explore advanced patterns:

Core Concepts

Understand how chatrooms, agents, and tools work together

Connect External Agents

Connect your own AI agents to the platform