AI_GENERATE_RESPONSE (Transact-SQL)

Se aplica a:Punto de conexión de SQL Analytics en Microsoft Fabric y Warehouse en Microsoft Fabric

AI_GENERATE_RESPONSE genera texto a partir de un prompt y datos opcionales de apoyo.

Note

  • AI_GENERATE_RESPONSE está en versión preliminar.
  • AI_GENERATE_RESPONSEestá disponible solo en endpoint de analítica SQL y en Warehouse en Microsoft Fabric.

Syntax

Convenciones de sintaxis de Transact-SQL

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

Arguments

prompt

Una expresión de un tipo de carácter que define la instrucción.

data

Entrada de texto opcional usada como contexto de apoyo para el prompt.

POR ERROR

La ON ERROR cláusula controla cómo una función de IA gestiona los errores de procesamiento.

  • NULL ON ERROR retorna NULL cuando la función no puede procesar un valor. Este es el comportamiento por defecto y no necesita especificarse explícitamente.
  • ERROR ON ERROR hace que toda la consulta falle si ocurre un error mientras se procesa cualquier valor de entrada.
  • DEFAULT <value> ON ERROR devuelve el valor por defecto especificado en lugar de NULL cuando ocurre un error.

Los errores pueden ser causados por comprobaciones de seguridad de IA responsable , límites de tamaño de entrada, problemas de servicio transitorio u otros fallos de procesamiento.

Tipos de retorno

Devuelve nvarchar(max) con texto generado.

Remarks

Las funciones de IA devuelven NULL si el modelo de IA no puede procesar el texto. Los motivos comunes incluyen los siguientes:

  • Las reglas de IA responsable bloquean contenido inapropiado en el texto de entrada.
  • El texto de entrada supera los límites del token. El modelo actual admite hasta 15 KB de texto.

Examples

A. Genera una respuesta corta

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

B. Generar respuestas por fila

La siguiente consulta envía cada valor de review_text a un servicio de IA externo para generar respuesta.

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;

La cláusula opcional NULL ON ERROR instruye a la función de IA para que devuelva el NULL valor de cada valor de entrada que no pueda ser procesado.

Contenido relacionado

  • Last updated on