> ## Documentation Index
> Fetch the complete documentation index at: https://usesuperflow.ai/docs/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/jELxsvcVzU8LZvi4/videos/agent-groups.mp4?fit=max&auto=format&n=jELxsvcVzU8LZvi4&q=85&s=4e0630f33ddfcaa845f67e38702a43fe" 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/7RoAJ1ZsgDbr7h78/images/how-to-guides/how-to-create-and-run-an-agent-group/01-new-group.png?fit=max&auto=format&n=7RoAJ1ZsgDbr7h78&q=85&s=6e684cf67443b4378001271c150aae7f" 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/7RoAJ1ZsgDbr7h78/images/how-to-guides/how-to-create-and-run-an-agent-group/02-create-group.png?fit=max&auto=format&n=7RoAJ1ZsgDbr7h78&q=85&s=0b3bffab8bb48b7eb4c85a55891531a4" 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/7RoAJ1ZsgDbr7h78/images/how-to-guides/how-to-create-and-run-an-agent-group/03-group-created.png?fit=max&auto=format&n=7RoAJ1ZsgDbr7h78&q=85&s=67cb244120a7a577c3289c207e319c0a" 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/7RoAJ1ZsgDbr7h78/images/how-to-guides/how-to-create-and-run-an-agent-group/04-run-group.png?fit=max&auto=format&n=7RoAJ1ZsgDbr7h78&q=85&s=0476f8db50528dbad4a108481fe0f2e9" 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/7RoAJ1ZsgDbr7h78/images/how-to-guides/how-to-create-and-run-an-agent-group/05-progress.png?fit=max&auto=format&n=7RoAJ1ZsgDbr7h78&q=85&s=4b5dd78f0f612baf456f9e4b64d2cc61" 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="/docs/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="/docs/agents/how-to-run-an-agent-from-the-agents-tab">
    Run a single agent instead of a whole group.
  </Card>
</CardGroup>


## Related topics

- [How to Run an Agent from the Agents Tab](/docs/agents/how-to-run-an-agent-from-the-agents-tab.md)
- [How to Create Agents from a Checklist](/docs/agents/how-to-create-agents-from-a-checklist.md)
- [How to Create a New Agent](/docs/agents/how-to-create-a-new-agent.md)
- [How to Run Agent Pre-Checks on a New Project](/docs/agents/how-to-run-agent-pre-checks-on-a-new-project.md)
- [What Agents Are](/docs/agents/overview.md)