AI Insights Assistant
AI Insights Assistant - User Guide
1. Introduction 📝
AI Insights is a next-generation data exploration tool that allows you to talk to your ERP data in plain English. Instead of navigating complex menus or building manual reports, you can simply ask questions like “What was my sales growth last month?” or “Show me top 5 slow-moving items.” The AI assistant instantly translates your request into a data table and a visual chart.
Key Objectives of AI Insights:
- Frictionless Reporting: Get answers instantly without technical expertise.
- Visual Discovery: Automatically convert raw numbers into Bar, Line, and Donut charts.
- Authorized Access: Ensure sensitive data stays protected through role-based category filtering.
2. Interface Walkthrough 🏗️
Accessing the Module
To access the AI Insights Assistant, navigate to System Tools > Other Masters > AI Insights from the main menu.
The AI Assistant Interface
The AI Insights dashboard is designed to be as simple as an intelligent conversational console:
- Header Bar: Features an active status badge: “Free During Preview — Unlimited Access!”.
- Data Source Selection: A category dropdown to designate the operational scope (e.g., BOM, Sales Analysis, Inventory Trends).
- Conversational Input: An interactive autocomplete input bar where you can type questions in natural language.
- Suggested Prompts & Cards: Provides recommended questions as you type, alongside clickable prompt cards (e.g., “Top selling items”, “Sales trend this year”).
- Send & Reset Controls:
- Send: Submits your prompt to generate structured data insights.
- Reset (
RestartAlt): Clears the conversation history to start a fresh analytics thread.

3. How it Works (The Prompt System) 🏗️
The system organizes its “knowledge” into Data Sources (Categories).
A. Data Categories
Before asking a question, you select a category (e.g., Sales Analysis, Inventory Trends, Financial Summaries). This tells the AI which part of the database to look at.
- Note: You will only see categories that your user role is authorized to access.
B. Suggested Prompts
To help you get started, the system provides Suggested Prompts via the autocomplete search bar. These are pre-tested questions that provide high-value insights.
4. Visualizations & KPI Cards 📊
AI Insights provides multi-dimensional data presentation for every query:
A. Executive KPI Stat Cards
Above the detailed results, the assistant generates high-level summary cards displaying key metrics at a glance:
- Highest: Flags the maximum recorded value (green badge) with contextual entity details.
- Lowest: Highlights the minimum recorded point (red badge).
- Average: Computes the baseline mean value (blue badge).
B. Tabbed Presentation: Tables & Charts
Every response includes a tab switcher to toggle between:
- Table View: A sticky-header data grid with horizontal scrolling and quick Excel export.
- Chart View: High-resolution interactive charts with multiple layout toggles:
- Horizontal Bar (H-Bar): Ideal for ranked comparisons (e.g., top customers).
- Vertical Bar: Standard category-to-value comparisons.
- Line Chart: Trend analysis over time intervals.
- Donut Chart: Proportionate part-to-whole distributions.
5. Features & Actions 📥
Once the AI generates an insight, you have several tools at your disposal:
- Export to Excel: Click the Download Table icon to export the tabular dataset into a
.xlsxspreadsheet. - Download Chart: Click the Download Chart icon to save the rendered chart image directly to your device.
- Reset / Restart Chat: Click the Reset button (
RestartAlt) in the input bar to clear previous queries and reinitialize the conversational buffer. - Session History: The scrollable chat area preserves insights generated during the active session for comparative review.
6. Usage Constraints & Credits 🛡️
🪙 Preview Period & Credit Model
- Active Preview Status: Currently operating with Free During Preview — Unlimited Access, enabling teams to explore intelligent reporting without credit deduction.
- Production Credit Model: In standard deployment, the system tracks credit quotas per query. If credits are exhausted, the send action is disabled until top-up.
✅ Accuracy Disclaimer
While the AI model is highly capable, natural language interpretations may occasionally require validation. Always cross-check critical financial and tax totals with statutory core ledgers.
7. Common Troubleshooting 🔍
“No Data Found”
- Possible Cause: Your query was too specific or referenced items/dates that don’t exist in the database.
- Solution: Try a broader prompt or one of the “Suggested Prompts” for that category.
“Please Contact System Administrator”
- Possible Cause: The AI Insights feature is not enabled for your database, or your user role lacks the necessary permissions.
“Credits Exhausted”
- Possible Cause: Your company has reached its monthly AI usage limit.
8. Best Practices 💡
- Start with Suggestions: Use the autocomplete suggestions to understand how to phrase your own custom questions.
- Specify Timeframes: Include dates in your prompts (e.g., “in the last 30 days” or “for the year 2024”) for more accurate results.
- Review Column Headers: Interactive tables allow you to see the exact field names used by the AI—this can help you refine your next question.