Skip to main content

Querying Your Data

Once your Sphere is configured, you can start asking questions using the chat interface.

The chat interface is your primary workspace. Simply type questions in natural language, and DataSphere will translate them into a series of tasks to give you answers.

Conversation Starters​

The buttons above the input field are Conversation Starters. These are pre-configured examples designed to demonstrate the types of questions your Sphere can handle. Click a starter to start the conversation immediately.

Customize Your Starters

You can modify these questions in the Customization tab to better fit your team's needs.

DeepSphere​

Below the text input, you will find the DeepSphere toggle. This controls the depth of the AI's analysis.

  • Disabled (default mode): Optimized for speed and direct answers. Best for straightforward questions like, "How many users signed up last month?"
  • Enabled (deep analysis mode): Performs a comprehensive, multi-step analysis. The AI may break your question into sub-queries to provide a detailed narrative or comparative insight. Best for exploratory questions like, "Analyze sales trends for our top 3 product categories over the last year."
Credit Consumption

DeepSphere consumes more credits per query because it involves complex reasoning and multiple interactions with the AI model.

Message Actions​

Each message in the chat offers specific actions to help you manage your workflow:

  • Copy message: Copies the text response to your clipboard.
  • Flag message: Reports the message for incorrect results or logic errors.
  • View executed queries: Reveals the underlying SQL query (or queries) used to retrieve data to generate the data-driven response.
note

The View executed queries action only appears on messages where a database query was actually performed.

Executed Queries Dialog​

Clicking View executed queries opens a dialog box showing the exact SQL queries generated by DataSphere.

If a message required multiple queries, the dialog box displays all of them. Use the arrow buttons at the bottom left to navigate through the list. A counter (e.g., Showing 1 of 2 queries) indicates which query is currently displayed.

You can copy the current query to your clipboard to run it directly in BigQuery Studio.

Asking Effective Questions​

The quality of your input directly affects the quality of the output. Follow these tips for the best results:

  • Be specific: Instead of "show me sales," ask "What were the total sales in USD for October 2025?"
  • Define the scope: If you want a comparison, state it clearly. "Compare the number of new users from 'Google' vs. 'Facebook' traffic sources."
  • Use column names: While optional, using exact table or column names helps DataSphere give you more accurate results with fewer prompts. For example, instead of "What is the average order value?", use "What is the average order_value from the orders table?"