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
  • The Steps of Topic Creation
  • Connect
  • Configure
  • Filter
  • Train
  • Complete
  • Summary

Was this helpful?

  1. Crystal Console
  2. Create Topics

Topic Creation: Overview

This page is currently under review. Stay tuned!

PreviousCreate TopicsNextTopic Creation: Connect

Last updated 1 year ago

Was this helpful?

In the Crystal world, a Topic is a subject related to your business metrics that you can talk to Crystal about. A topic is an insight on your data that you can get from crystal.

You can get an overview of Topics .

Topics can only be created by the Admins. For Admins, in fact, Topics are one of the most crucial parts of the crystal experience: this is the reason why they should spend the majority of their time , setting up Topics.

The Topic Management Area is where the topic creation and management processes take place. Here you can either find and manage the already existing topics and add new ones, according to your needs.

But how does this process work? Let’s see.

The Steps of Topic Creation

Topics are created through a four-step process.

Connect

Connect a data source and select the specific tables that hold the desired data for your topic.

In order to retrieve insights on your business, crystal needs to get data from somewhere! That’s why the first step in the topic creation process is called connect. During this phase the Admins will connect a data source (i.e., database or data warehouse systems) and build topics around that data.

They will also choose the tables to use for the configuration.

Configure

Configure a topic by setting its objective and the related visualization type and selecting specific columns and parameters (e.g. establishing a ranking among values or comparing different values).

During this passage, Admins will choose the topic’s objective based on their needs and on what they want to achieve with that data: for example, a comparison among different data, a ranking of data or an over time progression. Each objective could be visually represented by one or more visualizations, for example a single line chart, a table or a donut chart.

Based on the objective you’ve chosen, you'll be guided through selecting the ideal visualization for your topic, in order to shape your data and express valuable insight.

In this phase Admins will have to select the specific columns from the data source’s tables to involve in the topic creation and they will decide whether to group or aggregate data in a certain way. This phase is crucial because it determines how the topic will be.

Note that every combination of objective and visualization has a different configuration with different fields to be completed.

Filter

Once you’ve created your visualizations, you can optionally add filters to drill down on specific data within the charts, such as zoning in on a specific country or timeframe for your sales data.

This is the only non-mandatory step of the topic creation process. Admins can decide to add filters (for example, for country) to their topic in order to better detail the questions and to enrich the conversational experience for the members: such filters will, in fact, be available for the queries. It is therefore highly recommended to use filters.

For example, if the topic is Sales over time, a filter might be “in Italy”, if referred to the column “country”.

Train

The train step is the fourth and final step of creating a topic. In this stage, admins will help train crystal, so that she will be able to understand the users' requests and their language and to learn the business specific words and jargon.

To do so, they will have to define entities and aliases, which are name variations or trigger words that refer to the metrics used when talking to crystal to make sure she provides the right insights. For example, if a topic is named Sales, the alias could be Incomes: during the conversation, the advisor will understand that both words refer to the same topic.

During the train step, the system will suggest some sample questions to ask crystal based on the chosen configuration.

Complete

Finally, you’ll decide who can see the topic by setting permissions and ask crystal about it, review and publish it!

After the topic creation process is completed, there are still two passages to go through before the topic is ready for the conversation: the first one is to assign permissions, or, in other words, to decide which member users will be able to see this topic in the advisor and in the Dashboard and ask questions about it.

The second one is publishing: a topic can be kept in draft or ready status, but it’s only when it is published that it will be available for members and their questions during the conversation.

Summary

In summary, you’ll need to follow this flow to create topics for asking questions to your advisor:

Check the specific articles to know more about each step!


Once you have selected the to build your topic, you have to select its . An objective is essentially the insight you want to get out of this data (such as a comparison, ranking or progress overview of your data).

(you should only have to do this a few times)

for your topic

for topic

to your objectives

for your data

for topics

topics

Setting permissions
Reviewing & publishing
here
in the Console
objective
Setting an objective and a visualization
Defining entities
data
Selecting data tables
Adding filters
Adding a data source