Skip to main content
Ask Anything supports several input tools that help you ask precise, well-scoped questions. This page covers each one and when to use it.

​
Plain Language Questions

Type your question in plain English. The agent translates business language into SQL, so ask the way you’d ask a colleague on the data team. Examples:
  • “What was our conversion rate last week?”
  • “Show me the top 10 events by volume this month”
  • “Compare daily active users between iOS and Android”

​
Mentions (@)

Type @ to reference a specific component from your Semantic Catalog. A dropdown appears with your available metrics, features, segments, and entities — and, under a Files group, any files in your Context Layer. Mentions ensure the agent uses the exact business definition you intend — rather than searching and potentially picking the wrong one. Example: “What is @Monthly Revenue broken down by country?”
Mentions are the most reliable way to point the agent to the right component. Use them whenever you’re referencing a specific metric, segment, or entity.

​
Files in a Chat

Files work in both directions in a conversation: you can bring one in, and you can ask the agent to produce one.

​
Attaching a File to Your Question

Use the attach button in the composer, or paste or drag a file straight into it. Attachments belong to that conversation only — they aren’t added to your Context Layer and nobody else sees them. You can attach documents, spreadsheets, images, and data files — PDF, Word, PowerPoint, Excel, CSV, JSON, Markdown, PNG, and JPEG among them. Reach for an attachment when the file matters to this question and nothing else:
  • A spreadsheet of extra data to join against your warehouse numbers
  • An image of a report or dashboard you want recreated
  • A document whose figures you want checked against the data
Example: attach a CSV of target numbers and ask “how did we do against these targets last quarter?”
If you find yourself attaching the same file repeatedly, it belongs in your Context Layer instead. Files there are described once and the agent finds them on its own in every session. See Files.

​
Referencing a Context Layer File

For files already in your Context Layer, type @ and pick from the Files group rather than re-uploading. That points the agent at a specific file even if it might not have chosen it on its own.

​
Asking the Agent to Create a File

You can ask for a file back and download it from the chat:
  • “Export this as a CSV”
  • “Put this summary in a PDF”
The agent generates the file and it appears in the conversation, ready to download. Files the agent creates belong to that conversation — they aren’t added to the Files page.

​
Skills (/)

Type / to invoke a skill — a reusable analysis methodology that guides the agent through a multi-step workflow. The agent follows the skill’s instructions step by step, asking clarifying questions and validating results along the way. Example: “/funnel_analysis” — The agent asks which events to include, runs the analysis, and validates the output.

​
Date Range

Use the date picker dropdown to scope your question to a specific time period. Presets include:
  • Today, Yesterday
  • This Week, Last Week
  • Last 7, 14, 28, 60, 90, 180 days
  • This Calendar Month, Last Calendar Month
  • Custom date range
If no date range is selected, the agent uses its judgment based on the question.

​
Filters

Pre-configured product filters appear above the input field. These constrain the data the agent queries — for example, filtering by platform, region, or product.
Product filters are configured by the ClarityQ team during onboarding. Contact support@clarityq.ai to add or modify filters.

​
Follow-Up Questions

Ask Anything is conversational. Within the same session, you can ask follow-ups that build on previous answers:
  • “Break that down by platform”
  • “What about last month?”
  • “Exclude test users”
  • “Show me that as a line chart”
The agent retains the full context of your conversation.

​
Editing Messages

If you want to refine a question without starting over, hover over your message and click the Edit icon. Edit is best for small corrections — clarifying wording, adjusting a mention, or fixing a filter. The agent re-runs the analysis with your updated question, and you can navigate between message versions using the arrow buttons.