Anpassen von Diagrammen in Snowflake Intelligence¶

Übersicht¶

Die Anpassung funktioniert auf zwei Ebenen:

• Agentenebene: Gilt für alle Diagramme in jeder mit dem Agenten verbundenen semantischen Ansicht. Verwenden Sie dies für globale Standardeinstellungen wie Markenfarben und Schriftarten.

• Ebene der semantischen Ansicht: Gilt nur für Diagramme, die aus dieser spezifischen semantischen Ansicht generiert wurden. Verwenden Sie dies für spaltenspezifische Regeln und domänenspezifische Einstellungen für Diagrammtypen.

Auf jeder Ebene stehen zwei Mechanismen zur Verfügung:

• vega_template: Eine teilweise `Vega-Lite <https://vega.github.io/vega-lite/>`_JSON-Spezifikation, die deterministisch in jedes generierte Diagramm eingefügt wird. Verwenden Sie dies für alles, was immer gelten muss.

• Freitextanweisungen: Anleitung in natürlicher Sprache, die in den Prompt für die Diagrammerstellung eingefügt wird. Das LLM bemüht sich , diese einzuhalten, dies ist jedoch nicht garantiert.

Anpassung auf Agentenebene¶

Fügen Sie einen <chart_customization>-Block in instructions.orchestration in Ihrer Agentenkonfiguration hinzu. Sie können Schriftthemes und eine globale Standardpalette kombinieren:

<chart_customization>
Prefer horizontal bar charts for ranked data.
vega_template:
{
  "background": "antiquewhite",
  "config": {
    "title":  { "font": "monospace", "fontStyle": "italic", "fontSize": 20, "fontWeight": "lighter" },
    "axis":   { "labelFont": "monospace", "titleFont": "monospace", "titleFontSize": 15, "labelFontSize": 10 },
    "header": { "labelFont": "monospace", "titleFont": "monospace", "labelFontSize": 10 },
    "legend": { "labelFont": "monospace", "titleFont": "monospace", "titleFontSize": 18, "labelFontSize": 15 },
    "mark":   { "font": "monospace" }
  }
}
</chart_customization>

Verwenden Sie die Agentenebene für:

• Markenfarbenpalette

• Visuelles Standardthemes (Schemas, Hintergrund)

• Einstellungen für den domänenübergreifenden Stil

• Standardwerte für die Formatierung von Zahlen oder Währungen

Vermeiden Sie spaltenspezifische Farbzuordnungen auf Agentenebene. Die Spaltennamen unterscheiden sich zwischen den semantischen Ansichten und werden stillschweigend ignoriert, wenn sie nicht gefunden werden.

Anpassung auf der Ebene der semantischen Ansicht¶

Fügen Sie einen <chart_customization>-Block im Feld module_custom_instructions.sql_generation der YAML-Datei der semantischen Ansicht hinzu. Dieses Feld hat Vorrang vor dem alten Feld custom_instructions, wenn beide festgelegt sind.

CREATE OR REPLACE SEMANTIC VIEW my_db.my_schema.my_view
  FROM @my_stage/semantic_view.yaml;

# semantic_view.yaml
name: my_view
module_custom_instructions:
  sql_generation: |
    <chart_customization>
    Always use a line chart for time series data.
    vega_template:
    {
      "transform": [
        {
          "calculate": "datum.CATEGORY === 'Furniture' ? '#4e79a7' : datum.CATEGORY === 'Technology' ? '#f28e2b' : datum.CATEGORY === 'Office Supplies' ? '#e15759' : ''",
          "as": "_color"
        }
      ],
      "encoding": {
        "color": { "field": "CATEGORY", "type": "nominal", "scale": { "range": { "field": "_color" } } }
      }
    }
    </chart_customization>
tables:
  ...

Verwenden Sie die Ebene der semantischen Ansicht für:

• Farbzuordnungen pro Spalte

• Domänenspezifische Regeln für Diagrammtypen

• Metrikspezifische Formatierung

• Überschreiben der Standardeinstellungen auf Agentenebene

Vorsicht bei der Verwendung: Vorlagen wirken sich auf jedes Diagramm aus¶

vega_template wird in jedes Diagramm eingebunden, das auf dieser Ebene erstellt wurde. Es gibt keine Filterung pro Frage oder pro Diagrammtyp. Wenn Sie encoding.y auf Agentenebene hinzufügen, gilt dies gleichermaßen für Balkendiagramme, Liniendiagramme, Streudiagramme und Kreisdiagramme.

Bevor Sie eine Vorlage hinzufügen, sollten Sie Folgendes beachten:

• Bereich: Vorlagen auf Agentenebene wirken sich auf alle Diagramme in allen semantischen Ansichten aus. Nutzen Sie die Ebene der semantischen Ansicht bevorzugt, wenn eine Regel spezifisch für eine Domäne oder ein Datenset ist.

• Platzhaltercodierungen: Eine Vorlagencodierung, bei der field (z. B.``“y“: {„axis“: {„format“: „…“}}``) weggelassen wird, gilt für jede y-Achse eines Diagramms, unabhängig davon, welche Spalte dargestellt wird. Verwenden Sie field, um sie an eine bestimmte Spalte zu heften, wenn die semantische Ansicht bekannt ist.

• „mark“ überschreiben: Das Festlegen von "mark": "line" auf Agentenebene dass jedes Diagramm als Liniendiagramm dargestellt wird, auch dort, wo das LLM korrekt ein Balken- oder Kreisdiagramm wählen würde. Überschreiben Sie mark nur auf der Ebene der semantischen Ansicht, wo Sie Domänenkenntnisse über die Daten haben.

• „transform“-Arrays: Eine calculate-Transformation in der Vorlage (z. B.``_color``) wird in jedes transform-Array eines Diagramms eingefügt. Wenn die Daten die referenzierte Spalte nicht enthalten, erzeugt Vega-Lite stillschweigend null-Werte für das berechnete Feld.

Wenn Sie unsicher sind, beginnen Sie auf der Ebene der semantischen Ansicht und wechseln Sie erst auf die Ebene des Agenten, nachdem Sie bestätigt haben, dass die Regel für alle Diagramme sicher ist.

Um eine Vorlage vor der Bereitstellung zu validieren, fügen Sie eine repräsentative Diagrammspezifikation (mit bereits eingebundener vega_template) in den Vega-Editor ein. Der Editor zeigt Live-Warnungen und -Fehler in der Konsole an. Eine gültige Vorlage sollte keine Warnungen erzeugen. Häufige Probleme, die auf diese Weise abgefangen werden können: ungültige Eigenschaftsnamen, nicht übereinstimmende Typen, nicht erreichbare calculate-Ausdrücke und Fehler bei der Konfiguration der Skalierung.

Schriftarten¶

Schrifteinstellungen werden über den config-Block in vega_template gesteuert. Alle Schrifteigenschaften werden global auf das Diagramm angewendet und wirken sich auf jedes generierte Diagramm aus, unabhängig von den Daten.

{
  "config": {
    "title":  { "font": "serif", "fontSize": 20, "fontWeight": "bold", "fontStyle": "italic" },
    "axis":   { "labelFont": "monospace", "titleFont": "monospace", "labelFontSize": 11, "titleFontSize": 13 },
    "header": { "labelFont": "serif", "titleFont": "serif", "labelFontSize": 11 },
    "legend": { "labelFont": "serif", "titleFont": "serif", "labelFontSize": 12, "titleFontSize": 13 },
    "mark":   { "font": "serif" }
  }
}

Allgemeine config-Schrifteigenschaften:

Sie können neben Schriften auch eine globalen background-Farbe festlegen:

{
  "background": "#f9f9f9",
  "config": {
    "title":  { "font": "monospace", "fontStyle": "italic", "fontSize": 20, "fontWeight": "lighter" },
    "axis":   { "labelFont": "monospace", "titleFont": "monospace", "titleFontSize": 15, "labelFontSize": 10 },
    "header": { "labelFont": "monospace", "titleFont": "monospace", "labelFontSize": 10 },
    "legend": { "labelFont": "monospace", "titleFont": "monospace", "titleFontSize": 18, "labelFontSize": 15 },
    "mark":   { "font": "monospace" }
  }
}

Farben¶

<chart_customization>
Color Active status green, Inactive status red, and Pending status yellow.
</chart_customization>

{
  "transform": [
    {
      "calculate": "datum.STATUS === 'Active' ? '#22c55e' : datum.STATUS === 'Inactive' ? '#ef4444' : datum.STATUS === 'Pending' ? '#eab308' : ''",
      "as": "_color"
    }
  ],
  "encoding": {
    "color": {
      "field": "STATUS",
      "type": "nominal",
      "scale": { "range": { "field": "_color" } }
    }
  }
}

{
  "encoding": {
    "color": {
      "scale": {
        "domain": ["Furniture", "Technology", "Office Supplies"],
        "range":  ["#4e79a7", "#f28e2b", "#e15759"],
        "scheme": "tableau10"
      }
    }
  },
  "usermeta": { "merge": "extend" }
}

Deaktivieren von Snowsight-Stilen¶

Standardmäßig wendet Snowflake Intelligence zusätzlich zum generierten Diagramm Snowsight UI-Themeanpassungen an. Wenn Sie dieses Verhalten deaktivieren und das Diagramm genau so rendern möchten, wie es in Ihrer vega_template angegeben ist, legen Sie ui-merge auf "none" in usermeta fest:

{
  "usermeta": { "ui-merge": "none" }
}

Dies ist nützlich, wenn Sie die volle Kontrolle über die visuelle Ausgabe wünschen, z. B. wenn Sie ein angepasstes Markentheme anwenden und Sie nicht möchten, dass Snowsight Farben, Schriftarten oder Hintergründe überschreibt.

Zahlen- und Währungsformatierung (experimentell)¶

Achsen- und Legendenbeschriftungen können mit Zeichenfolgen im D3-Format durch vega_template formatiert werden. Dies ist nützlich, um konsistente Währungssymbole, Dezimalstellen oder SI-Suffixe für alle Diagramme durchzusetzen.

Legen Sie axis.format für quantitative Achsen (x, y) und legend.format für Farb-/Größenlegenden fest:

{
  "encoding": {
    "y": { "axis": { "format": "$,.0f" } }
  }
}

{
  "encoding": {
    "y": { "type": "quantitative", "axis": { "format": "$,.0f" } }
  }
}

Gängige D3-Formatzeichenfolgen:

So wenden Sie die Formatierung auf alle quantitativen Kanäle auf Agentenebene an (ohne den spezifischen Spaltennamen zu kennen):

{
  "encoding": {
    "y": { "axis": { "format": "$,.0f" } },
    "x": { "axis": { "format": "$,.0f" } },
    "color": { "legend": { "format": "$,.0f" } }
  },
  "usermeta": { "merge": "extend" }
}

Verwenden Sie "merge": "extend", damit das Format nur zu Kanälen hinzugefügt wird, die das LLM bereits aufgefüllt hat, ohne deren field- oder``type``-Einstellungen zu überschreiben.

Zusammenführungsmodi¶

Steuern Sie, wie vega_template mit dem LLM-generierten Diagramm interagiert, indem Sie "usermeta": {"merge": "<mode>"} innerhalb der Vorlage festlegen.

Regeln, die für beide Modi gelten:

• Der data-Block wird nie überschrieben.

• Codierungsüberschreibungen gelten nur, wenn das field der Vorlage mit dem field des Diagramms übereinstimmt oder die Vorlage field weglässt.

• Nach der Zusammenführung werden Domäneneinträge, die in den eigentlichen Daten nicht vorhanden sind, automatisch entfernt.

Beispiel: Erzwingen eines Liniendiagramms

{
  "mark": "line",
  "usermeta": { "merge": "override" }
}