What you will be able to do
- Explain what each user feedback option (Yes, Fix it, Request review) does and does not do to a Genie space
- Use the Monitor tab, Weekly digest, and Analyze Agent Usage to find the questions Genie struggles with
- Correct a wrong response by editing its SQL and saving it as an instruction, or by using Genie Code
- Choose between SQL expressions, example SQL queries, trusted assets, and text instructions when acting on stakeholder input
Key concept
Iterative curation — A Genie space is not finished when you publish it. Its accuracy improves over time as editors read what users ask, see where Genie gets answers wrong, and turn those findings into new context.
1.The feedback loop starts with one question: Is this correct?
The exam guide says "Genie space", but the current documentation says "Genie Agent" and notes that Genie Agents were formerly known as Genie Spaces. The two names mean the same product. Optimizing a space starts with finding out where its answers go wrong, and the first source of that information is the users. Each response asks the user "Is this correct?" and gives three options. Yes confirms the answer. Fix it flags the answer as incorrect. The user picks a common issue or writes their own explanation, then chooses either *Submit and try again* to regenerate the answer using that feedback, or *Submit* to send the feedback without regenerating. Request review flags the response for manual review and can include an optional comment.
| Option | What it records | Follow-up |
|---|---|---|
| Yes | Confirms the response appears accurate | None needed |
| Fix it | Flags the response as incorrect, with a chosen issue or a free-text explanation | Submit and try again (regenerate) or Submit (feedback only) |
| Request review | Flags the response for manual review, with an optional comment | A CAN MANAGE user reviews, comments, and confirms or corrects; the user sees updates on their Monitor page |
Feedback is a signal for the people who curate the space. It does not retrain anything. Even so, Databricks recommends encouraging users to give feedback through this mechanism. When you bring in business testers, tell them that their job is to help refine the space. Ask them to upvote the final query once Genie gets it right, and to send unresolved questions straight to the space's authors.
Checkpoint 1 of 6· Check yourself
A user wants Genie to try again right away using the problem they just described. Which action should they take?
Only 'Submit and try again' regenerates the response using the feedback. Plain 'Submit' sends the feedback without regenerating, and Request review sends the response to a manager for manual review.
“Click Submit and try again to regenerate the response using the provided feedback.”Source: docs.databricks.com
2.Tracking questions and accuracy on the Monitor tab
Feedback reaches editors through the Monitor tab. It lists every question asked in the space along with Genie's answer, and you can filter the list by time, rating, user, or status. Users with CAN MANAGE permission use it to see what business users are asking and how Genie responded. Click a question to read the full chat thread. The questions Genie handles badly show you exactly where it needs more specific instructions.
Two features summarize activity across the whole space. The Weekly digest section shows weekly message volume, active users, and thumbs up/down feedback. Analyze Agent Usage opens Genie Code, which reads the last six months of user messages, feedback, and issues. It reports common topics, recurring issues, and suggested context improvements, and each finding links back to the conversations it came from.
The conversation is set to Private. Under Genie Chat Sharing, managers can open the full exchange only for conversations set to 'Reviewable by agent managers'. For Private conversations they see the prompts only. Conversations created before sharing was enabled stay Private. Conversations created afterwards default to Reviewable.
Checkpoint 2 of 6· Exam question
A Genie space for the operations team has been live for a month. The data analyst who curates the space wants to find which user questions Genie interpreted poorly, so instructions can be improved where they matter most. What should the analyst check first?
Correct answer: A — Open the space's History page, which logs each user question, the SQL Genie generated, and any feedback left on that exchange.
- A. The History page is where a Genie space logs each question asked, the SQL Genie produced, and any feedback given, making it the direct source for spotting recurring misinterpretations.
- B. The workspace audit log records access events, not the natural-language question, generated SQL, and feedback needed to judge whether a specific answer was accurate.
- C. Relying on user recall is unreliable and does not scale, and it skips the structured record of questions and responses the space already keeps.
- D. The warehouse query history mixes in every other job and query sent to that warehouse, so it does not isolate which statements came from Genie or which users found unclear.
Checkpoint 3 of 6· Check yourself
A space owner wants a report of recurring issues and suggested context improvements, drawn from the last six months of conversations. Which feature provides it?
Analyze Agent Usage launches Genie Code to review six months of messages, feedback, and issues. The Weekly digest only shows volume, active users, and thumbs up/down counts.
“reviews the user messages, feedback, and issues from the last six months and reports on common topics, recurring issues, and suggested context improvements”Source: docs.databricks.com
Sources1
3.Turning a wrong answer into new context
Once you have found a bad answer, open its SQL. Click Show generated code to see the query. The people who build a space usually know the data well enough to spot the mistake, and a small edit often fixes it. If you have CAN EDIT or higher permission on the space, you can edit the generated SQL and run it. Then click Add as instruction, which opens the example-SQL editor pre-filled with the question and the SQL. The response's kebab menu also has Add as benchmark, which saves the question for systematic accuracy testing later.
The other route is Genie Code. Open it from the response, describe the problem and the behavior you want, then review the context changes it proposes and accept the ones you want to keep. The documentation's example is a space using calendar quarters when the business uses a fiscal calendar. You can also ask Genie Code to capture new terms or corrections that users introduced during a conversation.
Checkpoint 4 of 6· Put it in order
Put the steps for fixing an incorrect response through its SQL in order
- 1.Run the corrected query
- 2.Edit the generated SQL statement to correct it
- 3.Click Add as instruction to save it as an example
- 4.Click Show generated code to inspect the query
You inspect the SQL, correct it (this needs CAN EDIT or higher), run it to confirm the result, and then save it so Genie learns from it.
“After you've made your corrections, run the query.”Source: docs.databricks.com
Sources1
4.Updating instructions and trusted assets from stakeholder input
Stakeholder feedback usually reaches you as a sentence, such as "that's not how we count active customers." You then decide which kind of context will fix it. The best-practices guidance gives a clear order of preference. Use SQL expressions (measures, filters, fields) for common business terms. Use example SQL queries for questions that are complex, multi-part, or hard to interpret. Use text instructions only when neither of those can meet the need. General text instructions apply to every prompt, and too many of them can make Genie less effective, especially in long conversations. Whatever you add must also agree with what is already there. If the text instructions say to round to two decimals, the example queries have to round to two decimals as well.
Trusted assets are parameterized example SQL queries and SQL functions registered in Unity Catalog. When Genie answers using one of them, the answer is marked as verified. Users with at least CAN EDIT permission can add or remove trusted assets. Users of the space need EXECUTE permission on any SQL function used as a trusted asset. Title each example with the way a user would most typically ask the question, and focus on logic that is specific to your organization, as in this example:
-- Return our current total open pipeline by region.
-- Opportunities are only considered pipelines if they are tagged as such.
SELECT
a.region__c AS `Region`,
sum(o.amount) AS `Open Pipeline`
FROM
sales.crm.opportunity o
JOIN sales.crm.accounts a ON o.accountid = a.id
WHERE
o.forecastcategory = 'Pipeline' AND
o.stagename NOT ILIKE '%closed%'
GROUP BY ALL;Checkpoint 5 of 6· Match them up
Match each piece of stakeholder input to the context type the guidance recommends
Tap a term, then the definition that fits it.
SQL expressions define reusable business terms. Example queries teach Genie how to handle complex prompt patterns. Text instructions hold global guidance that SQL can't express. SQL functions hide their logic from Genie.
“Text instructions should be used sparingly, only when SQL expressions and examples cannot address the need.”Source: docs.databricks.com
Checkpoint 6 of 6· Exam question
Reviewing recent Genie activity, an analyst notices that several users keep phrasing the same request about churned customers differently, and Genie sometimes drafts SQL with the wrong join or filter for it. The underlying question and correct SQL are well understood by the team. What is the most effective fix?
Correct answer: A — Add a curated example SQL query for this request as a trusted asset so Genie has a vetted pattern to draw on for that question.
- A. A trusted-asset example query gives Genie a vetted, reusable SQL pattern tied to that intent, which is exactly the mechanism designed to fix a known question that keeps generating inconsistent SQL.
- B. Instructions are meant to convey business context and phrasing guidance in natural language, not to carry full SQL statements, so embedding raw SQL there is not how the space is designed to be tuned.
- C. Removing the table would stop Genie from answering the question at all, which discards a request users clearly want answered instead of fixing how it is answered.
- D. Requiring users to phrase questions identically fights how natural-language interfaces are meant to work and does not address the underlying SQL-generation mistake.
Exam traps
Each one states something that sounds right. Open it to see what is actually true.
1.When users click Fix it or thumbs-down, Genie automatically learns and stops making that mistake.Why is that wrong?
Feedback does not change the space's behavior by itself. Editors read it on the Monitor tab and turn it into instructions, examples, or metadata.
Covered in The feedback loop starts with one question: Is this correct?
2.The quickest way to fix a misunderstood metric is to add a sentence defining it in the general text instructions.Why is that wrong?
Metrics, filters, and query patterns that can be written in SQL belong in SQL expressions or example queries. Text instructions are a last resort, and too many of them can make Genie less effective.
Covered in Updating instructions and trusted assets from stakeholder input
Sources
Every claim above is drawn from one of these pages, quoted as it was written on the date shown.
- 1.
“Request review: Flags the response for manual review.”
↩︎ The feedback loop starts with one question: Is this correct?“Databricks recommends encouraging users to provide feedback on the agent using this mechanism.”
↩︎ The feedback loop starts with one question: Is this correct?“You can filter questions by time, rating, user, or status.”
↩︎ Tracking questions and accuracy on the Monitor tab“Use the Weekly digest section of the Monitor tab to review weekly message volume, active users, and thumbs up/down feedback.”
↩︎ Tracking questions and accuracy on the Monitor tab“For conversations set to Private, agent managers can see user prompts in the monitoring tab but cannot view the full conversation or results.”
↩︎ Tracking questions and accuracy on the Monitor tab“You can edit the generated SQL statement to correct it if you have CAN EDIT or greater privileges on the Genie Agent.”
↩︎ Turning a wrong answer into new context“This opens the UI for saving example SQL queries, populated with the question and generated SQL.”
↩︎ Turning a wrong answer into new context“Review the context changes that Genie Code proposes, and accept the ones you want to keep.”
↩︎ Turning a wrong answer into new context“It accumulates knowledge over time rather than serving as a one-time deployment.”
↩︎ Key concept“You should use feedback to identify improvement opportunities or respond directly to user questions.”
↩︎ Exam trap 1“Your Genie Agent's behavior does not change based on user feedback alone.”
↩︎ Prediction“Click Submit and try again to regenerate the response using the provided feedback.”
↩︎ Checkpoint“reviews the user messages, feedback, and issues from the last six months and reports on common topics, recurring issues, and suggested context improvements”
↩︎ Checkpoint“After you've made your corrections, run the query.”
↩︎ Checkpoint - 2.
“When a correct response is provided, they should upvote the final query to minimize similar errors in future interactions.”
↩︎ The feedback loop starts with one question: Is this correct?“Authors and editors can use feedback to refine instructions, examples, and trusted assets.”
↩︎ Updating instructions and trusted assets from stakeholder input“Avoid conflicting instructions: Ensure consistency across all instruction types.”
↩︎ Updating instructions and trusted assets from stakeholder input“Avoid using text instructions to define metrics, filters, or query patterns that can be expressed through SQL.”
↩︎ Exam trap 2“Text instructions should be used sparingly, only when SQL expressions and examples cannot address the need.”
↩︎ Checkpoint - 3.
“Users with at least CAN EDIT permission on a Genie Agent can add or remove trusted assets.”
↩︎ Updating instructions and trusted assets from stakeholder input“Agent users must have EXECUTE permission on any SQL functions used as trusted assets.”
↩︎ Updating instructions and trusted assets from stakeholder input