How to Clone a Workspace Agent

Overview

Cloning a workspace agent allows you to quickly duplicate an existing agent with all its settings, saving time and ensuring consistency across your workspace. This feature is perfect when you need to create similar agents without manually configuring each one from scratch.

What Gets Cloned?

When you clone an agent, the following settings are automatically copied to the new agent:

Description - The agent's purpose and functionality description
Tone & Interaction Style - Communication preferences and behavior
Visibility Settings - Private or shared access permissions
Color Theme - Visual identification color
Behind-the-Scenes Guidance - Internal instructions and guidelines

Note: The cloned agent receives a unique mention tag automatically (e.g., if the original is @M3LabsBrandGuardian, the clone becomes @M3LabsBrandGuardian2).

Step-by-Step Instructions

Step 1: Navigate to Workspace Agents

Open your project workspace
Click on Workspace Agents in the left-side navigation menu
You'll see a list of all existing agents in your workspace

Step 2: Select the Agent to Clone

Locate the agent card you want to duplicate
Click the three-dot menu (⋮) in the top-right corner of the agent card
A dropdown menu will appear with available options

Step 3: Initiate the Clone Function

From the dropdown menu, select Clone Agent
A "Clone Agent" modal window will open

Step 4: Configure Clone Settings

In the Clone Agent modal, you'll see two fields:

Destination: Choose where to create the cloned agent
- Select "Same Place" to keep it in the current workspace (default)
- Or choose a different workspace if needed
  Agent Name: The default name will be "Copy of [Original Agent Name]"
- You can customize this name before creating the clone
- Or keep the default and rename it later

Step 5: Create the Clone

Review your settings
Click the Create button
You'll see a "Cloning agent..." notification
Once complete, a success message appears: "Agent cloned successfully"
You'll be automatically redirected to the Agent Details page for your new agent

Step 6: Review and Update (Optional)

On the Agent Details page, review all the copied settings
Make any necessary adjustments to the cloned agent
Click Update Agent to save any changes
You'll see a confirmation: "Agent updated successfully"

Step 7: View Your Agents

Return to the Workspace Agents page
You'll now see both the original and cloned agent cards
Each agent has its own unique mention tag and can be managed independently

Important Notes

Agent Limit: Each workspace has an agent limit. Cloning an agent counts toward this limit (e.g., 23/30 agents used).
Unique Mention Tags: The system automatically generates a unique mention tag for the cloned agent to avoid conflicts.
Independent Agents: Once cloned, the new agent operates independently. Changes to one agent do not affect the other.
Permissions: You need appropriate workspace permissions to clone agents.

Use Cases

Cloning workspace agents is particularly useful for:

Creating Agent Variations: Build multiple versions of an agent with slight differences
Team Standardization: Ensure consistent agent configurations across your team
Testing & Development: Create test versions of production agents
Scaling Workflows: Quickly deploy similar agents for different projects or departments
Template Management: Use well-configured agents as templates for new ones

Troubleshooting

Q: I don't see the Clone Agent option

Verify you have the necessary permissions in the workspace
Ensure you're clicking the three-dot menu on the agent card itself

Q: The clone failed to create

Check if you've reached your workspace agent limit
Verify you have sufficient permissions
Try refreshing the page and attempting again

Q: Can I clone an agent to a different workspace?

Yes, select the destination workspace in the "Destination" dropdown when configuring the clone

Q: Can I rename the cloned agent later?

Yes, you can edit the agent name at any time from the Agent Details page

Managing Workspace Agents
Creating Custom Agents
Agent Permissions & Visibility
Workspace Agent Limits