AI_GENERATE_RESPONSE (Transact-SQL)

Berlaku untuk:Titik akhir analitik SQL di Microsoft Fabric dan Warehouse di Microsoft Fabric

AI_GENERATE_RESPONSE menghasilkan teks dari data pendukung prompt dan opsional.

Note

  • AI_GENERATE_RESPONSE dalam tahap pratinjau.
  • AI_GENERATE_RESPONSEhanya tersedia di titik akhir analitik SQL dan Gudang di Microsoft Fabric.

Syntax

Konvensi sintaks Transact-SQL

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

Arguments

minta

Ekspresi jenis karakter yang mendefinisikan instruksi.

data

Input teks opsional digunakan sebagai konteks pendukung untuk perintah.

KARENA KESALAHAN

Klausul ini ON ERROR mengatur bagaimana fungsi AI menangani kesalahan pemrosesan.

  • NULL ON ERROR Mengembalikan NULL ketika fungsi tidak dapat memproses sebuah nilai. Ini adalah perilaku default dan tidak perlu dijelaskan secara eksplisit.
  • ERROR ON ERROR menyebabkan seluruh kueri gagal jika terjadi kesalahan saat memproses nilai input apa pun.
  • DEFAULT <value> ON ERROR mengembalikan nilai default yang ditentukan, bukan NULL saat terjadi kesalahan.

Kesalahan dapat disebabkan oleh pemeriksaan keamanan AI yang bertanggung jawab , batas ukuran input, masalah layanan sementara, atau kegagalan pemrosesan lainnya.

Tipe pengembalian

Mengembalikan nvarchar(max) dengan teks yang dihasilkan.

Remarks

Fungsi AI kembali NULL jika model AI tidak dapat memproses teks. Alasan umum termasuk:

  • Aturan AI yang bertanggung jawab memblokir konten yang tidak pantas dalam teks input.
  • Teks input melebihi batas token. Model saat ini mendukung hingga 15 KB teks.

Examples

A. Hasilkan respons singkat

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

B. Menghasilkan respons per baris

Kueri berikut mengirimkan setiap nilai review_text ke layanan AI eksternal untuk menghasilkan respons.

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;

Klausa opsional NULL ON ERROR menginstruksikan fungsi AI untuk mengembalikan NULL nilai untuk setiap nilai input yang tidak dapat diproses.