Interacting with Dialogs Bot in Slack
Overview
This section describes how to interact with the Dialogs Bot in Slack, whether in a private or a group chat.
Important
Ensure that queries shared in group chats do not expose sensitive or restricted information, as responses are visible to all participants. Users with different Row-Level Security (RLS) permissions may be able to view responses in a group chat that exceed their individual access rights.
To interact with the Dialogs bot in a group chat, always type @Dialogs followed by your question.
For example:@Dialogs Show sales performanceTo interact with the Dialogs bot in a private chat, type your question without adding @Dialogs.
The procedure for chatting in a channel or individually using the Dialogs bot in Slack remains the same.
Using Dialogs bot in Slack
To begin using the Dialogs bot in Slack during a chat, follow these steps.
When accessing the Dialogs bot application for the first time, you are prompted to sign in using your Slack credentials.
Click Sign In. The IDP login page (OAuth provider) is displayed.
After you sign in to the Dialogs bot, a list of available AI spaces in your Kyvos environment is displayed.
Select an AI Space from the list. The selected data space is activated and displayed.
Sample questions appear for the selected data space. You can view these questions after signing in to the Dialogs Bot, provided that the corresponding entity mapping (AI Space) is already configured for your account.
You can also change the active data space at any time by selecting Switch Space. A list of available AI Spaces and semantic models is displayed for selection.
When more AI spaces and semantic models exist, the Show more button appears. Click it to refresh the list and display additional AI spaces and semantic models.
Now, type your query in the Slack message box and press Enter. The key insights are generated based on your query.
Note
The key insights for single-row and single-column data will be provided in the text. If the data exceeds, the information will be presented in a tabular format.
The option to download the data in CSV format is available only when the tabular data exceeds the configured record limit. This threshold can be configured using the
CSV_ROW_THRESHOLDproperty in the.envfile included in thekyvosbotserver.zippackage.You can view the results in a separate HTML page for improved readability.
Key Insights for single-row and single column data
In a Private Chat | In a Slack Channel |
|---|---|
|
|
Key insights in tabular format
In a Private Chat | In a Slack Channel |
|---|---|
|
|
To begin a new conversation, type
\\followed by your query. For example, \\ show sales for 2023.Within the Key Insights window, you can perform the following actions:
More Info: Select this option to view query details and generated SQL of the selected data space, including the data space name, query text, total rows, and columns.
To use commands, type Help to view available commands and usage information. Click the required command or type it in the message box.
Current Space: Use this command to view the active data space.
Switch Space: Use this command to change the active data space. A list of available AI Spaces and semantic models is displayed.
Show Space: Use this command to view all available AI Spaces in your Kyvos environment.
Sign in: Use this command to access your account.
Sign Out: Use this command to exit from your account.
Help: Use this command to display this guide.
Adding the Dialogs bot to a Channel
To add the Dialogs Bot to a Slack channel, perform the following steps.
Open the Dialogs app by searching for it under Tools > Apps and clicking Open App.
In the Dialogs app, click the channel name or app name at the top of the conversation window.
In the message box, enter forward slash (/) and then select Add apps to this channel.
Search for and select the channel where you want to add the Dialogs bot.
Click Add to invite the Dialogs bot to the selected channel.
Verify that the Dialogs bot appears as a member of the channel and is ready to interact with users.
To initiate the conversation in a channel, you must type @Dialogs in the message box.
Note
You must have the required permissions to add apps to a Slack channel. Some workspaces may restrict app installation or channel access.