Product documentation
Add optimization examples
An optimization example pairs a natural-language question with expected SQL or text content. It is guidance for similar requests, not a test assertion and not a guarantee that future answers will match it exactly.
Add an example
- Open Optimization Examples in an editable Dataset or completed Analysis Model version.
- Select the create action.
- Enter a non-empty question.
- Choose the output type shown by the form, such as SQL or text.
- Enter the expected content.
- Save and wait for success confirmation.
Dataset-created examples are independent unless the interface displays a link back to a Session question. Creating an example in this page does not require an answer or artifact identifier.
Find and maintain examples
Search by question and apply the search. Analysis Model search can use similarity retrieval and display a score; that score does not evaluate whether the example is correct.
Editable rows can be changed, enabled, disabled, or deleted. Read-only contexts remove write actions and disable state switches. Deletion requires confirmation.
Quality checks
- Make the question specific enough to identify the intended measure, grouping, and time range.
- Validate SQL against the intended Dataset before enabling it.
- Avoid secrets, destructive statements, or environment-specific identifiers unless they are intentionally part of the supported pattern.
- Re-test representative questions after changing an example.