> ## Documentation Index
> Fetch the complete documentation index at: https://wisdomai-add-trigger-agent-api.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# How WisdomAI Works

WisdomAI is a platform that helps businesses analyze their data and make informed decisions. It allows users to ask questions in plain English and receive clear, data-driven answers and visualizations, without the need for coding or manual dashboard creation.

## What Does WisdomAI Do?

WisdomAI transforms your company's raw data into actionable insights through several key capabilities:

<Columns cols={2}>
  <Card title="Understands Your Questions" icon="comments">
    You can ask questions in everyday language, like "What was our revenue last quarter?" or "Which products are selling best?" WisdomAI uses advanced Natural Language Processing (NLP) to understand what you're asking.
  </Card>

  <Card title="Connects to Your Data" icon="database">
    It seamlessly connects to various data sources your business uses, such as databases like PostgreSQL and SQL Server, or data warehouses like Snowflake and Google BigQuery.
  </Card>
</Columns>

<Columns cols={2}>
  <Card title="Organizes Your Business Data" icon="sitemap">
    WisdomAI helps you organize your data into domains that represent different parts of your business, like Sales or Marketing. This makes your data more relevant and easier for everyone to use.
  </Card>

  <Card title="Turns Answers into Stories" icon="chart-simple">
    Instead of just giving you numbers, WisdomAI can create interactive **Stories** and dashboards with charts and text. These stories update automatically as your data changes, making it easy to share insights across your team.
  </Card>
</Columns>

<Columns cols={2}>
  <Card title="Automates Workflows" icon="robot">
    You can set up Playbooks to automate common analytical tasks and standardize how your team analyzes specific business questions.
  </Card>

  <Card title="Learns and Improves" icon="lightbulb">
    WisdomAI continuously gets smarter based on user feedback. When you provide corrections or refine questions, the system learns to give even better answers in the future.
  </Card>
</Columns>

This means WisdomAI helps you quickly get the information you need from your data, making data-driven decisions simpler and faster for everyone.

## Who Uses WisdomAI?

WisdomAI is built for all kinds of businesses, from small startups to large corporations, across various industries. It's designed to be useful for different roles within your organization:

<Columns cols={2}>
  <Card title="Adminis" icon="screwdriver-wrench">
    These are typically IT or BI directors who set up WisdomAI, connect it to your data sources, manage user access, and define the overall structure of your data in the platform.
  </Card>

  <Card title="Explorers" icon="users">
    This group includes business users, executives, and other stakeholders who use WisdomAI to ask questions, view reports, run stories, execute playbooks, and export insights for their daily work.
  </Card>
</Columns>

<Tip>
  This documentation is devided in a way you can focus on what matters most to your role. For more information on each role, visit the [Where to Start](/getting-started/overview#where-to-start%3F) section.
</Tip>

## WisdomAI vs Generic RAG Systems

Unlike generic Retrieval-Augmented Generation (RAG) solutions that rely purely on embedding search over documents, WisdomAI builds a structured understanding of your data through semantic modeling, curated context, and validated logic.

| **Feature**                       | **WisdomAI** | **Generic RAG** |
| --------------------------------- | ------------ | --------------- |
| Understands data relationships    | ✅            | ❌               |
| Requires semantic modeling        | ✅            | ❌               |
| Validated, testable logic         | ✅            | ❌               |
| Dynamic, auto-updating dashboards | ✅            | ❌               |
| Tailored for business data        | ✅            | ❌               |

<Tip>
  WisdomAI is purpose-built for enterprise analytics, not just document Q\&A.
</Tip>

## Data Flow & Architecture Overview

WisdomAI transforms your business data into actionable insights using a multi-layered pipeline. The following components work together to deliver accurate, contextualized answers and auto-updating data stories.

```mermaid
%%{ init: { 'themeVariables': { 'fontSize': '14px' } } }%%
flowchart TD
  subgraph Data_Pipeline [ ]
    direction TB
    A[Connected Data Sources] --> B[Semantic Modeling Layer]
    B --> C[Natural Language Query Engine]
    C --> D[Answer Generation & Story Builder]
    D --> E[Delivery & Reporting Layer]
    E --> F[User Feedback & Corrections]
    F --> G[Context Updates & Review]
    G --> B
  end

  UserInput([User Input]) --> A
```

<Steps>
  <Step title="Connected Data Sources" stepNumber={1} titleSize="h3">
    WisdomAI integrates with your data platforms (like Snowflake, BigQuery, or Redshift), acting as the entry point of all information flowing through the system.
  </Step>

  <Step title="Semantic Modeling" stepNumber={2} titleSize="h3">
    Admins and data owners enrich the data by documenting tables, columns, and domains. They also define relationships (e.g., one-to-many, many-to-many) to create a business-friendly context for natural language understanding.
  </Step>

  <Step title="Natural Language Query (NLQ) Engine" stepNumber={3} titleSize="h3">
    Users ask questions in plain language. The NLQ engine parses these questions and translates them into SQL queries using the underlying semantic model.
  </Step>

  <Step title="Answer Generation and Story Builder" stepNumber={4} titleSize="h3">
    Responses are generated and formatted into interactive "Stories", data-driven narratives that combine visualizations, text, and insights. These can be scheduled and shared.
  </Step>

  <Step title="Delivery and Reporting Layer" stepNumber={5} titleSize="h3">
    Stories and answers can be delivered via email or embedded within dashboards, helping teams stay informed with minimal effort.
  </Step>

  <Step title="User Feedback and Corrections" stepNumber={6} titleSize="h3">
    Users can give feedback on story accuracy, suggest corrections, or add clarifying context to improve future results.
  </Step>

  <Step title="Context Updates and Review Loop" stepNumber={7} titleSize="h3">
    Admins and Editors review user feedback and update the semantic layer accordingly, closing the loop and continuously improving answer quality and domain understanding.
  </Step>
</Steps>

## Next Steps

* [Supported Data Sources](/getting-started/supported-data-sources)
* [Basic Tutorial Connect and Test](/setting-up-wisdom-ai/basic-tutorial-connect-and-test)
* [Advanced Data Modeling: Creating Knowledge](/setting-up-wisdom-ai/advanced-data-modeling-creating-knowledge)
* [Provide Feedback to the System](/setting-up-wisdom-ai/provide-feedback-to-the-system)
* [Turn Answers into Stories](/using-wisdom-ai-everyday/turn-answers-into-stories)