Method GetTopCategoriesAsync

Namespace

LMKit.TextAnalysis

Assembly

LM-Kit.NET.dll

GetTopCategoriesAsync(IList<string>, string, int, bool, CancellationToken)

Asynchronously classifies the specified plain text into up to a specified maximum number of categories.

public Task<List<int>> GetTopCategoriesAsync(IList<string> categories, string content, int maxCategories, bool normalize = true, CancellationToken cancellationToken = default)

Parameters

categories IList<string>

A list of predefined category names.

content string

The plain text to be classified.

maxCategories int

The maximum number of top categories to return.

normalize bool

Optional. Specifies whether the input parameters should be normalized. The default is true.

cancellationToken CancellationToken

Optional. A CancellationToken for handling cancellation requests.

Returns

Task<List<int>>

A task representing the asynchronous operation. The task result is a list of indices representing the top categories for the given text. The indices correspond to positions in the input categories list.

Examples

// Asynchronous usage:
var categories = new List<string> { "finance", "travel", "entertainment", "politics", "technology" };
string text = "The government unveiled a new technology policy impacting the finance sector.";

IList<int> topCategories = await categorization.GetTopCategoriesAsync(categories, text, 3);

Console.WriteLine("Top categories:");
foreach (var index in topCategories)
{
    Console.WriteLine(categories[index]);
}

Exceptions

OperationCanceledException

Thrown if the operation is canceled via the cancellationToken.

GetTopCategoriesAsync(IList<string>, Attachment, int, bool, CancellationToken)

Asynchronously classifies the content provided as an attachment into up to a specified maximum number of categories. The attachment may contain either plain text or image data. For image attachments that require vision processing, the underlying language model must support vision input.

public Task<List<int>> GetTopCategoriesAsync(IList<string> categories, Attachment content, int maxCategories, bool normalize = true, CancellationToken cancellationToken = default)

Parameters

categories IList<string>

A list of predefined category names.

content Attachment

The attachment to be classified, representing either plain text or image content.

maxCategories int

The maximum number of top categories to return.

normalize bool

Optional. Specifies whether the input parameters should be normalized. The default is true.

cancellationToken CancellationToken

Optional. A CancellationToken for handling cancellation requests.

Returns

Task<List<int>>

A task representing the asynchronous operation. The task result is a list of indices representing the top categories for the given attachment. The indices correspond to positions in the input categories list.

Exceptions

InvalidModelException

Thrown when the attachment is an image requiring vision processing but the underlying language model lacks vision support.