AI_SUMMARIZE (Transact-SQL)

Gilt für:SQL-Analyseendpunkt in Microsoft Fabric und Warehouse in Microsoft Fabric

AI_SUMMARIZE erstellt eine prägnante Zusammenfassung des Eingabetextes.

Note

  • AI_SUMMARIZE befindet sich in der Vorschau.
  • AI_SUMMARIZEist nur im SQL-Analytics-Endpunkt und im Warehouse in Microsoft Fabric verfügbar.

Syntax

Transact-SQL-Syntaxkonventionen

AI_SUMMARIZE ( text [ (NULL | ERROR | DEFAULT <value>) ON ERROR ] )

Arguments

text

Ein Ausdruck eines Charaktertyps, zum Beispiel nvarchar, varchar, nchar oder char.

EIN FEHLER

Die Klausel ON ERROR steuert, wie eine KI-Funktion mit Verarbeitungsfehlern umgeht.

  • NULL ON ERROR gibt zurück, NULL wenn die Funktion einen Wert nicht verarbeiten kann. Das ist das Standardverhalten und muss nicht explizit angegeben werden.
  • ERROR ON ERROR führt dazu, dass die gesamte Abfrage fehlschlägt, wenn während der Verarbeitung eines Eingabewerts ein Fehler auftritt.
  • DEFAULT <value> ON ERROR gibt den angegebenen Standardwert zurück, anstatt NULL wenn ein Fehler auftritt.

Fehler können durch Sicherheitsprüfungen der Responsible AI, Eingabegrößenbeschränkungen, vorübergehende Serviceprobleme oder andere Verarbeitungsfehler verursacht werden.

Rückgabetypen

Gibt nvarchar zurück, das die generierte Zusammenfassung enthält.

Bemerkungen

KI-Funktionen kehren zurück, NULL wenn das KI-Modell den Text nicht verarbeiten kann. Häufige Gründe sind:

  • Verantwortungsvolle KI-Regeln blockieren unangemessene Inhalte im Eingabetext.
  • Eingabetext überschreitet Tokengrenzwerte. Das aktuelle Modell unterstützt bis zu 15 KB Text.

Beispiele

A. Einen Satz zusammenfassen

SELECT ai_summarize('The hotel was clean and staff were friendly.') AS summary;

Erwartetes Ergebnis: Clean hotel, friendly staff.

B. Zusammenfassen Sie den Übersichtstext in einer Tabelle

Die folgende Abfrage sendet jeden review_text Wert an externe KI-Dienste, um ihn zusammenzufassen.

SELECT review_id,
       ai_summarize(review_text DEFAULT 'N/A' ON ERROR) AS review_summary
FROM dbo.hotel_reviews;

Die optionale DEFAULT 'N/A' ON ERROR Klausel weist die KI-Funktion an, für jeden nicht verarbeiteten Eingabewert den Wert 'N/A' zurückzugeben.