AI_SUMMARIZE(Transact-SQL)

適用於:Microsoft Fabric 中的 SQL 分析端點與 Microsoft Fabric 中的倉庫

AI_SUMMARIZE 建立輸入文本的簡潔摘要。

Note

  • AI_SUMMARIZE 處於預覽狀態。
  • AI_SUMMARIZE僅在 SQL 分析端點及 Microsoft Fabric 中的 Warehouse 中提供。

Syntax

Transact-SQL 語法慣例

AI_SUMMARIZE ( text [ (NULL | ERROR | DEFAULT <value>) ON ERROR ] )

Arguments

收發簡訊

一個字元類型的 表達式 ,例如 nvarcharvarcharncharchar

失誤

這個 ON ERROR 條款控制 AI 函式如何處理處理錯誤。

  • NULL ON ERROR 當函式無法處理某個值時,會回傳 NULL 。 這是預設行為,不需要特別說明。
  • ERROR ON ERROR 若在處理任何輸入值時發生錯誤,會導致整個查詢失敗。
  • DEFAULT <value> ON ERROR 回傳指定的預設值,而非 NULL 錯誤發生時。

錯誤可能由 負責任的 AI 安全檢查、輸入大小限制、短暫服務問題或其他處理失敗所引起。

傳回類型

回傳包含產生摘要的 nvarchar

Remarks

如果 AI 模型無法處理文字,AI 功能會回傳 NULL 。 常見原因包括:

  • 負責任的 AI 規則會 封鎖輸入文字中的不當內容。
  • 輸入文字超過字符限制。 目前型號最多支援 15 KB 的文字。

Examples

答: 總結一句話

SELECT ai_summarize('The hotel was clean and staff were friendly.') AS summary;

預期結果:Clean hotel, friendly staff.

B. 用表格總結複習文本

以下查詢會將所有review_text值傳送給外部 AI 服務以進行摘要。

SELECT review_id,
       ai_summarize(review_text DEFAULT 'N/A' ON ERROR) AS review_summary
FROM dbo.hotel_reviews;

可選 DEFAULT 'N/A' ON ERROR 子句指示 AI 函式對每個無法處理的輸入值回傳 'N/A' 值。