# Modes

Simple and advanced modes for querying device data.

Soracom Query offers two usage modes, **Simple** and **Advanced**, to match your expertise and workflow.

## Simple Mode

The **Simple Mode** allows you to ask questions about your fleet and its data in natural language or to select from preset options to quickly get insights. Results can be viewed as charts, tables, or text. Soracom Query Studio opens in Simple Mode.

![Query Simple Mode](https://docs.soracom.io/_astro/query-01-en.B5XqkvvV_Z1H5kjJ.webp)

In Simple Mode, the [SQL Assistant](https://docs.soracom.io/en/services/query/sql-assistant) always runs in Agent Mode, which means it runs queries on your behalf to answer your question. A single question may execute several queries, each of which counts toward your plan. The Agent Mode toggle and the other assistant settings are in Advanced Mode. See [Agent Mode](https://docs.soracom.io/en/services/query/sql-assistant#agent-mode) for details.

## Advanced Mode

The **Advanced Mode** provides an editor for writing and running custom SQL queries, as well as a **SQL Assistant** to help generate SQL queries from a natural language prompt. You can also save, favorite, and reuse past queries.

![Query Advanced Mode](https://docs.soracom.io/_astro/query-02-en.DOJ8-vx-_1URkUI.webp)

Advanced Mode also provides the SQL Assistant's settings: an **Agent Mode** toggle, which is off by default, and an **Advanced Settings** section containing the reasoning level. See [SQL Assistant](https://docs.soracom.io/en/services/query/sql-assistant) for details, including how its queries count toward your plan.

> [!WARNING]
>
> Reloading Soracom Query Studio returns you to Simple Mode. Select **Advanced** again to return to Advanced Mode.

> [!NOTE]
>
> Note that Soracom Support is unable to provide assistance regarding SQL queries, such as creating SQL query samples, reviewing or testing SQL queries generated by the SQL Assistant, or providing prompts for SQL query generation.

## Changing Modes

To switch modes:

1. Sign in to the **[User Console](https://console.soracom.io/?coverage_type=g)** as the Root user and select the appropriate coverage type.

2. From the **☰ Menu**, expand **Soracom Query** and select **Soracom Query**.

3. Click the **Simple** or **Advanced** switch on the Soracom Query screen.

   ![Query Select Mode](https://docs.soracom.io/_astro/query-select-mode.BrCa_ytN_ZjxKeV.webp)
