AI_SUMMARIZE (Transact-SQL)

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

AI_SUMMARIZE crea un riassunto conciso del testo in input.

Note

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

Syntax

Convenzioni relative alla sintassi Transact-SQL

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

Arguments

text

Un'espressione di un tipo di carattere, ad esempio nvarchar, varchar, nchar o char.

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 contenente il riassunto 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. Riassumi una frase

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

Risultato previsto: Clean hotel, friendly staff.

B. Riassumi il testo della recensione in una tabella

La seguente query invia ogni valore di review_text a un servizio AI esterno per riassumerlo.

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

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

Contenuti correlati

  • Last updated on