AI_GENERATE_RESPONSE (Transact-SQL)

Gäller för:SQL-analysslutpunkt i Microsoft Fabric och Warehouse i Microsoft Fabric

AI_GENERATE_RESPONSE genererar text från en prompt och valfri stödjande data.

Note

  • AI_GENERATE_RESPONSE är i förhandsversion.
  • AI_GENERATE_RESPONSEfinns endast i SQL analytics endpoint och Warehouse i Microsoft Fabric.

Syntax

Transact-SQL syntaxkonventioner

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

Arguments

prompt

Ett uttryck av en teckentyp som definierar instruktionen.

data

Valfri textinmatning används som stödjande kontext för prompten.

PÅ MISSTAG

Klausulen ON ERROR styr hur en AI-funktion hanterar bearbetningsfel.

  • NULL ON ERROR returnerar NULL när funktionen inte kan bearbeta ett värde. Detta är standardbeteendet och behöver inte specificeras uttryckligen.
  • ERROR ON ERROR gör att hela frågan misslyckas om ett fel uppstår under bearbetningen av något indatavärde.
  • DEFAULT <value> ON ERROR returnerar det angivna standardvärdet istället för NULL när ett fel uppstår.

Fel kan orsakas av säkerhetskontroller för Responsible AI , begränsningar av inmatningsstorlek, problem med tillfällig service eller andra bearbetningsfel.

Returtyper

Returnerar nvarchar(max) med genererad text.

Remarks

AI-funktioner återvänder NULL om AI-modellen inte kan bearbeta texten. Vanliga orsaker är:

  • Ansvarsfulla AI-regler blockerar olämpligt innehåll i inmatningstexten.
  • Indatatexten överskrider tokengränserna. Den aktuella modellen stöder upp till 15 kB text.

Examples

A. Generera ett kort svar

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

B. Generera svar per rad

Följande fråga skickar varje review_text värde till extern AI-tjänst för att generera svar.

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;

Den valfria NULL ON ERROR klausulen instruerar AI-funktionen att returnera NULL värdet för varje indata som inte kan bearbetas.