AI_GENERATE_RESPONSE (Transact-SQL)

적용 대상:Microsoft Fabric의 SQL 분석 엔드포인트 및 Microsoft Fabric의 웨어하우스

AI_GENERATE_RESPONSE 프롬프트와 선택적 지원 데이터로부터 텍스트를 생성합니다.

메모

  • AI_GENERATE_RESPONSE 는 미리 보기로 제공됩니다.
  • AI_GENERATE_RESPONSESQL 분석 엔드포인트와 Microsoft Fabric의 Warehouse에서만 제공됩니다.

Syntax

Transact-SQL 구문 표기 규칙

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

Arguments

prompt

명령어를 정의하는 문자 유형의 표현 식입니다.

데이터

선택적 텍스트 입력은 프롬프트의 맥락 보조 역할을 합니다.

오류 때

이 절은 ON ERROR AI 함수가 처리 오류를 어떻게 처리하는지를 제어합니다.

  • NULL ON ERROR 함수가 값을 처리할 수 없을 때 반환 NULL 합니다. 이것이 기본 동작이며 명시적으로 명시할 필요는 없습니다.
  • ERROR ON ERROR 입력값을 처리하는 과정에서 오류가 발생하면 전체 쿼리가 실패하게 됩니다.
  • DEFAULT <value> ON ERROR 오류가 발생했을 때 대신 지정된 기본값 NULL 을 반환합니다.

오류는 책임 있는 AI 안전 점검, 입력 크기 제한, 일시적인 서비스 문제, 기타 처리 실패로 인해 발생할 수 있습니다.

반환 형식

생성된 텍스트가 포함된 nvarchar(max)를 반환합니다.

Remarks

AI 모델이 텍스트를 처리할 수 없으면 AI 기능이 반환 NULL 됩니다. 일반적인 이유는 다음과 같습니다.

  • 책임 있는 AI 규칙은 입력 텍스트에서 부적절한 내용을 차단합니다.
  • 입력 텍스트가 토큰 제한을 초과합니다. 현재 모델은 최대 15KB의 텍스트를 지원합니다.

Examples

A. 짧은 응답 생성

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

B. 행당 응답 생성

다음 쿼리는 모든 review_text 값을 외부 AI 서비스에 보내 응답을 생성합니다.

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 하도록 지시합니다.

관련 콘텐츠

  • Last updated on