AI_SUMMARIZE (Transact-SQL)

Platí pro:Koncový bod analýzy SQL v Microsoft Fabric a Warehouse v Microsoft Fabric

AI_SUMMARIZE vytváří stručné shrnutí vstupního textu.

Note

  • AI_SUMMARIZE je ve verzi Preview.
  • AI_SUMMARIZEje dostupný pouze v SQL analytics endpointu a Warehouse v Microsoft Fabric.

Syntax

Transact-SQL konvence syntaxe

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

Arguments

poslat SMS

Výraz typu znaku, například nvarchar, varchar, nchar nebo char.

NA CHYBĚ

Tato ON ERROR klauzule řídí, jak AI funkce zpracovává chyby zpracování.

  • NULL ON ERROR vrací NULL , když funkce nemůže zpracovat hodnotu. Toto je výchozí chování a není nutné to výslovně specifikovat.
  • ERROR ON ERROR způsobí, že celý dotaz selže, pokud při zpracování jakékoli vstupní hodnoty dojde k chybě.
  • DEFAULT <value> ON ERROR vrací zadanou výchozí hodnotu místo NULL toho, kdy nastane chyba.

Chyby mohou být způsobeny bezpečnostními kontrolami odpovědné AI , limity velikosti vstupů, přechodnými službami nebo jinými selháními zpracování.

Návratové typy

Vrací nvarchar obsahující vygenerované shrnutí.

Remarks

AI funkce se vrátí NULL , pokud AI model nedokáže text zpracovat. Mezi běžné důvody patří:

  • Pravidla odpovědné AI blokují nevhodný obsah ve vstupním textu.
  • Vstupní text překračuje limity tokenů. Aktuální model podporuje až 15 kB textu.

Examples

A. Shrnout větu

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

Očekávaný výsledek: Clean hotel, friendly staff.

B. Shrňte text přehledu v tabulce

Následující dotaz posílá všechny review_text hodnoty externí AI službě, aby ji shrnul.

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

Volitelná DEFAULT 'N/A' ON ERROR klauzule instruuje AI funkci, aby vrátila hodnotu 'N/A' pro každou vstupní hodnotu, kterou nelze zpracovat.