Package dev.agenor.core.knowledge

Class EmbeddingException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

dev.agenor.core.exceptions.AgenorException

dev.agenor.core.knowledge.EmbeddingException

All Implemented Interfaces:

Serializable

public class EmbeddingException
extends AgenorException

Typed exception thrown by EmbeddingProvider implementations.

Mirrors the structure of LLMException. The EmbeddingException.ErrorType enum allows callers to apply provider-independent error-handling strategies (e.g. exponential back-off on EmbeddingException.ErrorType.RATE_LIMIT).

Example:

 provider.embed(text).exceptionally(ex -> {
     if (ex.getCause() instanceof EmbeddingException e) {
         if (e.getErrorType() == EmbeddingException.ErrorType.RATE_LIMIT) {
             // schedule retry with back-off
         }
     }
     return null;
 });
 

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	EmbeddingException.ErrorType	Classifies the root cause of an embedding failure.

Constructor Summary

Constructors

Constructor	Description
EmbeddingException(String message, EmbeddingException.ErrorType errorType)	Constructs a new EmbeddingException without a cause.
EmbeddingException(String message, EmbeddingException.ErrorType errorType, Throwable cause)	Constructs a new EmbeddingException wrapping an underlying cause.

Method Summary

Modifier and Type	Method	Description
EmbeddingException.ErrorType	getErrorType()	Returns the error classification that allows provider-independent handling.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

EmbeddingException

public EmbeddingException(String message,
 EmbeddingException.ErrorType errorType)

Constructs a new EmbeddingException without a cause.

Parameters:

message - human-readable error description

errorType - classification of the error

EmbeddingException

public EmbeddingException(String message,
 EmbeddingException.ErrorType errorType,
 Throwable cause)

Constructs a new EmbeddingException wrapping an underlying cause.

Parameters:

message - human-readable error description

errorType - classification of the error

cause - underlying exception

Method Details

getErrorType

public EmbeddingException.ErrorType getErrorType()

Returns the error classification that allows provider-independent handling.

Returns:

non-null EmbeddingException.ErrorType