> This page is for version Dev.
> For other versions, use one of these documentation indexes:
> - 3.3.0 (default): https://docs.nvidia.com/vss/3.3.0/llms.txt
> - Dev: https://docs.nvidia.com/vss/dev/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/vss/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/vss/_mcp/server.

# User Interface

## Overview

The major functionalities are encapsulated **Tab**-wise.
**Tabs** represent the major functionalities of the UI and can be enabled/disabled based on the deployed blueprint/profile.
Below the list of tabs on the main left sidebar, exists the controls pertaining to the current tab.

Each tab is described in detail in its respective section below.

The UI provides a global Chat sidebar to interact with an agentic backend service (if the service is deployed).
This Chat sidebar is available across multiple tabs (Search, Alerts, etc.) and provides a more integrated experience.

The UI supports both dark and light themes. To change the theme, click the theme toggle button in the top right corner.

## Global Chat Sidebar

> **Note**
>
> The Global Chat Sidebar replaces the separate **Chat Tab** that previous VSS use cases and workflows relied on.
> The Chat Tab is no longer actively documented from this release on.
> You can still enable either surface at deployment time through environment variables on the UI service.
> For the sidebar, use variables matching
> `NEXT_PUBLIC_(ENABLE_CHAT_SIDEBAR|CHAT_SIDEBAR_.*|SIDEBAR_CHAT_.*)`.
> For the legacy Chat Tab, set `NEXT_PUBLIC_ENABLE_CHAT_TAB` and the other `NEXT_PUBLIC_*` variables.

![VSS Reference User Interface - Global Chat Sidebar - Icon to Open](/vss/_fern-img/60f3e10cc5580e4f453169f4aced20ca90feca846e7b1b27230adf9e321f5217.webp)

The Global Chat sidebar can be opened by clicking the Chat icon at the bottom-right corner of the screen as shown above.

The Global Chat Sidebar is a persistent, collapsible chat panel available across multiple tabs (Search, Alerts, etc.)
that provides direct access to the Agentic backend service without navigating away from the current view.

![VSS Reference User Interface - Global Chat Sidebar](/vss/_fern-img/2f4d87eb1fc94d6f586056bb9389cbe52a5e4d251040a206ef5015873cca12cb.webp)

**Toggle:**

* Click the chat icon at the bottom-right corner of the screen to open.
* Click the minimize button on the left edge of the sidebar to close it.
* The sidebar is resizable by dragging its left edge (between 1/3 and 2/3 of the content area width)

**Key Features:**

* Natural language conversational interaction with the Vision Agent
* Video upload for agent analysis (drag-and-drop or click to browse; MP4, MKV supported)
* Context-aware queries — attach video clips from search results or alert metadata as context using the **"+ Chat"** button on video cards or the **"Generate Report"** button in alert rows
* Agentic query results are reflected directly in the current tab's content area (e.g., search results populate the Search Tab grid), if applicable.
* Chat history with new-conversation and folder-organization support
* Unseen response indicator (the **Chat** button turns orange) when responses arrive while the sidebar is collapsed
* Send applicable agent parameters (supported based on the deployed blueprint/profile) along with the query to the agentic backend service.
* Preserve the conversation context while working across multiple app tabs.

### Chat Input

Type your question in the input box at the bottom of the sidebar. Press Enter or click the send button to submit the query to the Vision Agent. The agent processes the query and streams the response in real time.

For streamed responses, each answer card includes an **"Insights"** component that shows the intermediate steps of the agent's reasoning as the response is generated.

![VSS Reference User Interface - Global Chat Sidebar - Insights](/vss/_fern-img/77cfa3123aa525f0e8dc6030b04550f0180cffb9a1f2f4eed35b67cf5ad88ce2.webp)![VSS Reference User Interface - Global Chat Sidebar - Agent Parameters](/vss/_fern-img/d7956bd394eedb548cdf670dac2f623fbb3a8d3190de42f79b1ed576748eda9d.webp)

When the current deployment defines agent parameters, an **Agent Parameters** control appears in the chat input bar
(to the left of the send button). Click it to open a popover, set the supported values, and submit your query.
The selected parameters are sent with each request to the agentic backend service.

The available fields depend on the deployed blueprint or profile. For example, a search deployment may expose
**Search media source type** and **Enable Critic**; a base profile may expose reasoning toggles.
If no parameters are configured for the deployment, the control is not shown.

> **Note**
>
> Configure sidebar agent parameters at deployment time with
> `NEXT_PUBLIC_SIDEBAR_CHAT_CHAT_API_CUSTOM_AGENT_PARAMS_JSON` on the UI service.
> Set the value to a JSON object with a `params` array. Each entry supports `name`, `label`,
> `type` (`boolean`, `string`, `number`, or `select`), `default-value`, optional `options` for
> `select`, optional `changeable` (defaults to `true`), and optional `tooltip-info`.

### Video Upload

![VSS Reference User Interface - Global Chat Sidebar - Video Upload](/vss/_fern-img/3ae850e2d061bd79706c220b24ab644961c9b9c8e1c52d6b36f0cdb03c9fbea6.webp)

The Chat Sidebar supports uploading video files for analysis by the Agent.

* **Drag and Drop**: Drag video files directly into the upload area
* **Click to Browse**: Click the upload area to open a file browser
* **Upload Button**: Click the upload icon button next to the chat input box
* **Supported Formats**: MP4, MKV

After uploading, the agent can analyze the video content and answer questions about it.

> **Note**
>
> Upload functionality through the Chat Sidebar will not be available if disabled in the deployment scripts.

### Controls/Settings Panel

![VSS Reference User Interface - Global Chat Sidebar - Chat Controls Open Close Icon](/vss/_fern-img/577f70ce69a7520e15fcf6dbbbe4bc58a3bd2a6960656cb477ef6e0aa6e06378.webp)

The collapsible left side panel inside the Chat Sidebar contains chat controls:

* **New chat**: Start a new conversation
* **New folder**: Create a new folder to organize conversations
* **Search**: Search through existing conversations
* **Chat History**: List of previous conversations (shows "No data" when empty)
* **Export data**: Export conversation data to a file
* **Import data**: Import (a previous exported) conversation data from a file

### Interaction with Tabs

The Chat Sidebar integrates with different tabs: Example flows are:

* In the Search Tab, queries submitted through the sidebar trigger an agentic search, and matching video results populate the Search Tab's content area. Use the **"+ Chat"** button on video cards to attach clip context to the sidebar input (see [+ Chat Button](/system-components/user-interface#chat-button)).
* In the Alerts Tab, use the **"Generate Report"** button in an expanded alert row to send alert metadata to the Chat Sidebar for AI-powered analysis.
* Video/Sensor related context can be added to the chat input by clicking the **"+ Chat"** button on video/sensor cards in the Search Tab, Video Management Tab.

### Unseen Response Indicator

When a response arrives while the Chat Sidebar is collapsed, the round **Chat** button turns orange to indicate unseen content. Opening the Chat Sidebar marks the content as seen.

## Tabs

### 1. **Alerts Tab**

The Alerts Tab provides a complete interface for monitoring, investigating, and managing AI-detected incidents. It is organized into two views accessible from the left sidebar:

* **View Alerts** — Real-time monitoring dashboard for viewing, filtering, and investigating detected incidents.
* **Manage Alerts** — Configuration interface for creating and managing real-time alert rules.

![VSS Reference User Interface - Alerts Tab Overview](/vss/_fern-img/f33cef4bd15a56ca6d64e1177122dba35e998c73669d9b2acdd98569180e9316.webp)

**Key Features:**

* \[View Alerts] Sidebar navigation with View Alerts and Manage Alerts tabs
* \[View Alerts] Advanced filtering (verification, verdict, sensor, type, trigger)
* \[View Alerts] Configurable query range and fetch size via Alerts Settings
* \[View Alerts] Sortable table with pagination and expandable metadata
* \[View Alerts] Load More functionality for incremental data retrieval
* \[View Alerts] Integrated video playback with optional bounding box overlay
* \[View Alerts] Auto-refresh with configurable intervals
* \[Manage Alerts] Real-time alert rule management (create, duplicate, delete)
* \[Manage Alerts] CV Alerts Verification rule management (create, edit, duplicate, delete)
* Light/Dark theme support

**Default Configuration:**

These initial settings are configured via system environment variables:

| Setting                    | Default    | Environment Variable                                                    |
| -------------------------- | ---------- | ----------------------------------------------------------------------- |
| VLM Verified               | ON         | `NEXT_PUBLIC_ALERTS_TAB_VERIFIED_FLAG_DEFAULT=true`                     |
| Query Range (Time Window)  | 10 minutes | `NEXT_PUBLIC_ALERTS_TAB_ALERTS_FETCH_DEFAULT_TIME_WINDOW_IN_MINUTES=10` |
| Fetch Size (Max Results)   | 100 alerts | `NEXT_PUBLIC_ALERTS_TAB_ALERTS_FETCH_MAX_RESULT_SIZE=100`               |
| Auto-Refresh Interval      | 1 second   | `NEXT_PUBLIC_ALERTS_TAB_DEFAULT_AUTO_REFRESH_IN_MILLISECONDS=1000`      |
| Rows Per Page              | 20         | Hardcoded default (overridable per session)                             |
| Max Search Time Limit      | Unlimited  | `NEXT_PUBLIC_ALERTS_TAB_MAX_SEARCH_TIME_LIMIT=0`                        |
| Alerts API URL             | —          | `NEXT_PUBLIC_ALERTS_API_URL`                                            |
| Media Bounding Box Overlay | OFF        | `NEXT_PUBLIC_ALERTS_TAB_MEDIA_WITH_OBJECTS_BBOX=true`                   |

#### Sidebar Navigation

![VSS Reference User Interface - Alerts Tab - Sidebar Navigation](/vss/_fern-img/7f1540916865d75632eaec640139562dc8e6a3c6832db45f06a67e15a3792534.webp)

The left sidebar contains a vertical tab list with two tabs:

* **View Alerts** (eye icon) — Opens the alerts monitoring dashboard.
* **Manage Alerts** (pencil icon) — Opens the alert rules management interface.

The selected tab is persisted in the session, so it is preserved when navigating away and back.

When **Manage Alerts** is selected, a **"Create alert rule"** button appears below the tabs to quickly add a new rule.

#### View Alerts

The View Alerts panel is the primary monitoring dashboard. It consists of:

1. **Filter Controls** — Left sidebar controls for verification, filters, fetch settings, and refresh
2. **Alerts Table** — Sortable, paginated table with video playback and metadata

##### Filter Controls

###### VLM Verified Toggle

|                                                                                                                                                                    |                                                                                                                                                                                  |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| .. image:: images/vss-ui/alerts-mode/filters-vlm-verified-enabled.png :align: center :alt: VSS Reference User Interface - Alerts Tab - VLM Verified Toggle Enabled | .. image:: images/vss-ui/alerts-mode/filters-vlm-verified-disabled.png :align: center :width: 50% :alt: VSS Reference User Interface - Alerts Tab - VLM Verified Toggle Disabled |
| ---                                                                                                                                                                | ---                                                                                                                                                                              |

Filters alerts by VLM verification status:

* **ON** 🔵 = Show only VLM-verified alerts
* **OFF** ⚪ = Show all unverified alerts

###### Verdict Filter

![VSS Reference User Interface - Alerts Tab - Verdict Filter](/vss/_fern-img/2939f9b0c28e8949a0a12e5faefad6b1f0fb0a42db2e05eab094ba4d850dff6c.webp)

Visible only when VLM Verified is ON. Options:

* **All**
* **Confirmed** (true positives)
* **Rejected** (false positives)
* **Verification Failed**

###### Sensor / Alert Type / Alert Triggered

![VSS Reference User Interface - Alerts Tab - Sensor / Alert Type / Alert Triggered Filter](/vss/_fern-img/c72ecc01103b3907ac90398ab9065fe3231538f4b910575914527cf79822084c.webp)

Two dropdowns in the left sidebar narrow the results:

1. Open **Filters**, choose **Sensor** or **Alert Type**, and a filter tag appears below
2. Click ✕ on a tag to remove it, or click **Clear All**
3. **Quick add:** Click a sensor or alert type in the table to add it as a filter

Multiple filters use AND logic.

###### Alerts Settings

![VSS Reference User Interface - Alerts Tab - Alerts Settings](/vss/_fern-img/37871e39ef1f31369692be1875735872d06a1e67710148bc4591ccb348568867.webp)

Expand **Fetch Settings** in the left sidebar:

**Query Range:**

Controls the time window for fetching alerts from the API.

* **Preset options:** 10 min (default) • 20 min • 30 min • 1h • 2h
* **Custom:** Select "Custom" to enter a specific duration. If a maximum search time limit is configured (via `NEXT_PUBLIC_ALERTS_TAB_MAX_SEARCH_TIME_LIMIT`), the custom value will be capped accordingly. A value of `0` means unlimited.

**Tip:** Shorter query ranges load faster and reduce server load.

**Fetch Size:**

Controls the maximum number of alerts returned per API call.

* **Preset options:** 50 • 100 • 200 • 500 • 1000 • 2000 • 5000
* **Custom:** Select "Custom" to enter a value between **10** and **5000**

**Note:** Higher fetch sizes may result in slower API responses. The fetch size also determines when the "Load More" button becomes available — if the API returns a batch equal to the fetch size, more data may be available.

###### Refresh Controls

![VSS Reference User Interface - Alerts Tab - Refresh Controls](/vss/_fern-img/f5c6a37fcfb7e4860597ddc588a26dd7af517d97e406634b7ff3d5732a1e11ff.webp)

**Refresh now** reloads the alerts immediately.

**Settings** sets the auto-refresh interval. Presets are 1s, 5s, 10s, 30s, and 1min. A green dot on **Settings** means auto-refresh is on.

**Best Practice:** Use 1–5s intervals for active monitoring, 30s–1min to reduce load, and disable auto-refresh during detailed analysis.

##### Alerts Table

![VSS Reference User Interface - Alerts Tab - Table Overview](/vss/_fern-img/ce627c3cc6697fb95a235b06dfca86962cbb01031827bdc33e0d9e85147e91f5.webp)

###### Table Toolbar

The sticky toolbar above the table header provides:

* **Alerts displayed** — Total count of alerts matching current filters
* **Pagination summary** — Shows "Page X of Y · Showing start–end" when pagination is active
* **Rows per page** — Control how many rows are displayed per page. Presets: 10 • 20 • 50 • 100 • 200 • 500, or enter a custom value (1–500)
* **Time display** — Toggle between **Local** time and **UTC** for timestamps shown in the table

###### Columns

|                   |                                                |
| ----------------- | ---------------------------------------------- |
| **Column**        | **Description**                                |
| ---               | ---                                            |
| ▼/▲               | Expand/collapse metadata                       |
| Thumbnail         | Video preview (click to play)                  |
| Timestamp         | Alert start time (sortable: ↑ ↓ ⇅)             |
| End               | Alert end time (sortable: ↑ ↓ ⇅)               |
| Sensor            | Sensor ID (click to add as filter)             |
| Alert Type        | Alert classification (click to add as filter)  |
| VLM Verdict       | 🟢 Confirmed • 🔴 Rejected • 🟡 Failed • ⚪ N/A |
| Alert Description | Alert details text                             |
| ⓘ                 | Expand/collapse metadata                       |

###### Sorting

Click the **Timestamp** or **End** column headers to cycle through sort states:

* 1st click = Ascending ↑
* 2nd click = Descending ↓
* 3rd click = Reset to default ⇅

###### Pagination

![VSS Reference User Interface - Alerts Tab - Table Pagination](/vss/_fern-img/a16ceb825cc0255db199e3e6c41c5d8014e1947170e00e5e381e7612556a2ed4.webp)

The table supports client-side pagination:

* **Page navigation** — Previous/Next buttons and page number buttons with ellipsis for large page counts
* **Rows per page** — Adjustable from the table toolbar (presets: 10, 20, 50, 100, 200, 500, or custom 1–500)
* **Auto-reset** — The table automatically returns to page 1 when filters, query range, VLM settings, page size, or sort order change

###### Load More Alerts

![VSS Reference User Interface - Alerts Tab - Load More Alerts](/vss/_fern-img/54ffcfb7106c14b121c9b733b21208c673c998c7aa08e35861a7c4c6806c7508.webp)

When additional data may be available beyond the current fetch size, a **"Load more alerts"** button appears at the bottom of the last page.

* The button shows the batch size: "Load more alerts (up to N)"
* Clicking it fetches older alerts and appends them to the existing dataset
* **Auto-refresh must be disabled** to use Load More — a tooltip explains this when auto-refresh is active
* After loading more alerts, the table resets expanded rows and sort state while preserving the current view

**How it works:** The Load More function queries for alerts older than the earliest alert in the current dataset. Results are merged and deduplicated by alert ID.

###### Expandable Rows

![VSS Reference User Interface - Alerts Tab - Expandable Rows](/vss/_fern-img/74aae8a5201444a7a92c5e0f29457cdb6d96a3bf8b99db5df24debe891039c7d.webp)

Click ▼ or ⓘ to expand a row and view its Metadata section.

**Available actions in expanded rows:**

* **Generate Report** — Sends alert metadata to the [Global Chat Sidebar](/system-components/user-interface#global-chat-sidebar) for AI-powered analysis (available when a report prompt template is configured). The Chat Sidebar opens automatically with the alert context pre-filled, allowing follow-up questions about the incident.
* **Copy Report Prompt** — Copies a formatted template with metadata for AI analysis to clipboard
* **Copy Metadata** — Copies the complete JSON metadata for debugging or sharing

All copy actions show a visual confirmation.

###### Video Playback

![VSS Reference User Interface - Alerts Tab - Video Playback](/vss/_fern-img/33cd554db8291cc67fad23fff082fdc3eb2758021c567665d2b646a6a6d04328.webp)

Click the thumbnail or play button to open a video modal with Play/Pause, seek bar, volume control, and fullscreen support.

**Requires:** Sensor mapping, VIOS service, and network connectivity.

#### Manage Alerts

The Manage Alerts view creates and manages alert rules. It has two subtabs: [Real-time Alerts](#real-time-alerts) and [CV Alerts Verification](#cv-alerts-verification). Each subtab can be enabled based on the requirements of the deployed profile. For example, the DevX Alerts RealTime profile uses only the VLM backend, so alert rules from the Real-time Alerts subtab are the ones that apply. The DevX Alerts Verification profile also uses the Video Analytics backend, which can use alert rules from the CV Alerts Verification subtab.

**Requirements:** The Manage Alerts feature requires the Alerts API URL to be configured (`NEXT_PUBLIC_ALERTS_API_URL`). Without this, the view will display an error.

##### Real-time Alerts

Real-time Alerts configure the alert bridge service to detect specific events on live video streams.

![VSS Reference User Interface - Alerts Tab - Real-time Alerts Overview](/vss/_fern-img/035abd08c562be37025a3f3c6ff8e0bf6aa40054b78f4744e182897918b1fdc2.webp)

###### Filter and Refresh

![VSS Reference User Interface - Alerts Tab - Real-time Alerts Filters](/vss/_fern-img/1e1cf57b8c56d11f859fe96bb3b0d7bcf32ba251dc7520c28719820c750f1c22.webp)

The filter bar provides text-based filtering for the rules table:

* **Live Stream URL** — Filter rules by stream URL (substring, case-insensitive)
* **Alert Type** — Filter rules by alert type (substring, case-insensitive)
* **Refresh** — Click to reload the rules list from the API

###### Alert Rules Table

![VSS Reference User Interface - Alerts Tab - Real-time Alerts Table](/vss/_fern-img/0e13820e3f6f552d50ee05e143ed210c6990e7653405af8fb6ed943a6eb8202c.webp)

The table displays all configured real-time alert rules with the following columns:

|                 |                                                                                                                                                                                                                                       |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Column**      | **Description**                                                                                                                                                                                                                       |
| ---             | ---                                                                                                                                                                                                                                   |
| Actions         | **Duplicate** (copy as new draft) and **Delete** (two-step confirmation: trash icon → confirm/cancel) for saved rules. For draft rows: **Duplicate** and **Discard**.                                                                 |
| Thumbnail       | Live stream preview image from the configured sensor. Automatically resolves the sensor from the stream URL.                                                                                                                          |
| Live Stream URL | For saved rules: read-only RTSP stream URL resolved at creation time. For draft rows: a sensor picker (combobox) sourced from VIOS's live-stream catalog — the selected sensor's RTSP URL is shown below the picker for verification. |
| Alert Type      | Classification type for the alert rule. Editable for draft rows, read-only for saved rules.                                                                                                                                           |
| Prompt          | Detection prompt describing what the rule should look for. Editable for draft rows, read-only for saved rules.                                                                                                                        |
| Status          | Rule status badge (e.g., "active") with creation timestamp for saved rules.                                                                                                                                                           |

**Sorting:** Saved rules can be sorted by Alert Type, Prompt, or Status columns using the three-state sort cycle (ascending → descending → reset).

###### Creating Alert Rules

![VSS Reference User Interface - Alerts Tab - Create Alert Rule with Sensor Picker](/vss/_fern-img/3d46edbd5e61f985bdd73d43a44f5e7a8861503c8c36e8ca2d5b1625e2cac407.webp)

There are two ways to create a new alert rule:

1. **Sidebar button** — Click "Create alert rule" in the left sidebar (visible when Manage Alerts tab is active)
2. **Inline button** — Click "Create alert rule" at the bottom of the rules table

Both actions add a new **draft row** at the bottom of the table with editable fields:

* **Live Stream URL** (required) — A sensor picker (combobox) populated from VIOS's live-stream catalog. See *Picking a sensor* below.
* **Alert Type** (required) — Specify the alert classification
* **Prompt** (required) — Describe what the rule should detect

Click **Save** to submit the rule to the alert bridge API. The UI looks up the selected sensor name in the catalog, attaches the resolved RTSP URL, and posts the rule.

**Picking a sensor**

When you click "+ Create alert rule" (or duplicate an existing row), the UI immediately calls `GET /v1/live/streams` on VIOS to fetch the current catalog of registered live streams. Each catalog entry carries the friendly sensor name, its RTSP URL, and the VIOS stream id. The catalog is **not cached** — every "+ Create alert rule" click fetches it fresh, so sensors registered in VIOS (for example, after uploading a new video through NVStreamer or the VIOS UI) appear in the dropdown right away.

In the draft row's *Live Stream URL* column:

* **Click the input** to open a dropdown listing every sensor returned by VIOS.
* **Type to filter** — the list narrows to entries whose name contains what you've typed (case-insensitive).
* **Click a suggestion**, or use **↑/↓** and **Enter** to pick one. **Escape** closes the dropdown.
* After selection, the chosen sensor's **RTSP URL is shown as a hint below the input** so you can verify you picked the right one.

The dropdown shows friendly names (for example, `warehouse-cam-1` or `sample_warehouse.mp4`), not URLs. You never need to copy/paste an RTSP URL — the UI resolves it from VIOS and sends it with the rule.

**Custom sensor names**

You can also type a sensor name that is **not yet** in the VIOS catalog (for example, a stream you plan to register later). The UI shows a "Not in VIOS catalog — will be created against this sensor name" hint below the input and forwards only the sensor name to the alert bridge; the alert bridge decides whether to accept the rule.

**Empty state:** When no rules exist, the table displays instructions to use the "Create alert rule" button to get started.

###### Deleting Alert Rules

To delete a saved rule:

1. Click the **trash icon** in the Actions column
2. The icon changes to a **confirm/cancel** pair
3. Click the **checkmark** to confirm deletion, or the **X** to cancel

Draft rows that have not been saved can be removed by clicking the **Discard** button.

##### CV Alerts Verification

![VSS Reference User Interface - Alerts Tab - CV Alerts Verification](/vss/_fern-img/9ddcdbbfbed57895dd56af95fdc221bedccb75f0527aad0deb4367b89d9eb7ee.webp)

Open **Manage Alerts**, then select **CV Alerts Verification**.

**Filter by category** narrows the table by alert type or output category. **Refresh** reloads the rules.

|                 |                                                                                                                                       |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| **Column**      | **Description**                                                                                                                       |
| ---             | ---                                                                                                                                   |
| Actions         | **Edit**, **Duplicate**, and **Delete** for saved rules. Delete uses a confirm/cancel pair. A draft row has **Save** and **Discard**. |
| Alert Type      | Required classification for the rule. Read-only after the rule is saved.                                                              |
| Output Category | Optional label for the verified result.                                                                                               |
| User Prompt     | Required question the verifier answers, such as a yes-or-no safety check.                                                             |
| Optional        | Expands optional settings for that row. A green dot means an enrichment prompt is set.                                                |

To create a rule, click **Create alert rule** in the left sidebar or at the bottom of the table. Fill **Alert Type** and **User Prompt**, then click the save icon. **Output Category** can be left empty.

![VSS Reference User Interface - Alerts Tab - Create CV Alerts Verification Rule](/vss/_fern-img/17e250585a2ef63f07b7422fe2db1a6a0b62570ee42c582d5a583d2633dd7b83.webp)

Expand **Optional** to set an **Enrichment prompt**. Leave it empty to skip the follow-up VLM call after verification.

**Alert Type** and **User Prompt** are required. After a rule is saved, edit can change the output category, user prompt, and enrichment prompt. **Alert Type** stays read-only. **Duplicate** copies the rule into a new draft.

### 2. **Dashboard Tab**

This tab shows the Kibana dashboard for the blueprint that it is deployed on.

![VSS Reference User Interface - Dashboard Tab](/vss/_fern-img/936aa5869c67e12b65800f12394999912173966e7529e441977fddd25246a683.webp)

> **Note**
>
> Blueprint deployments typically include a pre-configured Kibana dashboard (as shown above).

Refer to the [Kibana documentation](https://www.elastic.co/guide/en/kibana/current/index.html) for usage details.

### 3. **Search Tab**

Search Tab displays video clips returned by the Vision Agent. Submit natural language queries in the [Chat Sidebar](/system-components/user-interface#global-chat-sidebar); matching clips populate the results grid. Metadata filters refine those agent results.

![VSS Reference User Interface - Search Tab Overview](/vss/_fern-img/edb5e38c0f43121af8216c0a5660841623b2edbbe53d69a28ff6c621bc999350.webp)

![VSS Reference User Interface - Search Tab Overview with Open Chat Sidebar](/vss/_fern-img/2f4d87eb1fc94d6f586056bb9389cbe52a5e4d251040a206ef5015873cca12cb.webp)

**Key Features:**

* Natural language video search through the Chat Sidebar
* Filtering of agent results with advanced filter options
* Configurable result count (Top K) for performance optimization
* Advanced filtering: sensors and similarity threshold
* Local timezone handling for accurate time display
* Auto-refresh when switching between tabs
* Interactive filter tags with quick remove functionality
* Video results displayed as responsive grid cards with thumbnails
* Integrated video playback modal with full controls
* Collapsible Chat Sidebar for direct agent interaction within the Search Tab
* Search by Image — select detected objects from paused video frames and find similar objects across cameras

**Main Sections:**

This guide covers the primary interface components:

1. **Search Controls** - Filter button
2. **Filter Options** - Advanced filtering popover with sensors, similarity threshold, and result count
3. **Filter Tags** - Visual display of active filters with quick remove functionality
4. **Video Results** - Responsive grid of video cards with thumbnails, time ranges, and metadata
5. **Chat Sidebar** - Collapsible agent chat panel with video upload and conversational search
6. **Search by Image** - Object-based visual search from paused video frames across all streams

#### Search Controls

Search results are produced only by queries sent through the Chat Sidebar. The Search Tab main content area has no query input box; the filters below refine the clips the agent already returned.

#### Filter Options

![VSS Reference User Interface - Search Tab - Filter Button](/vss/_fern-img/e43e7d9593caf5983b24497b47ec9a510c040c4d54fa5c7df83fa73d74aca43c.webp)

Click **Filters** in the left sidebar to expand the advanced filtering options. Changes apply as you edit the fields. Click **Filters** again to collapse the panel.

> **Note**
>
> Filter options are only available when the Chat Sidebar is collapsed. When the Chat Sidebar is open, the Filter button and existing filter tags are disabled.

The filter popover provides the following options:

##### Video Names

Multi-select dropdown to filter video names.

* Select one or multiple video names from the list
* Video names are fetched from the VIOS API

##### Min Cosine Similarity

Set a minimum similarity threshold to filter results by relevance score.

* Range: -1.00 to 1.00
* Higher values (e.g., 0.80) return more relevant matches
* Lower values (e.g., 0.20) return broader results
* Value is automatically rounded to 2 decimal places
* Default: No minimum threshold (returns all results)

##### Show top K Results

Specify the maximum number of search results to display.

* **Required field** - Must have a value
* Minimum: 1 result
* Default: 10 results
* Enter any positive integer based on your needs
* If the field is left empty when closing the popover, it automatically resets to the default value of 10
* **Show top K Results** stays in the filter panel and is not displayed as a tag

#### Filter Tags

![VSS Reference User Interface - Search Tab - Filter Tags](/vss/_fern-img/2f668d931990e815c8386b5ada13e88e82288c83f69bca021e7dd5b4baa97960.webp)

Active filters are displayed as tags below the filter control:

* Click ✕ on any tag to remove that filter and reset it to the default
* Click "Clear All" to remove all removable filters at once
* Tags display: Video names (sensors) and Min Cosine Similarity
* **Show top K Results** remains in the expanded filter panel and is not displayed as a tag

#### Video Results

Search results are displayed as a responsive grid of video cards.

##### Video Card

![VSS Reference User Interface - Search Tab - Video Card](/vss/_fern-img/506817dc6e07b54dffb25701ee852ba7b53b363b2eb36f3da1db1e92aaa3d031.webp)

Each video card displays:

|                   |                                                                                                                                             |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| **Element**       | **Description**                                                                                                                             |
| ---               | ---                                                                                                                                         |
| Video Name        | Filename of the video clip                                                                                                                  |
| Thumbnail         | Preview image from the video (click to play)                                                                                                |
| Play Button       | Click to open video in playback modal                                                                                                       |
| Time Range        | Start time / End time of the clip in `HH:mm:ss` format. If timestamps are invalid or missing, displays `--:--:--`                           |
| Info Icon ⓘ       | Hover to see video description (if available)                                                                                               |
| Similarity Score  | Cosine similarity value (-1.00 - 1.00) indicating relevance. Displayed when available from search results                                   |
| **+ Chat** button | Adds this video clip as sensor context to the Chat Sidebar input (see [+ Chat Button](/system-components/user-interface#chat-button) below) |

##### + Chat Button

Each video card includes a **"+ Chat"** button in the top-right corner, next to the video name. This button lets you attach a specific video clip as context to the Chat Sidebar, enabling follow-up questions about that clip.

**How it works:**

1. Click the **"+ Chat"** button on a video card.
2. The clip's sensor context (video name, start time, end time) is added as a context chip in the Chat Sidebar input.
3. The button briefly changes to **"✓ Added"** for 2 seconds to confirm, then reverts to **"+ Chat"**.
4. Type a follow-up question in the Chat Sidebar that references the attached clip (e.g., *"Describe what is happening in this video"* or *"Are there any safety violations?"*).

![VSS Reference User Interface - Search Tab - Add to Chat Example](/vss/_fern-img/78e135f9e78427a54b23eddc359d340a957478a65a2ad94d263e57b35927560f.webp)

**States:**

|           |                                                                                                                                |
| --------- | ------------------------------------------------------------------------------------------------------------------------------ |
| **State** | **Description**                                                                                                                |
| ---       | ---                                                                                                                            |
| `+ Chat`  | Default state. Click to add this video clip as context to the Chat Sidebar.                                                    |
| `✓ Added` | Confirmation state (shown for 2 seconds after clicking). The clip context has been attached to the chat input.                 |
| Disabled  | The button is grayed out when the Chat Sidebar is not available (e.g., chat sidebar feature is not enabled in the deployment). |

> **Note**
>
> The **+ Chat** button adds the video clip as a **context reference** — it does not automatically send a message. After adding context, open the Chat Sidebar and type your question. Multiple clips can be added as context before sending a query.

##### Video Playback

![VSS Reference User Interface - Search Tab - Video Playback](/vss/_fern-img/a85258bec01330fcdb7ad0b46740472d50638723b19c6a3add45c0cdaab34cf4.webp)

Click the play button or thumbnail to open the video playback modal with:

* Play/Pause controls
* Seek bar
* Volume control
* Fullscreen option
* **Search by Image** button (appears when video is paused, if enabled)

**Requires:** VIOS service connectivity and proper sensor configuration.

#### Chat Sidebar

![VSS Reference User Interface - Search Tab Overview with Open Chat Sidebar](/vss/_fern-img/2f4d87eb1fc94d6f586056bb9389cbe52a5e4d251040a206ef5015873cca12cb.webp)

The Search Tab includes the [Global Chat Sidebar](/system-components/user-interface#global-chat-sidebar) on the right side, providing direct access to the Vision Agent without leaving the search interface. Refer to the Global Chat Sidebar section for full feature details (video upload, chat controls, settings, etc.).

**Toggle:**

* Click the round **Chat** button at the bottom right to open the sidebar, and the chevron button (**Collapse Chat sidebar**) on its left edge to close it
* The sidebar is resizable by dragging its left edge (between 1/3 and 2/3 of the content area width)
* Default width: 380px

**Interaction Modes:**

When the Chat Sidebar is **open**, or when it is **collapsed** while an agent query is executing, filters and filter tags are disabled. Users search only through the Chat Sidebar; the agent's responses populate the search results grid.

#### Example

Type a natural-language query in the Chat Sidebar and the agent will run a search and fill the results grid. For example, ask *"person with yellow hat carrying boxes"*; the agent interprets the query, runs the search, and matching video clips appear in the main area. The screenshot below illustrates this flow: the query in the chat and the corresponding search results (e.g. thumbnails and clips) shown in the grid.

![VSS Reference User Interface - Search Tab - Chat query "person with yellow hat carrying boxes" and search results](/vss/_fern-img/8d4cc1bf5b1f0eba5683020a2d814e6c7bed5c3aff953a0797a358a5b32ff81f.webp)

When the Chat Sidebar is **collapsed** and no query is in flight, filters and filter tags are re-enabled so you can refine the current agent results.

**Unseen response indicator:**

When a response to a query is unseen and the Chat Sidebar was closed, the round **Chat** button at the bottom right turns orange and pulses once the new response is generated to indicate unseen content. Opening the Chat Sidebar marks the content as seen and the button returns to its usual color.

##### Agentic Query Results

When a query is submitted through the Chat Sidebar, the agent's response can populate video results directly in the Search Tab's main content area. The agent interprets the natural language query, executes a search, and matching video clips appear in the results grid alongside the chat response.

At the bottom of the agent's response in the Chat Sidebar, a **"See all results in: Search Tab"** link is displayed. When the user is on a different tab (e.g., Alerts, Video Management), clicking this link navigates back to the Search Tab and displays the query results.

![VSS Reference User Interface - Search Tab - Back to Search Tab link in agent response](/vss/_fern-img/ca9650c0140748895c2951d9dd2ab40d2273a3adb0d84a27c1b0d5ddcfc299f9.webp)

##### Critic Verification

When the [Critic Agent](/vision-agent/agent-workflows/search#critic-agent-overview) is enabled and has run for a search request, search result cards display verification details for each evaluated clip. The Critic Agent uses a VLM (Vision Language Model) to verify whether each search result actually matches the user's query.

Users can toggle the critic agent on or off per query using the **Enable Critic** toggle in the Chat Sidebar settings.

![VSS Reference User Interface - Search Tab - Enable Critic Toggle in Chat Sidebar Settings](/vss/_fern-img/46c6ca5475c7a8cd4c2217cdffdb03e71406583e358cf0dc4a250c4dfa8b1ee5.webp)

When the critic agent has run, the search result cards show the verification outcome:

![VSS Reference User Interface - Search Tab - Critic Verification on Video Cards](/vss/_fern-img/68b539ca0d02a4357e9c245faf93ca479955589321f9c2e1db76a83dc1cbd347.webp)

**Result Card Indicators:**

Each evaluated result card shows the critic verdict through visual cues:

|                |                                                                                                                                                                                                                                                          |
| -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Indicator**  | **Description**                                                                                                                                                                                                                                          |
| ---            | ---                                                                                                                                                                                                                                                      |
| Border color   | The card border is colored to reflect the verdict: **green** for confirmed, **red** for rejected, **yellow** for unverified. Cards from searches that did not use the critic agent retain the default gray border.                                       |
| Verdict badge  | A colored badge below the similarity score displays the verdict: **✓ Confirmed** (green), **✗ Rejected** (red), or **? Unverified** (yellow).                                                                                                            |
| Criteria chips | Below the verdict badge, each criterion extracted from the query is listed as a small chip with a green check (✓) when satisfied or a red cross (✗) when not satisfied (e.g., `✓ subject:person`, `✗ carrying boxes`, `✓ wearing a yellow safety vest`). |

**Sorting Behavior:**

When critic results are present, search results are automatically re-sorted by verdict before similarity:

1. **Confirmed** results appear first
2. **Unverified** results appear second
3. **Rejected** results appear last

Within each verdict group, results are ordered by descending similarity score. When the critic agent did not run for the request, results retain their original similarity ordering.

> **Note**
>
> The Critic Agent runs by default. Turn it off for an individual query with the **Enable Critic** toggle in the chat settings; the choice is made per request rather than at deployment time. See [Critic Agent Overview](/vision-agent/agent-workflows/search#critic-agent-overview) for more details.

#### Search by Image

![VSS Reference User Interface - Search Tab - Search by Image Button](/vss/_fern-img/b6231066d1e39288d781d0467309f8a8eac9e33e2e5b1616898620e8c72e5ec7.webp)

Search by Image allows you to select a detected object from a paused video frame and perform an agentic search for visually similar objects across all cameras and video streams.

> **Note**
>
> Search by Image is only available when the `mediaWithObjectsBbox` option is enabled in the deployment configuration. This feature requires the Video Analytics Web API (`/frames` endpoint) and VIOS Picture API to be deployed and accessible.

**How to Use:**

1. **Play a video** — Click on a video card from the search results to open the video playback modal.
2. **Pause the video** — Pause playback at the frame containing the object of interest. A **"Search by Image"** button appears in the center of the paused video.
3. **Enter Search by Image Mode** — Click the **"Search by Image"** button. The system fetches the still frame and any detected bounding boxes from the backend.
4. **Select an object** — Click on a bounding box to select the target object. The selected box is highlighted in green. An info bar below shows the selected object ID and type.
5. **Execute the search** — Click the **"Search"** button in the info bar to find similar objects across all streams. The agent will process the query and return matching results.
6. **Cancel** — Click **"Cancel"** in the info bar or close the modal to exit Search by Image mode.

![VSS Reference User Interface - Search Tab - Search by Image Overlay with Bounding Boxes](/vss/_fern-img/3652ebc7238436b8b95d4c358106704a13b969430137ab7c67789d685fae9b48.webp)

**Search by Image Overlay:**

When Search by Image mode is active, the video is replaced by a still frame with bounding boxes drawn around detected objects:

|                        |                                                                                        |
| ---------------------- | -------------------------------------------------------------------------------------- |
| **Element**            | **Description**                                                                        |
| ---                    | ---                                                                                    |
| Frame Image            | The still frame captured at the paused timestamp, fetched from the VIOS `/picture` API |
| Bounding Boxes (white) | Detected objects in the frame. Hover to highlight; click to select                     |
| Selected Box (green)   | The currently selected object for search. Click again to deselect                      |
| Info Bar               | Displays the selected object ID, object type, and action buttons (Search / Cancel)     |

**Info Bar States:**

* **No objects detected** — Displays *"No bounding boxes detected in this frame"*
* **Objects available, none selected** — Displays *"Select one to search for similar object embeddings across views/cameras"*
* **Object selected** — Displays the object ID and type (e.g., `Person`, `Pallet`) with a **"Search"** button

**Search Execution:**

When you click **"Search"** after selecting an object, the system:

1. Sends a query to the Vision Agent: `Find similar objects matching object_id=<selected_id>`
2. Closes the video modal
3. Displays matching results in the search results grid, showing video clips where similar objects were detected across different cameras/streams

> **Tip**
>
> For best results, pause the video at a frame where the object of interest is clearly visible and the bounding box accurately covers the object.

### 4. **Video Management Tab**

Video Management Tab provides an interface for managing video streams, including uploaded video files and live RTSP camera feeds.

![VSS Reference User Interface - Video Management Tab Overview](/vss/_fern-img/ed8952a8fe30f9503d3e53749657a7f2bd7168e9d2efb66eb714f93d637d40ab.webp)

**Key Features:**

* Upload video files (MP4, MKV formats)
* Optional upload configuration fields (if configured via system settings)
* Add live RTSP camera streams
* Grid view of all streams with thumbnails
* Search and filter streams by name and type
* Bulk selection and deletion of streams
* Real-time upload progress tracking
* Stream metadata display (codec, framerate)

**Main Sections:**

This guide covers the primary interface components:

1. **Sidebar Controls** - Search, filter, upload, and bulk operations
2. **Streams Grid** - Visual display of all video and RTSP streams
3. **Video Upload** - Upload files with optional configuration fields
4. **RTSP Management** - Add and manage live camera feeds

#### Sidebar Controls

![VSS Reference User Interface - Video Management Tab - Sidebar Controls](/vss/_fern-img/cb1f595e34c3ca95cb37c143fafa3d5d7d7292ff0c55c43fe9b429f3143f345e.webp)

The left main sidebar provides quick access to common operations:

##### Search Bar

![VSS Reference User Interface - Video Management Tab - Search Bar](/vss/_fern-img/50052ba5e3b2d5d3b9a3629408ec7bd53c9ec407a538624af4ad6d0a6e4c6d0c.webp)

Type a search query to filter streams by name. Click the search button or press Enter to apply the filter.

##### Filter Toggles

![VSS Reference User Interface - Video Management Tab - Filter Toggles](/vss/_fern-img/cda3045faffb2a8df814498a261ef4791fda936c2720eeebc90fe07e9de695a9.webp)

Checkboxes show or hide specific stream types:

* **Show Videos** - Display uploaded video files
* **Show RTSPs** - Display live RTSP camera streams

Both checkboxes are enabled by default. Clear either checkbox to filter the view.

##### Upload Video / Add RTSP Buttons

![VSS Reference User Interface - Video Management Tab - Upload Video and Add RTSP Buttons](/vss/_fern-img/48e725487653028befd2c8d0baa5bc53cb4c04a2a5c454376882cd483e33ea5f.webp)

* **Upload Video** - Opens the video upload dialog for uploading video files
* **Add RTSP** - Opens the RTSP stream configuration dialog for adding live camera feeds

The **Enable video upload** switch next to these buttons shows or hides the **Upload Video** button, and the drop zone shown when the tab is empty. Turning it off does not hide videos that were already uploaded. The switch starts in the position set by `NEXT_PUBLIC_VIDEO_MANAGEMENT_VIDEO_UPLOAD_ENABLE` and goes back to that position when the page is reloaded.

> **Note**
>
> The **Add RTSP** button is hidden when the deployment does not support RTSP stream management.

#### Streams Grid

![VSS Reference User Interface - Video Management Tab - Streams Grid](/vss/_fern-img/e3edddd6bbd979d8d5bede1b14ea3d25bfc9cd5e4514853296792cac9eeade1a.webp)

The main content area displays all streams as cards in a responsive grid layout.

##### Stream Card

![VSS Reference User Interface - Video Management Tab - Stream Card](/vss/_fern-img/edcf67a857e85081ba3f4e329f6e852cdbe208d5176b75e2b205cde4251904b7.webp)

Each stream card displays:

|                |                                                                                 |
| -------------- | ------------------------------------------------------------------------------- |
| **Element**    | **Description**                                                                 |
| ---            | ---                                                                             |
| Checkbox       | Select stream for bulk operations                                               |
| Stream Name    | Sensor or file name (displayed in header)                                       |
| Thumbnail      | Live preview for RTSP, last frame for uploaded videos                           |
| Type Badge     | "RTSP" for live streams, file extension (e.g., "MP4", "MKV") for videos         |
| Copy Button    | Copy stream context to clipboard as JSON (contains `sensorName` and `streamId`) |
| Video Metadata | Video codec (e.g., H264, H265) and framerate (e.g., 30 fps)                     |

##### Video Preview

![VSS Reference User Interface - Video Management Tab - Video Preview](/vss/_fern-img/54c276c85c349f92c38b31ff4c096ca0cdde69797fbfe1f5a44784bc4a3b4400.webp)

When you click on a stream card, a popup opens to play the video preview for that stream.

##### Empty State

![VSS Reference User Interface - Video Management Tab - Empty State](/vss/_fern-img/74ce7119a0ee9723de5dd784464fbe7cb6e53dad9b607240fbe3a26fc4a7f78c.webp)

When no streams exist, the main area shows a drop zone. Click the zone or drag movie files onto it to upload them.

#### Upload Dialog

![VSS Reference User Interface - Video Management Tab - Upload Dialog](/vss/_fern-img/81b09fa05cd7c937da31e8b7356cd928ce189e5a54edce01098cd4e10f0e3da7.webp)

The upload dialog allows you to select video files and optionally configure them before uploading:

**File Selection:**

* Click the dashed area or drag-and-drop files to select videos
* Supported formats: MP4, MKV
* Multiple files can be selected at once
* Click "+ Add More" to add additional files after initial selection

**File Configuration:**

Each file in the upload list can be expanded (click the chevron icon) to rename the file and to configure optional fields if system-level configuration is enabled.

**Renaming:** The expanded row always shows a required **Filename** field, pre-filled with the selected file's name. Edit it to upload the video under a different name without going back and re-selecting the file. Filenames cannot be empty or contain spaces; spaces in the original name are removed automatically. The collapsed row shows the name the file will be uploaded under, so you can confirm a rename at a glance (hover it to see the original name).

**Note:** Configuration fields are optional and only appear if `NEXT_PUBLIC_CHAT_UPLOAD_FILE_CONFIG_TEMPLATE_JSON` is configured. Common field types include boolean toggles, text inputs, number inputs, and select dropdowns. The available fields depend entirely on your system's deployment configuration. Renaming does not depend on this setting.

**File Management:**

Each file in the list shows the video icon, upload filename, file size in MB, expand/collapse button (chevron icon) to show/hide the filename field and configuration fields, and remove button (X icon) to remove file from upload queue.

Click "Upload (N)" button to start uploading all files, or "Cancel" to close the dialog without uploading.

#### Upload Progress Panel

![VSS Reference User Interface - Video Management Tab - Upload Progress Panel](/vss/_fern-img/665903a974fda0799b37fdd6971442c9e058ec11d127de8dfccb5bc963678a2b.webp)

After confirming upload, a progress panel appears at the bottom of the screen.

**Upload Status:**

Each file displays one of the following statuses:

|            |                                                 |
| ---------- | ----------------------------------------------- |
| **Status** | **Description**                                 |
| ---        | ---                                             |
| Pending    | File queued for upload                          |
| Uploading  | Progress bar with percentage (0-100%)           |
| Success    | Upload completed successfully (green checkmark) |
| Error      | Upload failed with error message                |
| Cancelled  | Upload was cancelled by user                    |

**Progress Controls:**

* **Cancel Uploads** - Stop all pending and in-progress uploads
* **Close Panel** - Dismiss the progress panel (only available when no uploads are in progress)

**Note:** The system uploads multiple files in parallel for faster processing. Successfully uploaded videos will appear in the streams grid automatically.

#### Adding RTSP Streams

![VSS Reference User Interface - Video Management Tab - RTSP Dialog](/vss/_fern-img/142bb321561385f99fed10dc5ff11f83bebdacdb0a3540811272ac874a98551a.webp)

Click the "Add RTSP" button in the left main sidebar to add a live camera stream.

**RTSP URL Field (Required):**

Enter the RTSP stream URL in the format: `rtsp://[username:password@]hostname:port/path`

Examples:

* `rtsp://192.168.1.10:554/stream1`
* `rtsp://cam-warehouse.example.com:554/warehouse/cam01`

The system will automatically extract a suggested sensor name from the URL path.

**Sensor Name Field (Optional):**

Enter a friendly name for the sensor (e.g., "Warehouse Camera 01").

* Auto-populated from RTSP URL path if not manually specified
* Can be manually edited to provide a more descriptive name
* Used for display in the streams grid

**RTSP Validation:**

The system validates RTSP URLs:

* Must start with `rtsp://`
* Connection is verified when "Add RTSP" button is clicked
* Error messages displayed if URL is invalid or connection fails

Click "Add RTSP" to add the stream or "Cancel" to close the dialog.

#### Deleting Streams

![VSS Reference User Interface - Video Management Tab - Stream Deletion](/vss/_fern-img/ec7269e33a5248caa98be41707f8898166cbaf31535fe5284821ebf207eaf65b.webp)

To delete streams:

1. Click the checkbox on one or more stream cards to select them
2. Click the "Delete Selected" button in the left main sidebar
3. The selected streams will be deleted and the streams grid will be refreshed.

**Warning:** This action cannot be undone. Make sure you want to delete the selected streams before confirming.

## Known Issues

### Overall Issues

No known issues.

### Global Chat Sidebar

* If the backend agent restarts, the UI doesn't clear the outdated chat history.
* On a Build Vision AI deployment with NemoClaw, the Web UI starts with chat waiting for a gateway token. After onboarding, run `nemoclaw <sandbox> gateway-token --quiet` on the deployment host and enter the result in **Connect NemoClaw chat**. If the relay is still starting, the panel reports that the gateway is unreachable and offers **Retry gateway**. A rejected token is reported separately. The token remains in the browser tab session; no UI container restart is needed. Use HTTPS when accessing the UI remotely because the browser sends the token to the UI's agent API.
* If the NemoClaw agent API returns error 503, the OpenShell tunnel may have stopped forwarding traffic even if the process still appears alive. To recover, run `nemoclaw <sandbox> recover`.
* The in-stack VSS Agent Human-in-the-Loop (HITL) dialog may clip or truncate content when browser zoom is increased. Reduce the browser zoom until the full dialog is visible.

### Alerts Tab

* When a sensor is removed, its existing alerts may still appear in the alerts list, but the related thumbnails and videos are no longer accessible because the sensor data has been deleted.
* In Manage Alerts, entering a sensor name that is not present in the VIOS live-stream catalog submits the rule without a resolved live-stream URL. Register the stream first, then select its sensor from the picker.

### Dashboard Tab

No known issues.

### Search Tab

* Ignore the **Source Type** filter under **Search Controls**. Its options are **Video** and **RTSP**.
* When a live RTSP stream is removed directly from NVStreamer, the VSS Search UI may still display the stream as active.
* The Search Tab **From** and **To** timestamp filters may not be relevant for results from uploaded videos. They may apply to RTSP stream based results.
* A completed Chat Sidebar search may show matching clips in the chat response while the Search Tab main content area stays empty without video card results.
  This may happen intermittently. Start a new chat and submit the same query again.

### Video Management Tab

* There is no way to rename a stream after uploading. This will be fixed in an upcoming update. Until then, to use a different name you must upload a new stream with the desired name.
* An RTSP stream added through the Chat Sidebar may not appear in Video Management until the browser tab is refreshed. After the agent confirms that the stream was added, refresh the browser tab to update the stream list.