> ## Documentation Index
> Fetch the complete documentation index at: https://superflow-claude-superflow-portal-docs-78gpp8.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Create and Run an Agent Group

> Learn how to bundle several agents into a group and run them together against a project.

In this article, you will learn how to bundle several agents into a group and run them together against a project. Groups are useful when you always run the same set of checks, such as a pre-launch checklist, so you can trigger them all at once instead of running each agent one at a time.

<Frame>
  <video controls className="w-full aspect-video" src="https://mintcdn.com/superflow-claude-superflow-portal-docs-78gpp8/g2KY_MNTB5LdaNY9/videos/agent-groups.mp4?fit=max&auto=format&n=g2KY_MNTB5LdaNY9&q=85&s=e1d26142ba49a86aa4a429f3bb6cba01" data-path="videos/agent-groups.mp4" />
</Frame>

<Note>
  Agents are currently in **Beta**. Running a group charges credits for every agent in it, and the total is shown before you confirm the run.
</Note>

## Creating the Group

<Steps>
  <Step title="On the Superflow Dashboard, click Agents in the left sidebar to open the All Agents page">
    Click the **New Group** button on the upper right side.

    <Frame>
      <img src="https://mintcdn.com/superflow-claude-superflow-portal-docs-78gpp8/RIqHueQcev0iKYC7/images/how-to-guides/how-to-create-and-run-an-agent-group/01-new-group.png?fit=max&auto=format&n=RIqHueQcev0iKYC7&q=85&s=3c297df1eae2c5e5d89ef4df5e7cdbcb" alt="On the Superflow Dashboard, click Agents in the left sidebar to open the All Agents page" width="1600" height="1040" data-path="images/how-to-guides/how-to-create-and-run-an-agent-group/01-new-group.png" />
    </Frame>
  </Step>

  <Step title="The Create Agent Group dialog will appear">
    Enter a **Group Name**, then tick the agents you want in the group. Use the **Search** field to find agents by name, or click **Select all** to add every agent. A counter below the list shows how many you have selected. Click **Create Group**.

    <Frame>
      <img src="https://mintcdn.com/superflow-claude-superflow-portal-docs-78gpp8/RIqHueQcev0iKYC7/images/how-to-guides/how-to-create-and-run-an-agent-group/02-create-group.png?fit=max&auto=format&n=RIqHueQcev0iKYC7&q=85&s=80e2810f218ead97bc9945ee777f7f5a" alt="The Create Agent Group dialog will appear" width="1600" height="1040" data-path="images/how-to-guides/how-to-create-and-run-an-agent-group/02-create-group.png" />
    </Frame>
  </Step>

  <Step title="The group is created and opens straight away, showing only the agents it contains">
    It is also added to the filter row beneath the page title, so you can jump back to it at any time.

    <Frame>
      <img src="https://mintcdn.com/superflow-claude-superflow-portal-docs-78gpp8/RIqHueQcev0iKYC7/images/how-to-guides/how-to-create-and-run-an-agent-group/03-group-created.png?fit=max&auto=format&n=RIqHueQcev0iKYC7&q=85&s=a254657bd4c1bfe8e6338dbb6813ddc6" alt="The group is created and opens straight away, showing only the agents it contains" width="1600" height="1040" data-path="images/how-to-guides/how-to-create-and-run-an-agent-group/03-group-created.png" />
    </Frame>

    <Tip>
      Use the pencil icon next to the group title to rename the group or change which agents belong to it.
    </Tip>
  </Step>
</Steps>

## Running the Group

<Steps>
  <Step title="With the group open, click Run All Agents">
    The run dialog will appear, titled with the number of agents in the group. Select the project to run against, then set the **Path**, choose **Desktop** or **Mobile**, and leave **Run only for main URL** checked to check just the main URL.

    <Frame>
      <img src="https://mintcdn.com/superflow-claude-superflow-portal-docs-78gpp8/RIqHueQcev0iKYC7/images/how-to-guides/how-to-create-and-run-an-agent-group/04-run-group.png?fit=max&auto=format&n=RIqHueQcev0iKYC7&q=85&s=d6322a2720e71fd59e474f54edd9134a" alt="With the group open, click Run All Agents" width="1600" height="1040" data-path="images/how-to-guides/how-to-create-and-run-an-agent-group/04-run-group.png" />
    </Frame>
  </Step>
</Steps>

The total cost is shown above the buttons along with your remaining balance. Each agent in the group counts as one review, so a group of four costs 40 credits. Click **Run agents** to start.

<Steps>
  <Step title="Every agent in the group starts at once, and each row shows a running status while it works">
    Click an agent's name to open its results panel on the right and follow that agent's progress and past runs.

    <Frame>
      <img src="https://mintcdn.com/superflow-claude-superflow-portal-docs-78gpp8/RIqHueQcev0iKYC7/images/how-to-guides/how-to-create-and-run-an-agent-group/05-progress.png?fit=max&auto=format&n=RIqHueQcev0iKYC7&q=85&s=e63c4b73ac7d4681bd2f485c72f24f9e" alt="Every agent in the group starts at once, and each row shows a running status while it works" width="1600" height="1040" data-path="images/how-to-guides/how-to-create-and-run-an-agent-group/05-progress.png" />
    </Frame>
  </Step>
</Steps>

## Next Steps

<CardGroup>
  <Card title="How to Create a New Agent" icon="plus" href="/agents/how-to-create-a-new-agent">
    Build a new agent so you can add it to a group.
  </Card>

  <Card title="How to Run an Agent from the Agents Tab" icon="play" href="/agents/how-to-run-an-agent-from-the-agents-tab">
    Run a single agent instead of a whole group.
  </Card>
</CardGroup>
