Struct EmbeddingsBuilder 

pub struct EmbeddingsBuilder<T> { /* private fields */ }

Accumulates documents and embeds their extracted texts in provider-sized batches. Text extraction occurs when documents are added; requests start when built.

Implementations

impl<T: Embed> EmbeddingsBuilder<T>

pub fn new(model: impl Into<DynModel<EmbeddingOp>>) -> Self

Create a new embedding builder with the given embedding model

pub fn document(self, document: T) -> Result<Self, EmbedError>

Add a document to be embedded to the builder. document must implement the Embed trait.

pub fn documents( self, documents: impl IntoIterator<Item = T>, ) -> Result<Self, EmbedError>

Add multiple documents to be embedded to the builder. documents must be iterable with items that implement the Embed trait.

impl<T> EmbeddingsBuilder<T>

where T: Embed + WasmCompatSend,

pub async fn build(self) -> Result<Vec<(T, Vec<Embedding>)>, ProviderError>

Generate embeddings for all documents in the builder.

Returns (document, embeddings) pairs. A document may produce one or many embeddings depending on how its Embed implementation uses TextEmbedder.

Preserves document insertion order and each document’s text order, regardless of batch completion order. Providers must return embeddings in input order within each batch; this is not checked.

Propagates provider and transport errors. Returns an error identifying the document if it produces no text or a batch returns too few embeddings. Empty embedded collections produce no text. Surplus embeddings are ignored.