> ## 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.

<Frame>
  <video controls className="w-full rounded-xl" src="https://mintcdn.com/superflow/UWvkRyvNMXcvrfB0/videos/workspace-agent.mp4?fit=max&auto=format&n=UWvkRyvNMXcvrfB0&q=85&s=70edaa5c13f408efcb93b4efd78ef3a4" data-path="videos/workspace-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 the run.
</Note>

<Steps>
  <Step title="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.

    <Frame>
      <img src="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" alt="On the Superflow Dashboard, click Agents in the left sidebar" width="1600" height="999" data-path="images/how-to-guides/how-to-use-your-workspace-agent/01-all-agents.png" />
    </Frame>

    <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.
    </Tip>
  </Step>

  <Step title="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.                                                                                                                                                                   |

    <Frame>
      <img src="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" alt="The Checks tab lists every check the agent has derived from your reviews" width="1600" height="999" data-path="images/how-to-guides/how-to-use-your-workspace-agent/02-checks.png" />
    </Frame>

    <Tip>
      Use **Search Tests…** to find a check quickly, and **Add Rule** to add one of your own alongside the derived ones.
    </Tip>
  </Step>

  <Step title="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.

    <Frame>
      <img src="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" alt="Open the Knowledge Base tab and upload your brand guidelines" width="1600" height="999" data-path="images/how-to-guides/how-to-use-your-workspace-agent/03-knowledge-base.png" />
    </Frame>
  </Step>

  <Step title="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. |

    <Frame>
      <img src="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" alt="Run the agent against a project" width="1600" height="999" data-path="images/how-to-guides/how-to-use-your-workspace-agent/04-run-dialog.png" />
    </Frame>

    <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.
    </Note>
  </Step>
</Steps>

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](/docs/agents/how-to-run-an-agent-from-the-agents-tab) for how to read and compare them.


## Related topics

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