Ana operates in different modes that guide its behavior and capabilities. Each mode serves a specific purpose in helping you get answers to your questions.

​
Available Modes

​
Core Modes

IdleYour starting point for conversations with Ana. This is where you ask questions and begin new interactions.
HelpWhen Ana needs clarification or additional information to better understand your request.
MetaFor questions about TextQL’s features and capabilities.
QueryAna searches for relevant datasets, including metrics, tables, and dashboards to answer your question.
PlanAna creates a step-by-step plan to answer your analytical questions.
DoneAna presents the final answer to your question, along with any visualizations or data.

​
Analysis Modes

CleanupAna prepares and formats data to ensure accurate analysis.
AnalyzeAna processes data using Python to perform calculations and analysis.
VisualizeAna creates charts and graphs to help you understand the data.
ReviewAna checks if the found datasets contain the information needed to answer your question.

​
Mode Transitions

Common flows:
  1. Question Flow: IDLE → QUERY → PLAN → ANALYZE → DONE
  2. Data Preparation: QUERY → REVIEW → CLEANUP → ANALYZE
  3. Visualization Flow: ANALYZE → VISUALIZE → DONE
  4. Help Flow: Any Mode → HELP → Previous Mode
Dakota State Machine

Mode Flow Diagram showing common transitions between modes. See also Dakota Framework


​
Modes

​
Cleanup

Cleanup mode is where Ana prepares data for analysis by filtering, joining, or transforming it using Python. This mode ensures data is in the correct format and structure before detailed analysis begins.
Cleanup Mode

Cleanup mode with data preparation.

If you’re technical, review Ana’s data transformations to ensure the cleaning operations maintain data integrity while preparing it for analysis.

  • When data needs filtering or transformation
  • If datasets need to be joined or merged
  • To standardize data formats (dates, numbers)
  • When removing unwanted columns or rows
  • To handle missing or invalid data
  • Before complex analysis operations

​
Done

Done mode is where Ana presents the final answer to your question. In this mode, Ana formats the answer clearly and concisely, making it easy to understand the results of the analysis.
Done Mode

Done mode with result summary.

Make sure to check for any generated files or visualizations that Ana has prepared for download, and review the final results.

  • After finding a direct answer
  • When analysis is complete
  • After creating visualizations
  • When data has been processed
  • If a file is ready for download

​
Help

Help mode is where Ana asks for clarification when your question isn’t clear enough or when Ana needs additional information to proceed. This mode ensures Ana understands exactly what you’re looking for.
Help Mode

Help mode with clarification request.

Pay attention to Ana’s specific requests for clarification - she’ll highlight exactly what information she needs to better understand your question.

  • Your question isn’t clear enough
  • Critical information is missing
  • Ana can’t find the data you’re asking about
  • You’re asking for SQL queries (which Ana can’t provide)
  • Questions about system administration
  • Non-data-related requests

​
Idle

Idle mode is Ana’s default state for casual conversation and determining how to handle your questions. In this mode, Ana evaluates your input and decides whether to start planning an analysis or ask for clarification.
Idle Mode

Idle mode indicator and conversation interface.


  • At the start of every new conversation
  • After completing a previous task
  • When receiving casual, non-analytical messages
  • When evaluating if a question needs to be re-approached

​
Meta

Meta mode is activated when you ask questions about the TextQL system itself, such as how to upload datasets or configure warehouse connectors. In this mode, Ana will explain that it cannot directly help with system-level questions.
If you find yourself at a dead end in the chat, look for Ana’s guidance about who to contact or which documentation to reference for system-level questions.

  • When you ask about uploading datasets
  • If you inquire about warehouse connectors
  • For questions about system configuration
  • When asking about Ana’s capabilities
  • For product feature questions

​
Plan

Plan mode is where Ana breaks down complex questions into clear, actionable steps. In this mode, Ana assesses available data, declares assumptions, and creates a structured approach to find your answer.
Plan Mode

Plan mode with step breakdown

If you’re familiar with data analysis, verify that Ana’s planned approach and assumptions align with your expectations.

  • When receiving a new question
  • After discovering relevant data
  • When adjusting analysis strategy
  • If assumptions need verification
  • Before starting complex analysis
  • When current approach needs revision

​
Query

Query mode is where Ana searches for and retrieves data using specialized tools like Search, Object Explorer, and Metric Explorer. In this mode, Ana carefully reviews available datasets to find exactly what you need.
Make sure to review Ana’s search results and data previews to confirm she’s found the right datasets for your analysis.

  • After planning how to answer your question
  • When searching for specific metrics or datasets
  • To explore available data sources
  • When checking data availability
  • If previous search results need refinement
  • Before starting data analysis

​
Review

Review mode is where Ana examines available data to determine if it matches your needs. In this mode, Ana carefully checks metrics and datasets to ensure they contain the information you’re looking for.
Make sure to verify that the available data and metrics Ana has found align with what you need for your analysis.

  • After searching for data
  • When checking metric relevance
  • Before starting analysis
  • If assumptions need validation
  • When verifying data completeness

​
Visualize

Visualize mode is where Ana creates visual representations of your data using Python plotting libraries. This mode transforms analyzed data into clear, meaningful charts, graphs, and maps to help you understand patterns and relationships.
Vizualize Mode

Visualize mode with chart creation

Review the generated visualizations to ensure they effectively represent your data and communicate the intended insights. You can always ask ana to revise her plot or approach.

  • After analyzing data
  • To show trends or patterns
  • When comparing values
  • For geographic data visualization
  • To present final results
  • When data relationships need clarity

​
Analyze

Analyze mode is where Ana performs calculations and data analysis using Python. In this mode, Ana processes data in a sandboxed environment to perform calculations, generate statistics, and identify patterns. For detailed information about Python capabilities, see the Python Analysis Tool documentation.
Analyze Mode

Analyze mode with Python output.

If you’re technical, make sure to visually inspect the Python code and outputs to confirm Ana approached your problem in the desired way.

  • When any calculations are needed (even simple math)
  • For statistical analysis and summaries
  • To identify patterns in data
  • When aggregating or grouping data
  • If filtering or transforming data
  • When preparing data for visualization

​
Tips for Working with Modes

  1. Watch the Mode Indicator: Ana always shows its current mode at the top of the chat. This helps you understand what Ana is doing.
  2. Provide Clear Information: When Ana enters HELP mode, provide specific details to help it better understand your request.
  3. Review Transitions: If Ana seems stuck, check which mode it’s in. The mode often indicates what information Ana needs to proceed.
  4. Use Mode-Specific Features: Some modes offer special features - for example, in VISUALIZE mode you can request different chart types.

​
Custom Modes

TextQL works closely with customers to develop specialized modes that enhance their interaction with data and analytics. While our standard modes cover many common use cases, we understand that organizations often have unique requirements that may benefit from custom-built modes. A custom mode could be valuable when your team has specific workflows, analysis patterns, or interaction requirements that differ from our standard offerings. For example, if your organization follows a particular methodology for data analysis or requires specialized validation steps, we can create a mode that aligns perfectly with your process. We encourage you to explore our existing capabilities first, as they are built on proven patterns and best practices. However, if you find that your needs extend beyond these capabilities, we’re eager to discuss how we can develop a custom mode that serves your specific use case. To explore custom mode development for your organization, please reach out to support@textql.com. We’ll work together to understand your requirements and design a solution that enhances your team’s effectiveness with TextQL.