AI_GENERATE_RESPONSE (Transact-SQL)

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

AI_GENERATE_RESPONSE генерирует текст из подсказки и необязательных сопутствующих данных.

Note

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

Syntax

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

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

Arguments

prompt

Выражение типа символа, определяющее инструкцию.

data

Необязательный текст используется в качестве вспомогательного контекста для запроса.

НА ОШИБКЕ

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

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

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

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

Возвращает nvarchar(max) с сгенерированным текстом.

Remarks

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

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

Examples

А. Сгенерируйте короткий ответ

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

B. Генерируйте ответы на одну строку

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

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;

Опциональное NULL ON ERROR предложение инструктует функцию AI вернуть NULL значение для каждого входного значения, которое невозможно обработать.