AI_GENERATE_RESPONSE (Transact-SQL)

Si applica a:Endpoint di analisi SQL in Microsoft Fabric e Warehouse in Microsoft Fabric

AI_GENERATE_RESPONSE genera testo da un prompt e dati di supporto opzionali.

Note

  • AI_GENERATE_RESPONSE è in anteprima.
  • AI_GENERATE_RESPONSEè disponibile solo nell'endpoint SQL Analytics e nel Warehouse in Microsoft Fabric.

Syntax

Convenzioni relative alla sintassi Transact-SQL

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

Arguments

prompt

Un'espressione di un tipo di carattere che definisce l'istruzione.

data

Input testuale opzionale usato come contesto di supporto per il prompt.

ERRORE

La ON ERROR clausola controlla come una funzione IA gestisce gli errori di elaborazione.

  • NULL ON ERROR ritorna NULL quando la funzione non riesce a elaborare un valore. Questo è il comportamento predefinito e non deve essere specificato esplicitamente.
  • ERROR ON ERROR fa fallire l'intera query se si verifica un errore durante l'elaborazione di qualsiasi valore di input.
  • DEFAULT <value> ON ERROR restituisce il valore predefinito specificato invece di NULL quando si verifica un errore.

Gli errori possono essere causati da controlli di sicurezza Responsible AI , limiti di dimensione degli input, problemi di servizio transitori o altri fallimenti di elaborazione.

Tipi restituiti

Restituisce nvarchar(max) con il testo generato.

Remarks

Le funzioni IA tornano NULL se il modello IA non riesce a processare il testo. I motivi comuni includono:

  • Le regole di IA responsabile bloccano contenuti inappropriati nel testo di input.
  • Il testo di input supera i limiti dei token. Il modello corrente supporta fino a 15 KB di testo.

Examples

A. Genera una risposta breve

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

B. Genera risposte per riga

La query seguente invia ogni valore review_text a un servizio AI esterno per generare una risposta.

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;

La clausola opzionale NULL ON ERROR istruisce la funzione AI a restituire il NULL valore per ogni valore di input che non può essere elaborato.