AI_SUMMARIZE (Transact-SQL)

Gäller för:SQL-analysslutpunkt i Microsoft Fabric och Warehouse i Microsoft Fabric

AI_SUMMARIZE skapar en kortfattad sammanfattning av inmatningstexten.

Note

  • AI_SUMMARIZE är i förhandsversion.
  • AI_SUMMARIZEfinns endast i SQL analytics endpoint och Warehouse i Microsoft Fabric.

Syntax

Transact-SQL syntaxkonventioner

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

Arguments

text

Ett uttryck för en karaktärstyp, till exempel nvarchar, varchar, nchar eller char.

PÅ MISSTAG

Klausulen ON ERROR styr hur en AI-funktion hanterar bearbetningsfel.

  • NULL ON ERROR returnerar NULL när funktionen inte kan bearbeta ett värde. Detta är standardbeteendet och behöver inte specificeras uttryckligen.
  • ERROR ON ERROR gör att hela frågan misslyckas om ett fel uppstår under bearbetningen av något indatavärde.
  • DEFAULT <value> ON ERROR returnerar det angivna standardvärdet istället för NULL när ett fel uppstår.

Fel kan orsakas av säkerhetskontroller för Responsible AI , begränsningar av inmatningsstorlek, problem med tillfällig service eller andra bearbetningsfel.

Returtyper

Returnerar nvarchar som innehåller den genererade sammanfattningen.

Remarks

AI-funktioner återvänder NULL om AI-modellen inte kan bearbeta texten. Vanliga orsaker är:

  • Ansvarsfulla AI-regler blockerar olämpligt innehåll i inmatningstexten.
  • Indatatexten överskrider tokengränserna. Den aktuella modellen stöder upp till 15 kB text.

Examples

A. Sammanfatta en mening

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

Förväntat resultat: Clean hotel, friendly staff.

B. Sammanfatta recensionstexten i en tabell

Följande fråga skickar varje review_text värde till extern AI-tjänst för att sammanfatta det.

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

Den valfria DEFAULT 'N/A' ON ERROR klausulen instruerar AI-funktionen att returnera värdet 'N/A' för varje indatavärde som inte kan bearbetas.