適用対象:
Microsoft Fabric の SQL 分析エンドポイントと Microsoft Fabric のウェアハウス
AI_GENERATE_RESPONSE プロンプトとオプションのサポートデータからテキストを生成します。
Note
-
AI_GENERATE_RESPONSEはプレビュー段階です。 -
AI_GENERATE_RESPONSESQL分析エンドポイントおよびMicrosoft FabricのWarehouseでのみ利用可能です。
Syntax
AI_GENERATE_RESPONSE ( prompt [ , data ] [ (NULL | ERROR | DEFAULT <value>) ON ERROR ] )
引数
ダイアログを表示する
命令を定義する文字タイプの 式 です。
データ
プロンプトの文脈補助としてオプションのテキスト入力が使われます。
エラーで
ON ERROR節はAI関数が処理エラーをどのように扱うかを制御します。
-
NULL ON ERROR関数が値を処理できない場合にNULL返します。 これはデフォルトの動作であり、明示的に指定する必要はありません。 -
ERROR ON ERROR入力値の処理中にエラーが発生した場合、クエリ全体が失敗します。 -
DEFAULT <value> ON ERRORエラーが発生した場合、NULLではなく指定されたデフォルト値を返します。
エラーは 責任あるAI の安全チェック、入力サイズ制限、一時的なサービス問題、その他の処理障害によって引き起こされることがあります。
戻り値の型
生成されたテキストとともに nvarchar(max) を返します。
Remarks
AIモデルがテキストを処理できない場合、AI関数は NULL を返します。 一般的な理由は次のとおりです。
- 責任あるAIルールは 入力テキスト内の不適切な内容をブロックします。
- 入力テキストがトークンの制限を超えています。 現在のモデルでは、最大 15 KB のテキストがサポートされています。
Examples
A. 短い回答を生成してください
SELECT ai_generate_response('Reply in 20 words:', 'The room was noisy.') AS response;
B. 1行あたりの応答を生成します
次のクエリは、すべての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 値を返すよう指示します。