> ## 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 a New Agent

> Learn how to create a new agent in Superflow.

In this article, you will learn how to create a new agent in Superflow. An agent is a reusable check that you describe in plain English, which Superflow then runs against your projects to find issues automatically. Before the agent is saved, Superflow stress-tests your instructions against sample cases so you can confirm it behaves the way you expect.

In this example, we will build a **Spell Check** agent that looks for spelling mistakes in a page.

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

<Note>
  Agents are currently in **Beta**. Each run consumes credits from your workspace balance, and the exact cost is shown before you confirm a run.
</Note>

## Creating the Agent

<Steps>
  <Step title="On the Superflow Dashboard, click Agents in the left sidebar">
    The **All Agents** page will open. Click the **New Agent** 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-a-new-agent/01-agents-new-agent.png?fit=max&auto=format&n=RIqHueQcev0iKYC7&q=85&s=16725e90a72215c4e2b29a415dd0dcd1" alt="On the Superflow Dashboard, click Agents in the left sidebar" width="1600" height="1040" data-path="images/how-to-guides/how-to-create-a-new-agent/01-agents-new-agent.png" />
    </Frame>
  </Step>

  <Step title="The Basics step will appear">
    Enter a **Name** for your agent, then add an optional **Description** to explain what it does. A live preview of the agent card is shown on the right side. Click **Next**.

    <Frame>
      <img src="https://mintcdn.com/superflow-claude-superflow-portal-docs-78gpp8/RIqHueQcev0iKYC7/images/how-to-guides/how-to-create-a-new-agent/02-basics.png?fit=max&auto=format&n=RIqHueQcev0iKYC7&q=85&s=00a636811ae19a139b748b7aa3b66e86" alt="The Basics step will appear" width="1600" height="1040" data-path="images/how-to-guides/how-to-create-a-new-agent/02-basics.png" />
    </Frame>

    <Tip>
      **Auto Credits** calculates credits at run time.
    </Tip>
  </Step>

  <Step title="The Prompt step will appear">
    In the **Prompt** field, describe what the agent should check for. In this example, we will use `Make sure all the spellings in the HTML body is correct`. Click **Next**.

    <Frame>
      <img src="https://mintcdn.com/superflow-claude-superflow-portal-docs-78gpp8/RIqHueQcev0iKYC7/images/how-to-guides/how-to-create-a-new-agent/03-prompt.png?fit=max&auto=format&n=RIqHueQcev0iKYC7&q=85&s=9e0272f002ecc9ac4b63f9aebd751337" alt="The Prompt step will appear" width="1600" height="1040" data-path="images/how-to-guides/how-to-create-a-new-agent/03-prompt.png" />
    </Frame>
  </Step>
</Steps>

There are two optional controls on this step:

* **Refine prompt** rewrites your instruction into a clearer, more specific version.
* **Questions** lets you click **Add Question** to add questions the agent should ask at run time.

## Reviewing the Test Results

<Steps>
  <Step title="The Test step will begin automatically">
    Superflow analyzes your instructions, stress-tests the prompt, generates test scenarios, and builds live previews. This is the longest step, so allow it a moment to finish.

    <Frame>
      <img src="https://mintcdn.com/superflow-claude-superflow-portal-docs-78gpp8/RIqHueQcev0iKYC7/images/how-to-guides/how-to-create-a-new-agent/04-testing.png?fit=max&auto=format&n=RIqHueQcev0iKYC7&q=85&s=aa4ac4e4cd06a49289565b7e2230850e" alt="The Test step will begin automatically" width="1600" height="1040" data-path="images/how-to-guides/how-to-create-a-new-agent/04-testing.png" />
    </Frame>
  </Step>

  <Step title="When testing completes, the generated scenarios are listed as numbered tabs">
    Click any tab to inspect that scenario. Each one shows a live preview of the sample case, the **Expected Output**, and the **Reason** behind it.

    <Frame>
      <img src="https://mintcdn.com/superflow-claude-superflow-portal-docs-78gpp8/RIqHueQcev0iKYC7/images/how-to-guides/how-to-create-a-new-agent/05-test-results.png?fit=max&auto=format&n=RIqHueQcev0iKYC7&q=85&s=490897337845fe9e160276a74d5da3b6" alt="When testing completes, the generated scenarios are listed as numbered tabs" width="1600" height="1040" data-path="images/how-to-guides/how-to-create-a-new-agent/05-test-results.png" />
    </Frame>
  </Step>
</Steps>

Each scenario is labelled so you can see the kind of case it covers, for example:

| Label                       | What it means                                                                             |
| --------------------------- | ----------------------------------------------------------------------------------------- |
| **Obvious Match**           | A clear-cut issue the agent should always catch, such as `Submite Changes` on a button.   |
| **Subtle Match**            | A harder case that is easy to miss, such as a misspelling inside a placeholder attribute. |
| **Expected: Should detect** | The agent is expected to raise a finding for this scenario.                               |

Reviewing these scenarios is the point of this step. It shows you where your check will succeed and where it may produce a false positive, before the agent runs against real projects.

<Steps>
  <Step title="If a scenario's result looks wrong, click Wrong Output?">
    Tell us Why\*\* and explain the problem. Superflow will rebuild the prompt using your feedback and test it again.

    <Frame>
      <img src="https://mintcdn.com/superflow-claude-superflow-portal-docs-78gpp8/RIqHueQcev0iKYC7/images/how-to-guides/how-to-create-a-new-agent/06-feedback.png?fit=max&auto=format&n=RIqHueQcev0iKYC7&q=85&s=dec7133969985dbde4f2bdfa661c2847" alt="If a scenario's result looks wrong, click Wrong Output?" width="1600" height="1040" data-path="images/how-to-guides/how-to-create-a-new-agent/06-feedback.png" />
    </Frame>
  </Step>

  <Step title="Once you are satisfied with the results, click Create">
    Superflow will configure the agent and lock in the prompt along with the edge cases it learned during testing.

    <Frame>
      <img src="https://mintcdn.com/superflow-claude-superflow-portal-docs-78gpp8/RIqHueQcev0iKYC7/images/how-to-guides/how-to-create-a-new-agent/07-creating.png?fit=max&auto=format&n=RIqHueQcev0iKYC7&q=85&s=5e9e1d990dd219e80a124c1eea53fdd8" alt="Once you are satisfied with the results, click Create" width="1600" height="1040" data-path="images/how-to-guides/how-to-create-a-new-agent/07-creating.png" />
    </Frame>
  </Step>

  <Step title="Your new agent will appear in the All Agents list, marked with a NEW badge">
    <Frame>
      <img src="https://mintcdn.com/superflow-claude-superflow-portal-docs-78gpp8/RIqHueQcev0iKYC7/images/how-to-guides/how-to-create-a-new-agent/09-agent-list.png?fit=max&auto=format&n=RIqHueQcev0iKYC7&q=85&s=1fe4b321e76e2d9cf5fa4b00b5c49835" alt="Your new agent will appear in the All Agents list, marked with a NEW badge" width="1600" height="1040" data-path="images/how-to-guides/how-to-create-a-new-agent/09-agent-list.png" />
    </Frame>
  </Step>
</Steps>

## Next Steps

Your agent is ready to use. The next step is to run it against a project and review what it finds.

<CardGroup>
  <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 your new agent against a project, choose a device, and review its findings.
  </Card>
</CardGroup>