Verified queries and guidance

Verified queries and guidance make Ask’s answers easier to trust and review.

Verified queries

A verified query is SQL your team has reviewed and approved. When Ask can answer a question with one, the answer receives a Verified label and links back to its source.

Use verified queries for recurring metrics and questions where the approved logic matters: revenue definitions, active-customer counts, cohort rules, or finance reconciliations.

Agent guidance

Guidance is Markdown that describes how Ask should interpret your data. It can include:

• metric definitions;
• fiscal calendars;
• known data caveats;
• naming conventions;
• preferred sources; and
• business rules that apply across questions.

Guidance informs the answer, but it does not make generated SQL verified.

Review through GitHub

Connect a GitHub repository to manage both types of content. If it does not already have a bitboard/ directory, the first pull request for a new query or guidance file creates the minimal required path automatically.

1. A user proposes a query, guidance document, or edit in BitBoard.
2. BitBoard opens a pull request against the connected repository.
3. Your team reviews and merges the pull request.
4. BitBoard syncs the repository.
5. The approved content becomes available to Ask.

Repository content is authoritative. If a synced file is changed or removed, the next sync updates what Ask can use.

Browse current content

Open Workspace from Ask to browse verified queries and agent guidance. Folder names from the repository are preserved so teams can organize content by domain.