AI_GENERATE_RESPONSE (Transact-SQL)

Aplica-se a:Ponto de extremidade de análise de SQL no Microsoft Fabric e Warehouse no Microsoft Fabric

AI_GENERATE_RESPONSE Gera texto a partir de um prompt e dados opcionais de suporte.

Note

  • AI_GENERATE_RESPONSE está em versão prévia.
  • AI_GENERATE_RESPONSEestá disponível apenas em endpoints de análise SQL e Warehouse no Microsoft Fabric.

Syntax

Convenções de sintaxe de Transact-SQL

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

Arguments

solicitação

Uma expressão de um tipo de caractere que define a instrução.

dados

Entrada de texto opcional usada como contexto de suporte para o prompt.

ERRO

A ON ERROR cláusula controla como uma função de IA lida com erros de processamento.

  • NULL ON ERROR retorna NULL quando a função não consegue processar um valor. Esse é o comportamento padrão e não precisa ser especificado explicitamente.
  • ERROR ON ERROR faz com que toda a consulta falha se ocorrer um erro durante o processamento de qualquer valor de entrada.
  • DEFAULT <value> ON ERROR retorna o valor padrão especificado em vez de NULL quando ocorre um erro.

Erros podem ser causados por verificações de segurança da IA Responsável , limites de tamanho de entrada, problemas de serviço transitório ou outras falhas de processamento.

Tipos de retorno

Retorna nvarchar(max) com texto gerado.

Remarks

As funções de IA retornam NULL se o modelo de IA não conseguir processar o texto. Os motivos comuns incluem:

  • Regras de IA responsável bloqueiam conteúdo inadequado no texto de entrada.
  • O texto de entrada excede os limites de token. O modelo atual dá suporte a até 15 KB de texto.

Exemplos

A. Gerar uma resposta curta

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

B. Gerar respostas por linha

A consulta a seguir envia cada valor de review_text para um serviço externo de IA para gerar resposta.

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;

A cláusula opcional NULL ON ERROR instrui a função de IA a devolver o NULL valor de cada valor de entrada que não pode ser processado.