---
description: This page describes the Autocomplete capability.
---

# Autocomplete

<figure><img src="https://2516160394-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAOqTQkYofJrevcpklA7%2Fuploads%2FCoXQjLyKHHfhbMB0oy8c%2FScreenshot%202024-03-12%20at%2016.39.39.png?alt=media&#x26;token=3c8fbcbe-a78f-4a00-b635-6ec395f485eb" alt=""><figcaption><p>Autocomplete</p></figcaption></figure>

Crystal is always ready to land you a **helping** hand!

While talking to your data, **proactive suggestions of words and phrases** will appear in the Conversational Bar as you type.

Crystal is able to understand your intent and allows you to **write coherent questions faster** and to **explore your Topics directly in Conversations,** in case you don't specifically know what to ask for.

{% hint style="info" %}
<mark style="color:blue;">**Please Note**</mark>

On _first access_ to Crystal, Autocomplete is always enabled by default.

You can choose to turn it off and on again as you please. Just look at the icon on the left side of the Conversational Bar to check whether the Autocomplete capability is active or not and to configure your settings.

On all _subsequent accesses_, the settings will remain consistent with your choices: e.g. if Autocomplete was active, it will stay active, and vice versa.
{% endhint %}



## Get Customized Suggestions&#x20;

While the Autocomplete capability is on, you will get suggestions _based on questions you have already asked_, Crystal will be able to finish those sentences based on your typing history.&#x20;

You can always choose to either _accept_ a suggestion (using the arrow keys, the mouse, or by tapping on it) or _discard_ it (by continuing to write).

If you keep on writing, the Suggestions _list will change_ to offer more coherent suggestions.

You can continue to use the Autocomplete capability until finding a Suggested Topic to fit your query or sending an autonomously composed question.

{% hint style="info" %}
<mark style="color:blue;">**Please Note**</mark>

* The Autocomplete suggestions always include Topics for which your Admin granted you _viewing permissions_.  &#x20;
* If your settings have _Databases with custom Row-Level Security policies_ applied, the displayed suggestions of Filter Values are restricted to the _values you are authorized to access at Database level._
{% endhint %}



Here are all the possible ways Crystal can complete your sentence:

{% hint style="warning" %}
<mark style="color:orange;">**Remember**</mark>

A question to Crystal must always contain the name of a _Topic_, therefore an _Objective_ and an _Entity_ must always be included.&#x20;

Learn more about the Conversation Rules [here](..).
{% endhint %}



### Full Topic Suggestions

If you are at the beginning of the question and still haven't specified a Topic, you will see a full list of Topics appear.

For example:

1. Write a greeting or a command formula, like _“Show”._
2. Crystal will display a full list of Topics that match this keywords, e.g. _"the total of profit"._

<figure><img src="https://2516160394-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAOqTQkYofJrevcpklA7%2Fuploads%2FhBy7kclSK0QEwmJhiygV%2FScreenshot%202024-03-12%20at%2018.11.08.png?alt=media&#x26;token=1182c3ce-eab2-4e79-a9ea-223d0117c910" alt=""><figcaption><p>Full Topics Suggestions</p></figcaption></figure>



### Objective Suggestions

If you started the question by specifying an Entity, you will see a list of Objectives.

For example:

1. Make a straight Entity request by writing _“Profit”._
2. Crystal will display a list of Objectives for this Entity, e.g. _"distribution by city"._

<figure><img src="https://2516160394-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAOqTQkYofJrevcpklA7%2Fuploads%2F4aA2u0Bk7Q6IaSDgYj71%2FScreenshot%202024-03-12%20at%2018.11.55.png?alt=media&#x26;token=fa137551-dc11-4697-bde6-2401d2874324" alt=""><figcaption><p>Objectives Suggestions</p></figcaption></figure>



### Entities Suggestions

If you started the question by specifying an Objective, you will be shown a list of Entities.

For example:

1. Make a straight Objective request by writing _“Comparison”._
2. Notice that Crystal starts suggesting a list of Entities for this Objective, e.g. _"earning by city and facility type"._

<figure><img src="https://2516160394-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAOqTQkYofJrevcpklA7%2Fuploads%2F9IOxRIGhTJ1wgwCQNjqK%2FScreenshot%202024-03-12%20at%2018.12.20.png?alt=media&#x26;token=ae5635a6-8e67-4845-a530-6062032b376f" alt=""><figcaption><p>Entity Suggestions</p></figcaption></figure>



### Dynamic Filter Suggestions

If your question included both an Objective and an Entity, Crystal will suggest a list of possible Dynamic Filters to apply, selected from those available for that specific Topic.

For example:

1. Write a full sentence containing an entire Topic: _“Find me the breakdown of profit by city”._
2. Add the word _"for"._
3. Crystal will display (on the right-hand side of the Input Bar) a list of possible Filters to apply to this Topic: e.g. _"sector type, country, city, etc."_
4. Click on the Filter of your choice to apply it to your query.&#x20;

<figure><img src="https://2516160394-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAOqTQkYofJrevcpklA7%2Fuploads%2F4VJG7lDUH3C1mFMfGUZl%2FScreenshot%202024-03-12%20at%2018.10.02.png?alt=media&#x26;token=40521587-99b1-4bd1-836b-583bff92684f" alt=""><figcaption><p>Dynamic Filters Suggestions</p></figcaption></figure>



### Filter Value Suggestions

Once you have chosen a Filter, you will also see the list of Values available for that Filter.

For example:

1. Suppose you choose the Filter _"country"_ from the list.
2. Crystal will display (on the right-hand side of the Input Bar) a list of possible values for that Filter, e.g. _"Albania, Algeria, etc."_
3. Click on a value for the Filter and send the request to Crystal.

<figure><img src="https://2516160394-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAOqTQkYofJrevcpklA7%2Fuploads%2Fcynges5LZah9hrvXWTxt%2FScreenshot%202024-03-12%20at%2018.13.38.png?alt=media&#x26;token=bd2bc187-46b5-472e-b7a4-8565c7c1a9f5" alt=""><figcaption><p>Filter Values Suggestions</p></figcaption></figure>

{% hint style="info" %}
<mark style="color:blue;">**Please Note**</mark>

You can still send a request even if you don't select a value, but the Filter won’t be applied as no values were specified.
{% endhint %}

{% hint style="warning" %}
<mark style="color:orange;">**Remember**</mark>

Crystal will also suggest Filters and their values **when concatenating Filters**, i.e. when you write _“and for”_ in order to add a Filter to an already-filtered Topic.

You can write _"and for"_ both:

* After a full Topic request with Filters
* As a stand-alone request (because Crystal can store memory of the conversation context, as described [here](..)).
{% endhint %}

<figure><img src="https://2516160394-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAOqTQkYofJrevcpklA7%2Fuploads%2FGxueTzPDYl5ag3fIMvdr%2FScreenshot%202024-03-12%20at%2018.14.47.png?alt=media&#x26;token=3acfe0cc-e8f5-4688-a471-65bebb7030b5" alt=""><figcaption><p>Concatenate filter in a sentence</p></figcaption></figure>

<figure><img src="https://2516160394-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAOqTQkYofJrevcpklA7%2Fuploads%2FKs5aOASosWRtGbkP8bq3%2FScreenshot%202024-03-12%20at%2018.15.20.png?alt=media&#x26;token=817cfdc3-668d-4c15-baf6-337c335d3227" alt=""><figcaption><p>Ask for a filter concatenation</p></figcaption></figure>



### Next Word Suggestions

To speed up the process, Crystal will also suggest single words to help you type faster.&#x20;

For example:

1. Let’s start again by writing "_Show"._
2. _Type a space_ after the first word.
3. Crystal will suggest the most probable word to come after it: for example, _"Me"._

{% hint style="info" %}
<mark style="color:blue;">**Please Note**</mark>

* Crystal can predict _any type of syntactic word_, eventually leading to a full, meaningful question that corresponds to an actual Topic.
* While typing, you can choose to accept or ignore the words as you see fit. You can accept all of Crystal’s suggestions, accept just some of them, or ignore them all.
* Your word suggestion choices will not have _any impact_ on the Topic Suggestions.
{% endhint %}

<figure><img src="https://2516160394-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAOqTQkYofJrevcpklA7%2Fuploads%2FBEEA3z0sUkfQ79ZZo6go%2FScreenshot%202024-03-12%20at%2018.16.33.png?alt=media&#x26;token=21a643c8-e538-42f6-89d4-21408dda5a52" alt=""><figcaption><p>Word Suggestion n.1</p></figcaption></figure>

<figure><img src="https://2516160394-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAOqTQkYofJrevcpklA7%2Fuploads%2Fa69LVs6n3gBTetICdEXv%2FScreenshot%202024-03-12%20at%2018.17.52.png?alt=media&#x26;token=f99645a5-12ef-48d2-b571-1a51966bf0ed" alt=""><figcaption><p>Word Suggestion n.2</p></figcaption></figure>



## How Does It Work?

The Autocomplete capability combines two different functionalities which, when combined together, allows you to lean on Crystal's full support when writing queries.&#x20;

To fully understand how it works, it is important to know the difference between:

* [**Topic Related Suggestions**](#topic-related-suggestions), which includes the suggestion of Full Topics, Objectives, Entities, Filters, and Filter Values
* [**Next Word Suggestions**](#next-word-suggestions)**.**



### Topic Related Suggestions

To give you customized suggestions related to Topics, Crystal **compares** the sentence you type with the sentences present in the [training set](../../../../crystal-console/topics-configuration/train).

#### Rules & Limitations

* **Suggestions Based on Configured Topics:** Autocomplete only considers and suggests Configured Topics, i.e. the ones that have been manually [created by the Admin](../../../../crystal-console/topics-configuration), whereas[ auto-generated Topics](entity-based-conversation) are not included.
* **Filter and Topic Suggestions Based on User Permissions:** The system aligns both Filter and Topic suggestions with your viewing permissions set in the Console. This means that you can only see the Filter values and Topic suggestions your Admin has allowed you to see.&#x20;
* **No Data Possibility within Selected Topics:** After applying specific Filters and Values, you could run into a Topic that doesn't contain any data. This could be due to the nature of the data or the specific combination of filters applied. If you land on a Topic with no data, the system. acknowledges it by sending you a message, which will inform you of the situation and invite you to try a different query or Topic.
* **Stable Suggestions on Deleted Words:** Deleting words from a query does not update or change the suggested Topic list.



### Next Word Suggestions

For customized word suggestions, Crystal's **predictions** are based on the sentences present in the [training set](../../../../crystal-console/topics-configuration/train).

#### Rules & Limitations

* **Suggestions Based on Configured Topics:** Autocomplete only considers and suggests Configured Topics, i.e. the ones that have been manually [created by the Admin](../../../../crystal-console/topics-configuration), whereas[ auto-generated Topics](entity-based-conversation) are not included.
* **Single Word Suggestion:** To make predictions as accurate and relevant as possible, Crystal only suggests one word at a time. This approach allows the system to provide predictions that are contextually appropriate to your current input.
* **Limitation in Recognizing Untrained Sequences:** If you type a sequence of words that is not recognized within Crystal's training set, the system will not offer predictions for the following word.
* **Predictions Beyond User Permissions:** Crystal might suggest words related to Topics even if you don't have viewing permissions for those Topics.



Keep talking to your data!

***
