# Getting Started with Aida

{% hint style="info" %}
Requires version 10.1 or higher.
{% endhint %}

OneSite Aida's main purpose is to take natural language queries and generate custom dashboards on the fly. Aida does this by accessing [Sensor](https://docs.adaptiva.com/platform-guide/platform-features/sensors) data relevant to the query. Aida, although not a general use chatbot, can respond to queries regarding its own scope, along with sensors and their definitions. For example you may want to ask Aida:

* "What kinds of data can I collect?"
* "What sensor(s) will capture patches with the highest risk scores?"

{% hint style="info" %}
OneSite Aida is limited to only work within the confines of OneSite tenants. Any on-premises database or SaaS tenant information is NOT shared externally. Therefore, querying in one tenant will not pull data from any other tenant. Additionally, Aida does not have direct access to data within the tenant. Aida only generates queries to gather data, but does not see any returned data.
{% endhint %}

## Create a dashboard with Aida

Once you query Aida it will display a button in the chat to open the dashboard preview. Once generated, you have the option of saving each dashboard to reference later. Newly generated dashboards will show live data, whereas saved dashboards will update on a schedule every 24 hours. If you do not decide to save, they will be saved temporarily. Each inactive temporary dashboard is auto-deleted after ten minutes after you leave a conversation and then restored when reopened.

For example, you could run the following query:

1. Click the **+** next to the **New Chat** dropdown menu to create a new chat, or start typing in the Aida chat field.
2. Enter a prompt like *Show me only non-compliant devices with a risk score above 75*.
3. Wait for your response and then click the generated dashboard button.

   ![](https://4278434842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6zWDkRrsxRGskacChCcP%2Fuploads%2Fgit-blob-7ba0675fec31bd9cccb90190e6dca3f849456a87%2Faida-query-dashboard-button.png?alt=media)
4. This will open the Artifacts pane where you can view all of your recently generated dashboards.

   ![](https://4278434842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6zWDkRrsxRGskacChCcP%2Fuploads%2Fgit-blob-5fe7a867da8d8832db8bb4faa8474b85b27e3a44%2Faida-query-dashboard-pane.png?alt=media)
5. Click **Save** if you would like to save your dashboard, otherwise you can either close the window, interact with your dashboard, or ask Aida to create additional dashboards.

## Fork an existing chat

Once you have started a chat with multiple queries, you can fork an existing chat query to continue queries from that point in the history. This is useful if you have dashboards created further in the history that may now be unrelated to a previous query node you wish to continue to explore.

To create a fork, please follow the steps below.

1. Click the **Forks** tab in an existing chat.
2. Click the ellipses (**...**) and select **Create Fork**.

   ![](https://4278434842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6zWDkRrsxRGskacChCcP%2Fuploads%2Fgit-blob-07aee29d446574adb9508e1ace50d75e2c257f80%2Fcreate-fork.png?alt=media)
3. Enter a name for your new fork and click **OK**.

   ![](https://4278434842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6zWDkRrsxRGskacChCcP%2Fuploads%2Fgit-blob-76af7ac7d29e03928799f3de320aa95aba2c23f4%2Fname-your-fork.png?alt=media)
4. Click the **Chat** tab and notice the **Building from:** status will now be building from your new fork.

   ![](https://4278434842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6zWDkRrsxRGskacChCcP%2Fuploads%2Fgit-blob-e60da772fd610dc1cff1dcc4db4c7a61acc1ad33%2Fbuilding-from-chat.png?alt=media)
5. Click the **History** tab to see a timeline view of your fork.

   ![](https://4278434842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6zWDkRrsxRGskacChCcP%2Fuploads%2Fgit-blob-c761768f52574cd9d7fb45fb869e8900257b9c8e%2Ffork-in-history.png?alt=media)

## Chat History

You can see all of your selected chat's history from the **History** tab. This will give you a timeline view of your queries. Clicking on any node will open the response and generated dashboard and will allow you to show in the full chat window, create a fork, or delete the node.

![](https://4278434842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6zWDkRrsxRGskacChCcP%2Fuploads%2Fgit-blob-31759cb7b553cac1535b38b64b15e73438b994e6%2Fhistory-dialogue.png?alt=media)

## Sensors

To create query prompts that will better guide Aida responses, we recommend asking Aida about the sensor catalog. It can provide a reference for all of our available sensors with categories and descriptions for each sensor.

{% hint style="info" %}
Each OneSite product will have its own set of sensors that it exposes to Aida. For example, OneSite Patch will provide a set of Patch specific sensors, that would not be available if OneSite Patch was not licensed.
{% endhint %}

### Example queries

Below are some query examples with potential outputs for you to try when first interacting with Aida.

* "Which products or patches have active patching exceptions?"

  ![](https://4278434842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6zWDkRrsxRGskacChCcP%2Fuploads%2Fgit-blob-9b916b6a0aa34157bcffb3dd83941382194c5f7d%2Fgenerated-dashboard-patch-exceptions.png?alt=media)
* "Is global patching paused, and are there any specific products, patches, or clients with active pauses?"

  ![](https://4278434842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6zWDkRrsxRGskacChCcP%2Fuploads%2Fgit-blob-328111dc10923251ae242d4e106eaf900be657c6%2Fgenerated-dashboard-patching-pause.png?alt=media)
* "Which non-compliant devices have a risk score above 50?"

  ![](https://4278434842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6zWDkRrsxRGskacChCcP%2Fuploads%2Fgit-blob-7161901ccbe5911eb248e1223143777788dc2e4c%2Fgenerated-dashboard-non-compliant-devices.png?alt=media)
* "Which CVEs are present in my environment and what patches remediate them?"

  ![](https://4278434842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6zWDkRrsxRGskacChCcP%2Fuploads%2Fgit-blob-a95c345ff499b05fc59fd352b107edd10a2b546c%2Fgenerated-dashboard-cves-remediation.png?alt=media)