Struct ExternalEmbedding 

pub struct ExternalEmbedding { /* private fields */ }

External embedding provider.

This provider is used when embeddings are generated externally (e.g., by OpenAI, Cohere, or a custom service). It validates embedding dimensions but cannot generate embeddings itself.

Usage

When using ExternalEmbedding, you must provide pre-computed embedding vectors when recording experiences. Attempting to call embed() or embed_batch() will return an error.

Example

use pulsedb::embedding::{EmbeddingService, ExternalEmbedding};

// Create for OpenAI ada-002 (1536 dimensions)
let service = ExternalEmbedding::new(1536);
assert_eq!(service.dimension(), 1536);

Implementations

impl ExternalEmbedding

pub fn new(dimension: usize) -> Self

Creates a new external embedding provider with the given dimension.

Arguments

• dimension - The expected embedding dimension

Example

use pulsedb::embedding::ExternalEmbedding;

// all-MiniLM-L6-v2
let service = ExternalEmbedding::new(384);

// OpenAI text-embedding-3-small
let service = ExternalEmbedding::new(1536);

Trait Implementations

impl Clone for ExternalEmbedding

fn clone(&self) -> ExternalEmbedding

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ExternalEmbedding

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

Formats the value using the given formatter.

impl EmbeddingService for ExternalEmbedding

fn embed(&self, _text: &str) -> Result<Embedding>

Generates an embedding for a single text.

fn embed_batch(&self, _texts: &[&str]) -> Result<Vec<Embedding>>

Generates embeddings for multiple texts in a batch.

fn dimension(&self) -> usize

Returns the dimension of embeddings produced by this service.

fn validate_embedding(&self, embedding: &Embedding) -> Result<()>

Validates that an embedding has the correct dimension.