AI_SUMMARIZE (Transact-SQL)

Применимо к:Конечная точка аналитики SQL в Microsoft Fabric и хранилище в Microsoft Fabric

AI_SUMMARIZE создаёт краткое резюме входного текста.

Note

  • AI_SUMMARIZE находится в предварительной версии.
  • AI_SUMMARIZEдоступна только в SQL analytics endpoint и Warehouse в Microsoft Fabric.

Syntax

Соглашения о синтаксисе Transact-SQL

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

Arguments

text

Выражение типа иероглифа, например nvarchar, varchar, nchar или char.

НА ОШИБКЕ

Этот ON ERROR пункт управляет, как функция ИИ обрабатывает ошибки обработки.

  • NULL ON ERROR возвращается NULL , когда функция не может обработать значение. Это поведение по умолчанию и не требует явного указания.
  • ERROR ON ERROR вызывает сбой всего запроса, если при обработке любого входного значения возникает ошибка.
  • DEFAULT <value> ON ERROR возвращает указанное значение по умолчанию, а не NULL когда возникает ошибка.

Ошибки могут быть вызваны проверками безопасности ответственного ИИ , ограничениями по размеру входов, временными сервисными проблемами или другими сбоями обработки.

Типы возвращаемых данных

Возвращает nvarchar , содержащий сгенерированное резюме.

Remarks

Функции ИИ возвращаются NULL , если модель ИИ не может обработать текст. Некоторые из распространенных причин:

  • Правила ответственного ИИ блокируют неподходящий контент в вводном тексте.
  • Входной текст превышает ограничения маркера. Текущая модель поддерживает до 15 КБ текста.

Examples

А. Кратко сформулировать предложение

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

Ожидаемый результат: Clean hotel, friendly staff.

B. Резюмируйте текст обзора в таблице

Следующий запрос отправляет каждое review_text значение внешнему сервису ИИ для его суммирования.

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

Опциональное DEFAULT 'N/A' ON ERROR предложение инструктирует функцию AI вернуть значение 'N/A' для каждого входного значения, которое нельзя обрабатывать.