percentage instruction fix so llm is better at them

packages/ai/src/tools/visualization-tools/metrics/helpers/metric-tool-description.txt

@@ -104,7 +104,7 @@ Only utilize the required/default fields unless the user specifically requests t
 #       style: percent
 #       replaceMissingDataWith: 0
 #       numberSeparatorStyle: ','
-#       multiplier: 100  # if calculated and not already multiplied
+#       multiplier: 100  # Use 100 if SQL returns 0.75 for 75%; use 1 if SQL returns 75 for 75%
 #       minimumFractionDigits: 1
 #       maximumFractionDigits: 2
 # -------------------------------------
@@ -348,15 +348,21 @@ definitions:
         type: string
         enum:
           - currency # Note: The "$" sign is automatically prepended.
-          - percent # Note: "%" sign is appended. For percentage values: 
-            # - If the value comes directly from a database column, use multiplier: 1
-            # - If the value is calculated in your SQL query and not already multiplied by 100, use multiplier: 100
+          - percent # Note: "%" sign is automatically appended as a suffix.
+            # IMPORTANT: You MUST analyze the SQL query to determine the correct multiplier:
+            # - If SQL returns decimal ratios (e.g., 0.75 for 75%), use multiplier: 100
+            # - If SQL returns percentage values (e.g., 75 for 75%), use multiplier: 1 (or omit it)
           - number
           - date # Note: For date columns, consider setting xAxisTimeInterval in xAxisConfig to control date grouping (day, week, month, quarter, year)
           - string
       multiplier:
         type: number
-        description: Value to multiply the number by before display. Default value is 1. For percentages, the multiplier depends on how the data is sourced: if the value comes directly from a database column, use multiplier: 1; if the value is calculated in your SQL query and not already multiplied by 100, use multiplier: 100.
+        description: |
+          Value to multiply the number by before display. Default: 1.
+          For percentages with style: percent, you MUST examine the SQL query and data format:
+          - If SQL returns decimal ratios (e.g., 0.75), use multiplier: 100 to convert to percentage (75%)
+          - If SQL returns percentage values (e.g., 75), use multiplier: 1 or omit this field
+          The agent must analyze the actual SQL query and understand the data format, not make assumptions.
       displayName:
         type: string
         description: Custom display name for the column