AI_GENERATE_RESPONSE (Transact-SQL)

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

AI_GENERATE_RESPONSE erzeugt Text aus einem Prompt und optionalen unterstützenden Daten.

Note

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

Syntax

Transact-SQL-Syntaxkonventionen

AI_GENERATE_RESPONSE ( prompt [ , data ] [ (NULL | ERROR | DEFAULT <value>) ON ERROR ] )

Arguments

Eingabeaufforderung

Ein Ausdruck eines Zeichentyps, der die Anweisung definiert.

data

Optionale Texteingabe dient als unterstützender Kontext für den Prompt.

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(max) mit generiertem Text zurück.

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. Generiere eine kurze Antwort

SELECT ai_generate_response('Reply in 20 words:', 'The room was noisy.') AS response;

B. Antworten pro Zeile generieren

Die folgende Abfrage sendet jeden review_text Wert an externe KI-Dienste, um eine Antwort zu generieren.

SELECT review_id,
       ai_generate_response('Draft a professional response in 30 words:', review_text NULL ON ERROR) AS response_text
FROM dbo.hotel_reviews;

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

Verwandte Inhalte

  • Last updated on