StrataDocs

Callout reference

The eight callout styles the AI uses to highlight information inside its responses.

How callouts work

Callouts are written as blockquote-style lines in the AI's Markdown, with a bracketed tag immediately after the blockquote marker:

> [INFO] Latest record is from March 2026.

Strata's renderer turns each callout into a styled card with a label. The AI never explains the syntax to you — it just uses it.

The eight types

TagCard labelUse
[INFO]NoteNeutral information worth pulling out. The most general-purpose callout.
[WARN]WarningData quality issues, soft failures, gotchas. Example: "12% of rows have a null Customer_ID — these were excluded."
[SUCCESS]SuccessAn action completed successfully. Used after sends, saves, or other side-effecting tools confirmed.
[NOTE]NoteAsides or context — visually identical to [INFO] but signals "by the way" rather than a key fact.
[TIP]TipActionable suggestion. Often follows a question with > [TIP] Consider grouping by region instead — the spread is much wider.
[KEY]KeyThe headline insight from an analysis. The AI uses this to call out the single most important takeaway.
[DATA]DataA specific data point worth surfacing — a record, count, or value pulled from a result set.
[ALERT]AlertHigh-severity issues — a tool that completely failed, a request that could not be fulfilled, a destructive action that needs review.

When the AI uses callouts

The AI is instructed to:

  • Flag data confidence problems with [WARN] before showing analysis: many NULLs, stale data, outliers, small sample sizes, missing dates.
  • Use [WARN] or [ALERT] after a tool failure to make the failure unmistakable — the AI is required to surface failures plainly, never silently.
  • Use [INFO], [NOTE], [TIP], [KEY], [DATA] to organize an analysis when a single takeaway needs emphasis.
  • Use [SUCCESS] after a destructive or side-effecting operation (email sent, file saved, query approved) completed.

Color and severity at a glance

Within a response, callouts roughly map to:

  • Critical / failure[ALERT]
  • Caution / quality issue[WARN]
  • Confirmation / completion[SUCCESS]
  • Highlight / key insight[KEY], [DATA]
  • Helpful information[INFO], [NOTE], [TIP]

Related