Rediger

AI_CLASSIFY (Transact-SQL)

Applies to: SQL analytics endpoint in Microsoft Fabric and Warehouse in Microsoft Fabric

The AI_CLASSIFY function classifies input text into one of the labels you provide.

Note

  • AI_CLASSIFY is in preview.
  • AI_CLASSIFY is available only in SQL analytics endpoint and Warehouse in Microsoft Fabric.

Syntax

Transact-SQL syntax conventions

AI_CLASSIFY ( text, class1, class2 [ , ...n ] )

Arguments

text

An expression of a character type, for example nvarchar, varchar, nchar, or char.

class1, class2, ...n

One or more candidate class labels, provided as string literals or string expressions.

Return types

Returns nvarchar containing the selected class label.

Remarks

AI functions return NULL if the AI model can't process the text. Common reasons include:

  • Responsible AI rules block inappropriate content in the input text.
  • Input text exceeds token limits. The current model supports up to 15 KB of text.

Examples

A. Classify text with custom labels

SELECT ai_classify('Room was dirty', 'service', 'dirt', 'food') AS classification;

Expected result: dirt

B. Classify rows in a table

SELECT review_id,
       ai_classify(review_text, 'service', 'dirt', 'food', 'other') AS category
FROM dbo.hotel_reviews;