Add example to AlertQuery data field descriptions

Previously, the `data` field description was just "Array of query data
objects" with no guidance on the required structure. Since
`models.AlertQuery.Model` is `interface{}`, the jsonschema reflector
emits bare `true` for it, giving LLMs no type information about the
model field.

Add a concrete example showing the expected AlertQuery structure
(refId, datasourceUid, relativeTimeRange, model with expr) to all three
Data field descriptions. This helps LLMs construct valid create/update
payloads without needing to guess the nested object structure.

Author: alexander-akhmetov

tools/alerting_manage_rules_types.go

@@ -63,7 +63,7 @@ type CreateAlertRuleParams struct {
 	RuleGroup         string               `json:"ruleGroup" jsonschema:"required,description=The rule group name"`
 	FolderUID         string               `json:"folderUID" jsonschema:"required,description=The folder UID where the rule will be created"`
 	Condition         string               `json:"condition" jsonschema:"required,description=The query condition identifier (e.g. 'A'\\, 'B')"`
-	Data              []*models.AlertQuery `json:"data" jsonschema:"required,description=Array of query data objects"`
+	Data              []*models.AlertQuery `json:"data" jsonschema:"required,description=Array of alert query objects. Example: [{refId: 'A'\\, datasourceUid: 'prometheus'\\, relativeTimeRange: {from: 600\\, to: 0}\\, model: {expr: 'vector(1)'\\, refId: 'A'}}]. Use datasourceUid '__expr__' for server-side expressions."`
 	NoDataState       string               `json:"noDataState" jsonschema:"required,description=State when no data (NoData\\, Alerting\\, OK)"`
 	ExecErrState      string               `json:"execErrState" jsonschema:"required,description=State on execution error (NoData\\, Alerting\\, OK)"`
 	For               string               `json:"for" jsonschema:"required,description=Duration before alert fires (e.g. '5m')"`
@@ -111,7 +111,7 @@ type UpdateAlertRuleParams struct {
 	RuleGroup         string               `json:"ruleGroup" jsonschema:"required,description=The rule group name"`
 	FolderUID         string               `json:"folderUID" jsonschema:"required,description=The folder UID where the rule will be created"`
 	Condition         string               `json:"condition" jsonschema:"required,description=The query condition identifier (e.g. 'A'\\, 'B')"`
-	Data              []*models.AlertQuery `json:"data" jsonschema:"required,description=Array of query data objects"`
+	Data              []*models.AlertQuery `json:"data" jsonschema:"required,description=Array of alert query objects. Example: [{refId: 'A'\\, datasourceUid: 'prometheus'\\, relativeTimeRange: {from: 600\\, to: 0}\\, model: {expr: 'vector(1)'\\, refId: 'A'}}]. Use datasourceUid '__expr__' for server-side expressions."`
 	NoDataState       string               `json:"noDataState" jsonschema:"required,description=State when no data (NoData\\, Alerting\\, OK)"`
 	ExecErrState      string               `json:"execErrState" jsonschema:"required,description=State on execution error (NoData\\, Alerting\\, OK)"`
 	For               string               `json:"for" jsonschema:"required,description=Duration before alert fires (e.g. '5m')"`
@@ -216,7 +216,7 @@ type ManageRulesReadWriteParams struct {
 	RuleGroup         string               `json:"rule_group,omitempty" jsonschema:"description=The rule group name (required for 'create'\\, 'update')"`
 	FolderUID         string               `json:"folder_uid,omitempty" jsonschema:"description=The folder UID. For 'list': filter by exact folder UID (mutually exclusive with search_folder). For 'create'/'update': the folder to store the rule in (required)."`
 	Condition         string               `json:"condition,omitempty" jsonschema:"description=The query condition identifier\\, e.g. 'A'\\, 'B' (required for 'create'\\, 'update')"`
-	Data              []*models.AlertQuery `json:"data,omitempty" jsonschema:"description=Array of query data objects (required for 'create'\\, 'update')"`
+	Data              []*models.AlertQuery `json:"data,omitempty" jsonschema:"description=Array of alert query objects (required for 'create' and 'update'). Example: [{refId: 'A'\\, datasourceUid: 'prometheus'\\, relativeTimeRange: {from: 600\\, to: 0}\\, model: {expr: 'vector(1)'\\, refId: 'A'}}]. Use datasourceUid '__expr__' for server-side expressions. The 'condition' field must reference one of the refIds."`
 	NoDataState       string               `json:"no_data_state,omitempty" jsonschema:"description=State when no data: NoData\\, Alerting\\, OK (required for 'create'\\, 'update')"`
 	ExecErrState      string               `json:"exec_err_state,omitempty" jsonschema:"description=State on execution error: NoData\\, Alerting\\, OK (required for 'create'\\, 'update')"`
 	For               string               `json:"for,omitempty" jsonschema:"description=Duration before alert fires\\, e.g. '5m' (required for 'create'\\, 'update')"`