Enum RagError 

#[non_exhaustive]
pub enum RagError {
    EmptyDocument,
    EmptyQuery,
    NoDocumentsIndexed,
    EmbeddingFailed(String),
    DimensionMismatch {
        expected: usize,
        got: usize,
    },
    Persistence(String),
    NonFinite,
    InvalidFilter(String),
    Io(Error),
}

Errors that can occur in the RAG pipeline.

The enum is marked #[non_exhaustive] so that new variants can be added in patch releases without breaking downstream pattern-matching. Callers should always include a wildcard (_ => ...) arm when exhaustively matching on RagError.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

EmptyDocument

Input document was empty (no text to index).

EmptyQuery

Query string was empty.

NoDocumentsIndexed

Retrieval was attempted before any documents were indexed.

EmbeddingFailed(String)

The embedding backend failed to produce a vector.

DimensionMismatch

A vector was inserted with a dimensionality that does not match the store’s dimension.

Fields

expected: usize

The dimensionality the store was configured with.

got: usize

The dimensionality of the offending vector.

Persistence(String)

A persistence operation (save, load, schema-version check) failed.

NonFinite

A vector or scalar input contained NaN or ±∞. Distance metrics reject non-finite inputs eagerly rather than silently propagating poison values through downstream arithmetic.

InvalidFilter(String)

A metadata filter was ill-formed (e.g. empty key, empty In list).

Io(Error)

I/O error (wraps std::io::Error).

Trait Implementations

impl Debug for RagError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for RagError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for RagError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for RagError

fn from(source: Error) -> Self

Converts to this type from the input type.