DEV: Lint and update tooltips

Author: martin-brennan

assets/javascripts/discourse/components/ai-spam.gjs

@@ -6,6 +6,7 @@ import { action } from "@ember/object";
 import { LinkTo } from "@ember/routing";
 import { service } from "@ember/service";
 import DButton from "discourse/components/d-button";
+import DStatTiles from "discourse/components/d-stat-tiles";
 import DToggleSwitch from "discourse/components/d-toggle-switch";
 import DTooltip from "discourse/components/d-tooltip";
 import withEventValue from "discourse/helpers/with-event-value";
@@ -17,7 +18,6 @@ import AdminConfigAreaCard from "admin/components/admin-config-area-card";
 import AdminPageSubheader from "admin/components/admin-page-subheader";
 import ComboBox from "select-kit/components/combo-box";
 import SpamTestModal from "./modal/spam-test-modal";
-import DStatTiles from "discourse/components/d-stat-tiles";
 
 export default class AiSpam extends Component {
   @service siteSettings;
@@ -139,10 +139,12 @@ export default class AiSpam extends Component {
       {
         label: i18n("discourse_ai.spam.false_positives"),
         value: this.stats.false_positives,
+        tooltip: i18n("discourse_ai.spam.stat_tooltips.incorrectly_flagged"),
       },
       {
         label: i18n("discourse_ai.spam.false_negatives"),
         value: this.stats.false_negatives,
+        tooltip: i18n("discourse_ai.spam.stat_tooltips.missed_spam"),
       },
     ];
   }
@@ -227,6 +229,7 @@ export default class AiSpam extends Component {
                 @label={{metric.label}}
                 @url={{metric.href}}
                 @value={{metric.value}}
+                @tooltip={{metric.tooltip}}
               />
             {{/each}}
           </DStatTiles>

assets/javascripts/discourse/components/ai-usage.gjs

@@ -1,5 +1,4 @@
 import Component from "@glimmer/component";
-import DStatTiles from "discourse/components/d-stat-tiles";
 import { tracked } from "@glimmer/tracking";
 import { fn, hash } from "@ember/helper";
 import { action } from "@ember/object";
@@ -8,6 +7,7 @@ import { service } from "@ember/service";
 import { eq, gt, lt } from "truth-helpers";
 import ConditionalLoadingSpinner from "discourse/components/conditional-loading-spinner";
 import DButton from "discourse/components/d-button";
+import DStatTiles from "discourse/components/d-stat-tiles";
 import DateTimeInputRange from "discourse/components/date-time-input-range";
 import avatar from "discourse/helpers/avatar";
 import concatClass from "discourse/helpers/concat-class";
@@ -135,18 +135,22 @@ export default class AiUsage extends Component {
       {
         label: i18n("discourse_ai.usage.total_tokens"),
         value: this.data.summary.total_tokens,
+        tooltip: i18n("discourse_ai.usage.stat_tooltips.total_tokens"),
       },
       {
         label: i18n("discourse_ai.usage.request_tokens"),
         value: this.data.summary.total_request_tokens,
+        tooltip: i18n("discourse_ai.usage.stat_tooltips.request_tokens"),
       },
       {
         label: i18n("discourse_ai.usage.response_tokens"),
         value: this.data.summary.total_response_tokens,
+        tooltip: i18n("discourse_ai.usage.stat_tooltips.response_tokens"),
       },
       {
         label: i18n("discourse_ai.usage.cached_tokens"),
         value: this.data.summary.total_cached_tokens,
+        tooltip: i18n("discourse_ai.usage.stat_tooltips.cached_tokens"),
       },
     ];
   }

config/locales/client.en.yml

@@ -157,6 +157,9 @@ en:
           run: "Run test"
           spam: "Spam"
           not_spam: "Not spam"
+        stat_tooltips:
+          incorrectly_flagged: "Items that the AI bot flagged as spam where moderators disagreed"
+          missed_spam: "Items flagged by the community as spam that were not detected by the AI bot, which moderators agreed with"
 
       usage:
         short_title: "Usage"
@@ -183,7 +186,11 @@ en:
         no_features: "No feature usage data found"
         subheader_description: "Tokens are the basic units that LLMs use to understand and generate text, usage data may affect costs."
         stat_tooltips:
-          total_requests: "These are all requests made to LLMs through Discourse"
+          total_requests: "All requests made to LLMs through Discourse"
+          total_tokens: "All the tokens used when prompting an LLM"
+          request_tokens: "Tokens used when the LLM tries to understand what you are saying"
+          response_tokens: "Tokens used when the LLM responds to your prompt"
+          cached_tokens: "Previously processed request tokens that the LLM reuses to optimize performance and cost"
         periods:
           last_day: "Last 24 hours"
           last_week: "Last week"