Crystal Docs
English
English
  • Welcome
  • Fundamentals
    • Crystal
    • Crystal Topics
  • Crystal Advisor
    • Access to Crystal
      • Signup
      • Login
      • Discover the Advisor
        • Notifications
        • Account
    • Talk to Your Data
      • Conversation
        • Request Topics
          • Entity-Based Conversation
          • Context Memory
          • Autocomplete
        • Request a Data Analysis
        • Disambiguation
    • Explore Your Data
      • Suggestions
      • Topics Overview
      • Filter Topics
      • Ask Topics
      • Past Questions
      • Change Chart
    • Analyze Your Data
      • Automated Insights
      • Insight Analysis
      • Alerts
        • Anomaly Detection
        • Threshold Monitoring
        • Topic Scheduling
      • Forecasting (Beta)
    • Report and Discuss Your Data
      • Export Topic
      • Share Topic
      • Data Storytelling
    • Customize Your Experience
      • Choose Language
      • Choose Theme
    • Crystal on Mobile
      • Siri & Shortcuts
    • Crystal on Microsoft Teams
      • Download Crystal on Teams
  • Crystal Console
    • Configure Crystal
      • Discover the Console
      • Choose Project Settings
      • Prepare Your Data
    • Create Topics
      • Topic Creation: Overview
      • Topic Creation: Connect
        • Supported Data Sources
        • Supported Data Fields
        • Manage Data Sources
        • Tutorials for Specific Data Sources
          • Connect Google Sheets
          • Connect Google BigQuery
          • Build a Web Connector
      • Topic Creation: Configure
        • Objectives and Visualizations
        • Data Binning
        • Configure Custom Entities
        • Configure Key Values
        • Modify Data Table
      • Topic Creation: Filter
      • Topic Creation: Train
      • Topic Creation: Topic Details
      • Topic Creation: Set Permissions
      • Topic Creation: Review and Publish
      • Specifc Visualizations Guides
        • Build a List Table
        • Build a Single Line Chart
        • Build a Multi-Line Chart
        • Build a Ranking Table
      • Topic Creation: Custom Topic Titles
      • Topic Statuses
      • Data Preview
      • Manage Your Entities
    • Manage Users
      • Discover the Users Area
      • Invite Users to Crystal
        • Invite Users Manually
        • Invite Users via Identity Providers
          • Enable the Microsoft Identity Provider
          • Enable the Google Identity Provider
      • Create and Manage Groups
      • Manage Permissions
  • Limitations
    • Limitations on Crystal Advisor
    • Limitations on Crystal Console
  • Support
    • Support on Crystal Advisor
    • Support on Crystal Console
  • Release Notes
    • 2024
      • Crystal Web
        • Crystal Web v2.59
        • Crystal Web v2.58
        • Crystal Web v2.57
        • Crystal Web v2.56
      • Crystal Mobile
        • Crystal Mobile v3.1.7
        • Crystal Mobile v3.1.6
        • Crystal Mobile v3.1.5
        • Crystal Mobile v3.1.4
        • Crystal Mobile v3.1.3
        • Crystal Mobile v3.1.2
        • Crystal Mobile v3.1.1
        • Crystal Mobile v3.1.0
        • Crystal Mobile v3.0.39
        • Crystal Mobile v3.0.38
    • Archive
      • 2023
        • Version 2.55
        • Version 2.54
        • Version 2.53
        • Version 2.52
        • Version 2.51
        • Version 2.50
        • Version 2.49
        • Version 2.48
        • Version 2.47
        • Version 2.46
        • Version 2.45
        • Version 2.44
        • Version 2.42
        • Version 2.41
        • Version 2.40
        • Version 2.39
        • Version 2.38
      • 2022
        • Version 2.37
        • Version 2.35
        • Versions 2.29-2.30
        • Versions 2.27-2.28
        • Version 2.26
        • Versions 2.24-2.25
        • Version 2.23
        • Version 2.22
        • Version 2.21
        • Version 2.20
        • Version 2.19
        • Version 2.18
        • Version 2.17
      • 2021
        • Version 2.15
        • Version 2.14
        • Version 2.13
        • Version 2.12
        • Version 2.11
        • Version 2.10
        • Version 2.9
        • Version 2.8
        • Version 2.7
        • Version 2.6
        • Version 2.5
        • Version 2.4
        • Version 2.3
        • Version 2.2
        • Version 2.1
Powered by GitBook
On this page
  • Explore Suggestions
  • How Does It Work?

Was this helpful?

  1. Crystal Advisor
  2. Explore Your Data

Suggestions

This page describes the Suggestions capability.

PreviousExplore Your DataNextTopics Overview

Last updated 5 months ago

Was this helpful?

The "Suggestions" Section is located on the Right Sidebar.

Every time a Topic appears in the Advisor Workspace, Crystal proposes a set of dynamic suggestions, which include suggestions of Topics related to the one you just asked. These suggestions change based on your questions.

Suggestions serve as a guide for you to continue exploring your data, indicating which questions to ask next to uncover fresh insights.

If you are new on Crystal, Suggestions can also inspire you to formulate more effective questions for the Advisor, since the Topics inside the cards are expressed in the form of questions.

Explore Suggestions

Exploring Suggestions is easy: simply click on the suggestion of your interest and you will immediately find it open and ready to explore in the Advisor.

Each time you ask a question, the suggestions will be refreshed based on the last Topic you asked about.

Please Note

Whenever possible, the algorithm will suggest up to six related Topics. The first four will generally be the more similar Topics, while the last two might be the least similar.

By showing a mix of similar and different Topics, Crystal offers a balance between informed guidance and out-of-the-box tips that may spark curiosity for alternative data exploration paths.

Remember

The Topics inside the Suggestion tips are only those who have been configured by the Admin and that you have viewing permissions for.

How Does It Work?

The Suggestions capability uses an algorithm called a Recommender System, which is powered by the Business Knowledge Graph, a data model that provides a personalized representation of the data behind your Crystal Project.

Deep Dive on the Business Knowledge Graph

The Business Knowledge Graph (BKG) serves as the foundational knowledge base that Crystal leverages to answer your questions.

It is similar to a network of interconnected information and metadata, built upon the private data linked to Crystal.

For each Crystal Project, the Business Knowledge Graph is unique and isolated, tasked with a very clear objective: to extract all the information AI models need from the metadata, to transform information into conversation.

The construction of the BKG begins with Crystal’s configuration, where data sources are selected and Business Entities are defined, along with their semantic properties.

The BKG interprets both the content of the data connected to Crystal and the decisions made during configuration to establish semantic links between elements of the corporate knowledge base.

Through this process, the BKG learns the corporate lexicon, its taxonomy, and specific expressions, achieving a deep understanding of the business.

Additionally, the BKG adapts and evolves based on the questions asked to Crystal, identifying new correlations among data and learning from users, ensuring that the results produced are always accurate, certified, and contextual.

This is one of the core technologies underlying Crystal.

Based on your customized Business Knowledge Graph, the Recommender System analyzes the dataset and selects the Topics that are more relevant to the Topic asked based on the similarity of their content.

In particular, the algorithm compares Topics based on their Entities, Objectives, or Data Sources, like this:

  1. Entities Match: first, it searches for Topics containing the same Entities as those in the Advisor’s Topic.

  2. Objective Alignment: in absence of similar Entities, it looks for Topics with matching Objectives.

  3. Source Correlation: if there aren't any matching Objectives, it extends the search to Topics from the same Table or Data Source.

Whenever possible, the algorithm will suggest up to six related Topics. The first four will be the most similar ones, while thee last two Topics will be the least similar.

Rules & Limitations

The rules and limitations to consider when using the Suggestion capability are as follows:

  • Dependency on Focused Topic: The activation of the algorithm requires a “Topic in focus”, i.e. a Topic open in Advisor.

  • A Minimum Number of Topics: There must be at least seven Topics configured and published in Console for the algorithm to suggest six correlated Topics.

  • Potential for Random Suggestions: When the configuration isn't optimal, the algorithm defaults to random suggestions.

Remember

The suggestions will be random if:

  • You've never asked Crystal a question, e.g. right after logging into Crystal.

    • In this case, you will see six random Suggestions.

  • There aren't enough Topics configured, e.g. on first usage.

  • If you have viewing permissions for a limited amount of Topics.

    • In these last two cases, you may see less then six Suggestions and some of them may be random.

Keep exploring your data!


Suggestions Based on Configured Topics: Suggestions only consider Configured Topics, i.e. the ones that have been manually , whereas are not included.

created by the Admin
auto-generated Topics
Suggestions