ref(seer): Improve widget query hints for natural language agent

The Seer agent uses natural language tool calls, not raw API params.
Replace hints that reference internal params (y_axes, group_by, query)
with descriptions of what the widget visualizes and direct the agent
to understand the intent from the query config.

Co-Authored-By: Claude Opus 4.6 <noreply@example.com>

Author: Mihir-Mavalankar

static/app/views/dashboards/dashboard.tsx

@@ -129,7 +129,7 @@ function DashboardInner({
   // Push dashboard metadata into the LLM context tree for Seer Explorer.
   useLLMContext({
     contextHint:
-      'This is a Sentry dashboard. The dateRange, environments, and projects below are global page filters that scope every widget query. Each child widget node contains its own query config that can be used with the telemetry_live_search tool to fetch or drill into its data.',
+      'This is a Sentry dashboard. The dateRange, environments, and projects below are global page filters that scope every widget query. Each child widget node contains its own query config that can be used with tools like telemetry_live_search and telemetry_index_list_nodes to fetch data for that widget and dig deeper. Based on the user question, data might be needed from multiple widgets.',
     title: dashboard.title,
     widgetCount: dashboard.widgets.length,
     filters: dashboard.filters,

static/app/views/dashboards/widgetCard/widgetLLMContext.spec.tsx

@@ -4,26 +4,26 @@ import {getWidgetQueryLLMHint, readableConditions} from './widgetLLMContext';
 
 describe('getWidgetQueryLLMHint', () => {
   it.each([
-    [DisplayType.LINE, 'timeseries'],
-    [DisplayType.AREA, 'timeseries'],
-    [DisplayType.BAR, 'timeseries'],
+    [DisplayType.LINE, 'timeseries chart'],
+    [DisplayType.AREA, 'timeseries chart'],
+    [DisplayType.BAR, 'timeseries chart'],
   ])('returns timeseries hint for %s', (displayType, expected) => {
     expect(getWidgetQueryLLMHint(displayType)).toContain(expected);
   });
 
   it('returns table hint for TABLE', () => {
-    expect(getWidgetQueryLLMHint(DisplayType.TABLE)).toContain('table query');
+    expect(getWidgetQueryLLMHint(DisplayType.TABLE)).toContain('shows a table');
   });
 
-  it('returns single aggregate hint for BIG_NUMBER', () => {
-    expect(getWidgetQueryLLMHint(DisplayType.BIG_NUMBER)).toContain('single aggregate');
+  it('returns single number hint for BIG_NUMBER', () => {
+    expect(getWidgetQueryLLMHint(DisplayType.BIG_NUMBER)).toContain('single number');
     expect(getWidgetQueryLLMHint(DisplayType.BIG_NUMBER)).toContain(
-      'value is included below'
+      'current value is included below'
     );
   });
 
-  it('returns table hint as default for unknown types', () => {
-    expect(getWidgetQueryLLMHint(DisplayType.WHEEL)).toContain('table query');
+  it('returns generic hint for unknown types', () => {
+    expect(getWidgetQueryLLMHint(DisplayType.WHEEL)).toContain('shows data');
   });
 });
 

static/app/views/dashboards/widgetCard/widgetLLMContext.tsx

@@ -18,20 +18,20 @@ export function readableConditions(query: string): string {
 }
 
 /**
- * Returns a hint for the Seer Explorer agent describing how to re-query this
- * widget's data using a tool call, if the user wants to dig deeper.
+ * Returns a hint for the Seer Explorer agent describing what this widget
+ * visualizes so it can understand the intent from the query config.
  */
 export function getWidgetQueryLLMHint(displayType: DisplayType): string {
   switch (displayType) {
     case DisplayType.LINE:
     case DisplayType.AREA:
     case DisplayType.BAR:
-      return 'To dig deeper into this widget, run a timeseries query using y_axes (aggregates) + group_by (columns) + query (conditions)';
+      return 'This widget shows a timeseries chart. The aggregates are the y-axis metrics, columns are the group-by breakdowns, and conditions filter the data. Understand the intent from the query config below.';
     case DisplayType.TABLE:
-      return 'To dig deeper into this widget, run a table query using fields (aggregates + columns) + query (conditions) + sort (orderby)';
+      return 'This widget shows a table. The aggregates and columns define the visible fields, orderby is the sort, and conditions filter the data. Understand the intent from the query config below.';
     case DisplayType.BIG_NUMBER:
-      return 'To dig deeper into this widget, run a single aggregate query using fields (aggregates) + query (conditions); current value is included below';
+      return 'This widget shows a single number. The aggregate is the metric, conditions filter the data, and the current value is included below. Understand the intent from the query config below.';
     default:
-      return 'To dig deeper into this widget, run a table query using fields (aggregates + columns) + query (conditions)';
+      return 'This widget shows data. The aggregates, columns, and conditions define what is displayed. Understand the intent from the query config below.';
   }
 }