Add a new miner

In bots, intents describe a goal or task that a user wants to do, such as tracking their package or booking a cab. A user interacts with a bot to resolve their intent. 

Intent miner searches a historical set of recording data, specifically chat or voice transcripts, between agents and customers for a specified duration of time. Next, it extracts the top set of intents and the analytics that surround those intents. Finally, it returns a list of utterances that the system associates with that intent to allow for import into a bot configuration. 

When you create a new intent miner, you select the date range for conversations that you want the miner to include in the search. The miner fetches all conversations that occur within the date range and deduces the dominant intents that are present. Then the miner anonymizes customer utterances, computes analytics, and associates the utterances with the intents before returning the results to you.

When you select to mine intents for a new mining session, a progress bar appears in the tile to display the current mining status. The number of conversations mined can impact the length of the mining process. Depending on the data source and the media time, mining the maximum number of conversations can take up to 24 hours. Most this time is spent fetching the conversation transcripts. When complete, the miner contains a list of mined intents. Now, you can choose utterances for the mined intents.

Status Description
Fetching Conversations The system is importing conversations within the specified date range.
Mining Intents The system is searching for intents in conversations within the specified date range.
Masking Utterances The system is in the process of redacting personal data. For example, customer name or account information.
Computing Analytics The system is computing intent analytics.
Mining Completed The system successfully mined the appropriate number of intents, and you can begin to customize the intents and utterances.
Fetching Error An error occurred during the conversation retrieval. For example, the system found no conversations in the specified date range. Or, the minimum of 50 conversations was not met, or the minimum of 40 valid or nonempty conversations was not met. To view details about the error, hover over the Fetching Error status.
Mining Error An error occurred during the mining of intents. For example, the minimum of 20 valid intent-bearing utterances was not met in the entire set of conversations.
Masking Error An error occurred during the anonymization of utterances. Usually, restarting the mining process fixes the issue.

Create a new intent miner 

You can create a new intent miner from Genesys Cloud, or you can create a new intent miner by importing a .json file from an external source.

To create a new intent miner, perform the following steps:

  1. Access the intent miner home page from the link provided by your administrator.
  2. Click Create a new Miner. The Create a new Miner dialog box opens.
  3. Under Name, add a descriptive name for the miner.
  4. Under Language, leave the default en-us setting.
    Note: Currently, intent mining is only available in United States English. 
  5. To mine data from Genesys Cloud, perform these steps:
    1. Under Data Source, select Genesys Cloud.
    2. Under Date range, use the calendars to select the date range in which the miner mines conversations between the agent and the customer.
      Note: The conversations limit is 10,000.
    3. Under Media Type, select whether to mine intents from chat transcripts or call transcripts.
    4. Click Select Queues and select up to five queues from which to mine transcripts.
      Note: If you do not specify any queues, the system selects all queues by default.
  6. To upload a file from another source, perform these steps: 
    1. Under Data Source, select External File.
    2. Under File upload, click Click to upload.
    3. Select and upload the JSON file source.
      Note: To download and format conversation data from a preformatted template, click Example JSON file or download this example.
  7. Click Confirm.

The mining process begins. If an error occurs, you can open the session, review and correct the error, and then restart the session.