Omni Application – Setup Guide
Welcome to illumex’s Omni assistant for self-service data and analytics access.
Omni is an intelligent dialogue experience, enabling self-serve data exploration while ensuring proper governance. This democratizes analytics by allowing business users to quickly get data-driven insights through a conversational experience.
This guide will help you get started with setting up, using, and troubleshooting Omni’s Slack app. Follow the steps below to make the most out of your experience.
1. Installation Guide
Prerequisites
Before you start, please make sure:
- You have a Slack workspace where you can install the app.
- You have the appropriate permissions to add new apps to your Slack workspace.
Step-by-Step Installation
- (Slack-workspace Admin only) Add the app to your organization’s workspace:
Click on the below button or visit illumex Omni’s Slack App download page
- Click on Allow
- Sign-In into illumex’s platform with your credentials
2. Add the App to Slack:
- Open Slack for Desktop UI’s Home Screen
- Visit the App Marketplace by clicking on Apps -> Manage -> Browse Apps
- Search for illumex Omni Slack App.
- Clicking on the App’s logo will redirect you to the Omni App’s chat
3. Authorize the App:
- Omni’s Slack app does not require any special authorization configuration process. Instead, it simply matches your Slack email with your illumex user account. Here’s what you need to ensure:
- Email Match: Make sure your Slack user email is the same as your registered email with illumex.
- illumex User Setup: As long as you have an active user profile in illumex, you can immediately start using the app without any additional setup.
- Omni’s Slack app does not require any special authorization configuration process. Instead, it simply matches your Slack email with your illumex user account. Here’s what you need to ensure:
ℹ️ Note: If you encounter any access issues, verify that your Slack email matches your illumex application account email. If they differ, please update one of the emails or contact your illumex admin for assistance.
4. Verify Installation:
- You will see a default first message from Omni in its dedicated app channel, confirming the successful installation.
ℹ️ Note: If you encounter any issues during installation, refer to the Troubleshooting section below
2. Getting Started
Omni is ready for use right out of the box—no special configurations or onboarding required. Once installed:
- Simply type your question directly – You can ask definition questions (e.g., “What is a DAU?”) or analytical questions (e.g., “Show me the sales gross margin for the last quarter”).
- Are you feeling overwhelmed? You can always type “what can I ask you?” in the app’s channel to get your own personalized examples of Omni’s capabilities.
🏆 Pro Tip: Bookmark the app in your Slack workspace for quick access by ☆ the conversation.
3. How to Use Omni
Omni offers a range of features to help streamline your analytic tasks. Here’s how you can use some of the key functions:
- Information Retrieval: provide users with precise and factual information to specific business-related inquiries.
Typically involves direct questions requesting definitions or explanations of business terms, like: “what’s the description of …”, “how do we define …” , “what is …” - Analytical Translation: interpret and provide reasoning to an analytical query.
Typically involves explanatory requests where users ask for the answer of a non-technical data representation, like: “calculate the …”, “list all …”, “count how many …”, “what is our …”
Omni is also designed to offer maximum flexibility based on your preferences. When you ask a question, you have two options:
1. Let Omni Decide – Full Autonomous Response
- Omni automatically interprets your question and provides the most relevant answer based on its understanding, without any follow up questions.
- This is perfect for quick queries where you want instant insights without having to be familiar with your data model or catalog.
2. Let Me Choose – User’s Interactive Selection
- If you prefer more control, Omni always presents multiple relevant options based on your question.
- You can then select the specific information that best matches your needs using interactive buttons.
- Not sure which option best fits your question? You can always click on “Let Omni Decide”.
🏆Pro Tip: Need a better understanding of one of the listed options? Use the highlighted links to visit the entity in illumex’s platform, for further insights.
4. Troubleshooting
Here are some common issues and how to resolve them:
Issue 1: “I can’t install the app in Slack.”
- Solution: Ensure you have sufficient permissions in your Slack workspace. Contact your workspace admin to verify your permissions.
Issue 2: “The app isn’t responding to questions.”
- Solution: Make sure you are sending your question correctly – On Omni’s app message window, type “Hello” and hit the Enter button, to verify your connectivity with the app. If the issue persists, contact [email protected]
Issue 3: “I see an error message when trying to ask a question.”
- Solution: contact [email protected] with the error message attached.
