> ## 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 Use Your Workspace Agent

> Learn how to find the Workspace Agent Superflow generates from your own review history, give it your brand guidelines, and run it against a project.

In this article, you will learn how to find the **Workspace Agent** Superflow generates for you, review the checks it has derived from your own review history, give it your brand guidelines, and run it against a project.

<video controls src="https://mintcdn.com/superflow/UWvkRyvNMXcvrfB0/videos/workspace-agent.mp4?fit=max&auto=format&n=UWvkRyvNMXcvrfB0&q=85&s=70edaa5c13f408efcb93b4efd78ef3a4" />

> [!NOTE]
>
> Agents are currently in **Beta**. Each run consumes credits from your workspace balance, and the exact cost is shown before you confirm the run.

**1. On the Superflow Dashboard, click Agents in the left sidebar**

Your Workspace Agent sits at the top of the **All Agents** list, marked **(Auto Generated)** — you do not create it. Click its name to open it.

![On the Superflow Dashboard, click Agents in the left sidebar](https://mintcdn.com/superflow/ujZ9ej9bSgLsP4YX/images/how-to-guides/how-to-use-your-workspace-agent/01-all-agents.png?fit=max\&auto=format\&n=ujZ9ej9bSgLsP4YX\&q=85\&s=416ca3c761a53e1390276114f72bd4e3)

> [!TIP]
>
> It behaves like any other agent from here on. It can be searched for, filtered by group, and run from the **Play** icon on its row.

**2. The Checks tab lists every check the agent has derived from your reviews**

Each row is one check, written out in full, drawn from the feedback you and your clients have been leaving on projects.

| Column | What it shows |
| - | - |
| **Tests** | The check itself, in plain English. |
| **Group** | The category it belongs to, such as `visual-design`, `layout`, or `technical details`. |
| **Utilization** | How consistently this check already appears in your review history — the share of reviews that enforced it, and how many reviews that is based on. A dash means there is no data for it yet. |
| **Created by** | Where the check came from. |

![The Checks tab lists every check the agent has derived from your reviews](https://mintcdn.com/superflow/ujZ9ej9bSgLsP4YX/images/how-to-guides/how-to-use-your-workspace-agent/02-checks.png?fit=max\&auto=format\&n=ujZ9ej9bSgLsP4YX\&q=85\&s=58954349397f2ee65909fd15f97341f6)

> [!TIP]
>
> Use **Search Tests…** to find a check quickly, and **Add Rule** to add one of your own alongside the derived ones.

**3. Open the Knowledge Base tab and upload your brand guidelines**

Click **Upload Brand Guideline** — or **+ Upload** on the right — to give the agent the document it should check work against. The same guidelines then apply to every project you point the agent at.

![Open the Knowledge Base tab and upload your brand guidelines](https://mintcdn.com/superflow/UWvkRyvNMXcvrfB0/images/how-to-guides/how-to-use-your-workspace-agent/03-knowledge-base.png?fit=max\&auto=format\&n=UWvkRyvNMXcvrfB0\&q=85\&s=c19e1fd12391fc87b14cb734234f7eca)

**4. Run the agent against a project**

Click the **Play** icon on the agent's row in **All Agents**. The **Run Workspace Agent** dialog appears — pick the project and path, choose **Desktop** or **Mobile**, and click **Run Agent**.

| Option | What it does |
| - | - |
| **Project** | The project to run the agent against. |
| **Path** | The path to check, for example `/`. |
| **Device** | Run the check as **Desktop** or **Mobile**. |
| **Run only for main URL** | Leave this checked to check only the main URL instead of crawling the whole project. |

![Run the agent against a project](https://mintcdn.com/superflow/UWvkRyvNMXcvrfB0/images/how-to-guides/how-to-use-your-workspace-agent/04-run-dialog.png?fit=max\&auto=format\&n=UWvkRyvNMXcvrfB0\&q=85\&s=5dbe304c2fd2e2340aae9349734b81a5)

> [!NOTE]
>
> The cost of the run is shown above the buttons, along with your remaining balance. If the balance will not cover it, an **Add credit and run** button appears in place of **Run Agent** and brings you back here after checkout.

When the run finishes, the results panel opens on the right with the findings from that run, and keeps the history of every earlier one. See [How to Run an Agent from the Agents Tab](https://usesuperflow.ai/docs/agents/how-to-run-an-agent-from-the-agents-tab.md) for how to read and compare them.


## Related topics

- [What Agents Are](https://usesuperflow.ai/docs/agents/overview.md)
- [How to Run an Agent from the Agents Tab](https://usesuperflow.ai/docs/agents/how-to-run-an-agent-from-the-agents-tab.md)
- [How to Run Agent Pre-Checks on a New Project](https://usesuperflow.ai/docs/agents/how-to-run-agent-pre-checks-on-a-new-project.md)
- [How to Ask AI About Your Projects](https://usesuperflow.ai/docs/agents/how-to-ask-ai-about-your-projects.md)
- [How to Create a New Agent](https://usesuperflow.ai/docs/agents/how-to-create-a-new-agent.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.