> ## Documentation Index
> Fetch the complete documentation index at: https://agentcontrol-simplify-quickstarts.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# UI Quickstart

> Launch the Agent Control dashboard to manage controls and monitoring from your browser.

The Agent Control dashboard lets you manage [controls](/concepts/controls) and monitor agent activity — no code changes required.

## Open the Dashboard

If you followed the [Quickstart](/core/quickstart), the dashboard is already running. Open [http://localhost:8000](http://localhost:8000) in your browser.

You should see an empty state — this is expected before any controls are created.

<img src="https://mintcdn.com/agentcontrol-simplify-quickstarts/uVCvVTHKF-PqEA3i/images/no-controls-at-startup.png?fit=max&auto=format&n=uVCvVTHKF-PqEA3i&q=85&s=738ab72fecd56594c9a61d671626a841" alt="Dashboard with no controls at startup" width="2580" height="930" data-path="images/no-controls-at-startup.png" />

<Accordion title="Manual setup (only if you're running the server from source)">
  If you cloned the `agent-control` repository and started the server with `make server-run`, you need to start the UI separately:

  **Prerequisites:**

  * **Node.js 20+** (CI uses 20; 18+ may work)
  * **pnpm 9+** — install from [pnpm.io](https://pnpm.io/) or run `corepack enable && corepack prepare pnpm@latest --activate`

  ```bash theme={null}
  cd ui
  pnpm install
  pnpm dev
  ```

  The dashboard will be running at [http://localhost:4000](http://localhost:4000).

  <Tip>
    Keep the Agent Control server (`make server-run`) and the UI (`pnpm dev`) running in separate terminal windows. The dashboard communicates with the server at `http://localhost:8000` by default.
  </Tip>
</Accordion>

## Create Controls from the UI

You can create controls directly in the dashboard — no scripts or SDK code required.

<Steps>
  <Step title="Add a new control">
    Click the **Add Control** button from the controls page to start creating a new control.

    <img src="https://mintcdn.com/agentcontrol-simplify-quickstarts/uVCvVTHKF-PqEA3i/images/add-control.png?fit=max&auto=format&n=uVCvVTHKF-PqEA3i&q=85&s=4919d63150f48389b5f7cddfe037f1e8" alt="Add a new control" width="2148" height="1076" data-path="images/add-control.png" />
  </Step>

  <Step title="Select the control type">
    Choose an [evaluator](/concepts/evaluators/overview) type for your control. Options include [Regex](/concepts/evaluators/built-in-evaluators#regex-evaluator), [List](/concepts/evaluators/built-in-evaluators#list-evaluator), [JSON](/concepts/evaluators/json), [SQL](/concepts/evaluators/sql), and [AI-powered](/concepts/evaluators/custom-evaluators) evaluators.

    <img src="https://mintcdn.com/agentcontrol-simplify-quickstarts/uVCvVTHKF-PqEA3i/images/select-control-type-to-create.png?fit=max&auto=format&n=uVCvVTHKF-PqEA3i&q=85&s=56009c7a2b8ccf53c29000dbf3ef5968" alt="Select the control type to create" width="1274" height="936" data-path="images/select-control-type-to-create.png" />
  </Step>

  <Step title="Configure the control">
    Fill in the control details. See [Controls](/concepts/controls) for a full explanation of each field.

    <img src="https://mintcdn.com/agentcontrol-simplify-quickstarts/uVCvVTHKF-PqEA3i/images/configure-selected-control-type.png?fit=max&auto=format&n=uVCvVTHKF-PqEA3i&q=85&s=e6cfc073c8c72cca0be5064ef0203483" alt="Configure the selected control type" width="1230" height="1208" data-path="images/configure-selected-control-type.png" />

    | Field                       | Description                                                             |
    | --------------------------- | ----------------------------------------------------------------------- |
    | **Control name**            | A unique identifier for the control                                     |
    | **Enabled**                 | Toggle the control on or off                                            |
    | **Stages**                  | When to evaluate — `Pre` (before execution) or `Post` (after execution) |
    | **Selector path**           | The data path to evaluate (for example, `*` for all fields)             |
    | **Action**                  | What happens on a match — `Deny` blocks the request                     |
    | **Execution environment**   | Where evaluation runs — `Server` or `Client`                            |
    | **Evaluator configuration** | Type-specific settings (values, logic, match mode, case sensitivity)    |

    Click **Save** to register the control. It takes effect immediately — no redeployment needed.
  </Step>
</Steps>

## Monitoring

The monitoring dashboard shows real-time control activity across all agents:

<img src="https://mintcdn.com/agentcontrol-simplify-quickstarts/uVCvVTHKF-PqEA3i/images/monitor-controls.png?fit=max&auto=format&n=uVCvVTHKF-PqEA3i&q=85&s=2cc3b2f7a4a3a3ca415c68eff9bf8098" alt="Control monitoring dashboard" width="2570" height="1294" data-path="images/monitor-controls.png" />

* **Total evaluations** — Requests processed per control
* **Block count** — Requests denied per control
* **Pass/block ratio** — Visual breakdown of allowed vs. blocked operations
* **Activity timeline** — Recent evaluations with timestamps

Use this view to verify controls are working, spot patterns that need tuning, and audit which controls triggered on which agent.

<Note>
  Monitoring data populates as agents process requests. Run the [Agent Control Demo](/examples/agent-control-demo) to generate sample data:

  ```bash theme={null}
  uv run python examples/agent_control_demo/demo_agent.py
  ```
</Note>

## Next Steps

<CardGroup cols={2}>
  <Card title="Agent Control Demo" icon="play" href="/examples/agent-control-demo">
    Full end-to-end walkthrough with runnable scripts.
  </Card>

  <Card title="Controls" icon="shield" href="/concepts/controls">
    Learn how to define controls using the SDK or API.
  </Card>

  <Card title="Evaluators" icon="magnifying-glass" href="/concepts/evaluators/overview">
    Explore built-in and custom evaluator types.
  </Card>

  <Card title="Configuration" icon="gear" href="/core/configuration">
    Server configuration, authentication, and deployment options.
  </Card>
</CardGroup>
