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
  • A Proactive Request to Solve Ambiguities
  • Ambiguity Types
  • Ambiguous Entities
  • Ambiguous Aggregations of Entities
  • Ambiguous Values of Filters
  • Ambiguous Time Aggregators
  • Ambiguous Source Tables

Was this helpful?

  1. Crystal Advisor
  2. Talk to Your Data
  3. Conversation

Disambiguation

This page describes the Disambiguation capability.

PreviousRequest a Data AnalysisNextExplore Your Data

Last updated 5 months ago

Was this helpful?

Misunderstandings can occur in any conversation, but when they occur in Crystal, rest assured that they don't go unnoticed.

A Proactive Request to Solve Ambiguities

Misunderstandings in conversation can happen because of ambiguities, i.e. words or concepts that may take on different meanings at the same time.

If your Project's Entities, Filters, Objectives, or even entire Topics are too similar, Crystal will automatically detect those ambiguities when they come up in a question.

In these cases, Crystal needs more information to understand which concept to select. In response, it will display a list of options to choose from, in order to clarify the question.

By selecting the correct option, you will provide Crystal with the missing information to disambiguate, i.e. resolve the ambiguity, as per the example below:

Please Note

Ambiguity Types

Different types of ambiguities can appear, depending on the nature and granularity of the information involved.

The possible scenarios include the following:

Please Note

A question might contain more than one ambiguity and of different types.

Ambiguous Entities

This ambiguity happens when the combination of the Entities in the question leads to multiple Topics possible.

The Topics in the list can either fully or partially match the Entities.

Full Match

Topics fully match if they contain all the requested Entities.

This ambiguity arises when you ask for a very common Entity that might be present in many Topics.

  • Question: "Show me the breakdown of sales”

  • Ambiguity: “sales”

  • Candidate Topics:

    • "sales by region" (Custom Entity)

    • "sales by category" (Custom Entity)

Partial Match

Topics partially match if they contain only some of the requested Entities.

This ambiguity arises when you ask for an Entity that is not present in any Topic.

In this case, Crystal tries to disambiguate by retrieving Topics that come close to the requested Entity.

  • Question: "Bring me up the count of sales”

  • Ambiguity: “count of sales”

  • Candidate Topics (the Topic "count of sales" does not exist):

    • "total of net sales volume actual"

    • "total of net sales value actual"

Ambiguous Aggregations of Entities

This ambiguity happens when there are multiple Topics containing the same Entity and differing only in the aggregation function (sum, count, total, etc.).

In this case, Crystal returns the list of Custom Entities that are actually available.

  • Question: "Show me the cost”

  • Ambiguity: “cost”

  • Candidate Topics:

    • "total of cost"

    • "average cost"

Ambiguous Values of Filters

In this case, Crystal returns the actually available values for that Filter.

  • Question: “Show me the total sales in America”

  • Ambiguity: “America”

  • Candidate Filter Values:

    • "North America"

    • "South America"

Please Note

In this disambiguation scenario, in contrast to all the other ones, it is possible for you to select more than one Filter Value at once, if needed.

Ambiguous Time Aggregators

This ambiguity happens when there are multiple Overtime Topics differing only in the time aggregator.

  • Question: "What's the tax overtime?”

  • Ambiguity: “time aggregator”

  • Candidate Topics:

    • "tax over time (by day)"

    • "tax over time (by semester)"

    • "tax over time (by quarter)"

Ambiguous Source Tables

In this case, Crystal will ask you to choose the correct source table for the Entity.

Keep talking to your data!


During a conversation with Crystal, you need to resolve an ambiguity about a topic for two reasons; either to specify a topic directly or to on a Topic. E.g. "give me the breakdown of sales" or "notify me about the breakdown of sales" (breakdown of sales = topic).

In this case, Crystal tries to disambiguate based on the granularity of the .

This ambiguity happens when the question contains a Filter Value that does not exist but other values.

From you can do this using the "Select all" / "Deselect all" button!

In the context of , Entities with the same name might be detected.

activate some other capability
Custom Entities
partially matches
Release 2.58
Entity-Based Conversation
Ambiguous Entities
Ambiguous Aggregations of Entities
Ambiguous Values of Filters
Ambiguous Time Aggregators
Disambiguation Options
Full Match Entity Ambiguity
Partial Match Entity Ambiguity
Aggregation Ambiguity
Partially Matching Filter Values Ambiguity
Select All
Deselect All
Time Aggregator Ambiguity