First Query

The First Query page provides an interactive, guided demonstration of the MATIH conversational analytics experience. Users compose their first natural language question, see the AI generate SQL, visualize results, and experience the full query lifecycle in a supported environment.

Page Layout

The First Query page (FirstQueryPage.tsx) is divided into two panels:

Guided Experience

The page walks users through the query lifecycle in four stages:

Stage 1: Ask a Question

The user types a natural language question in the chat input. Suggested queries are provided based on the connected schema or sample dataset:

Stage 2: Watch the AI Work

The interface shows the agent pipeline processing the query in real-time:

Stage 3: Explore Results

Results are displayed with interactive elements:

interface QueryResult {
  sql: string;
  data: {
    columns: string[];
    rows: any[][];
  };
  visualization: {
    type: string;
    config: object;
  };
  insights: string[];
  explanation: string;
}

Stage 4: Refine and Follow Up

Users are encouraged to try refinement actions:

Sample Dataset

For users who skipped the connection setup, a sample dataset is provided:

Progress Indicators

Visual cues guide the user through the experience:

Completion

After completing the first query, the user sees a summary:

• Congratulations message
• Recap of what they accomplished
• Quick links to the main workbench, dashboard builder, and documentation
• Option to try more queries or proceed to the platform

Analytics