Function

A Function instance for generating vector embeddings from user-provided raw data in Milvus.

class pymilvus.Function

Constructor

This constructor initializes a new Function instance designed to transform user's raw data into vector embeddings. This is achieved through an automated process that simplifies similarity search operations.

Function(
    name: str,
    function_type: FunctionType,
    input_field_names: Union[str, List[str]],
    output_field_names: Union[str, List[str]],
    description: str = "",
)

PARAMETERS:

name (str) -

[REQUIRED]

The name of the function. This identifier is used to reference the function within queries and collections.
function_type (FunctionType) -

[REQUIRED]

The type of function for processing raw data. Possible values:
- FunctionType.BM25: Uses the BM25 algorithm for generating sparse embeddings from a VARCHAR field.
input_field_names (Union[str, List[str]]) -

[REQUIRED]

The name of the field containing the raw data that requires conversion to vector representation. For functions using FunctionType.BM25, this parameter accepts only one field name.
output_field_names (Union[str, List[str]]) -

[REQUIRED]

The name of the field where the generated embeddings will be stored. This should correspond to a vector field defined in the collection schema. For functions using FunctionType.BM25, this parameter accepts only one field name.
description (str) -

[OPTIONAL]

A brief description of the function's purpose. This can be useful for documentation or clarity in larger projects and defaults to an empty string.

RETURN TYPE:

Instance of Function that encapsulates the specific processing behavior for converting raw data to vector embeddings.

RETURNS:

A Function object that can be registered with a Milvus collection, facilitating automatic embedding generation during data insertion.

EXCEPTIONS:

UnknownFunctionType

This exception will be raised when an unsupported or unrecognized function type is specified.
FunctionIncorrectInputOutputType

This exception will be raised when one or more field names in input_field_names or output_field_names are not strings.
FunctionDuplicateInputs

This exception will be raised when there are duplicate field names in input_field_names.
FunctionDuplicateOutputs

This exception will be raised when there are duplicate field names in output_field_names.
FunctionCommonInputOutput

This exception will be raised when there is an overlap between input_field_names and output_field_names, meaning that the same field name is present in both.

Examples

from pymilvus import Function, FunctionType

bm25_function = Function(
    name="bm25_fn",
    input_field_names=["document_content"],
    output_field_names=["sparse_vector"],
    function_type=FunctionType.BM25,
)

Constructor​

Examples​

Constructor

Examples