# AI analysis suggestions

{% hint style="warning" %}
This AI feature is in Beta testing. AI-generated content may be inaccurate.
{% endhint %}

## How AI suggestions are generated

The AI suggestions tool relies on a database of thousands of historical datasets. Once a node has been selected, the tool will determine the three most probable next steps in order of likelihood. It also provides an rationale for each choice to inform the user on how to proceed with their analysis.

## Generating an AI-guided analysis

* Click on a node to open the task menu and select '**Suggest next step**' (Figure 1).

<figure><img src="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-9543b1e8ecb910aa8a59b3cd8f5f8043f7543da7%2FAI_tool.png?alt=media" alt=""><figcaption><p>Figure 1. The AI suggestion tool is accessible from the context menu. Click <strong>Suggest next step</strong> to generate the suggestions.</p></figcaption></figure>

* Three suggestions will appear in the task menu and on the task graph. Each suggestion has an accompanying rationale, accessible by clicking '**Show more**'. Once the user has made a decision on how to proceed they can click '**Accept**' (Figure 2).

<figure><img src="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-84043f1f750b2fc077f79526578519c915790292%2FAI_suggest.png?alt=media" alt=""><figcaption><p>Figure 2. After clicking on <strong>Suggest next step</strong> the tool provides three potential next steps in order of likelihood. The nodes suggested will appear on the task graph. At this stage the use can select <strong>Accept</strong> for one of the suggested tasks or click <strong>Dismiss suggestions</strong>. The tool provides a rationale for each suggested task, click <strong>Show more</strong> to read the full explanation.</p></figcaption></figure>

* Once the user clicks '**Accept**' the task setup page will open. Note the disclaimer at the top of the page. Currently the AI tool does not recommend analysis-specific parameters. These remain the default set for the data type (Figure 3).

<figure><img src="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-89d501ae42475ca8f1421138a4cbdd111073e6c8%2FAI_task.png?alt=media" alt=""><figcaption><p>Figure 3. The task setup menu opens, note the disclaimer at the top of the page.</p></figcaption></figure>

* Clicking '**Finish**' runs the task as it normally would. A new node appears on the task graph.

### Additional notes

* The user is encouraged to provide feedback using the thumbs up/down icons (Figure 4). They can also provide written feedback for their choice. Clicking '**Cancel**' will still send the thumbs up/down selection as feedback. If you don't want to share your feedback click the 'x' in the feedback box.

<figure><img src="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-7321da39c4825dad68ffe7b71184a26abc44cae2%2FAI_feedback.png?alt=media" alt=""><figcaption><p>Figure 4. Feedback for each task suggested by the AI tool can be provided by clicking on the thumbs up/down icons. Users are also encouraged to provide feedback using the text box</p></figcaption></figure>

* Clicking '**Dismiss suggestions**' will trigger a similar feedback process.
* The tool will provide a confidence score for the choices presented. This can be low, medium or high; based on the historical data. Note that a low score can indicate all the options proposed are equally valid as a subsequent step, depending on the specific analysis (Figure 5).

<figure><img src="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-4355e26658523b5a89a70a8bef3932baa7975d33%2FAI_confidence.png?alt=media" alt=""><figcaption><p>Figure 5. Confidence score assigned to the AI suggestions.</p></figcaption></figure>
