agrag.embedding.build_embedder

build_embedder(value:str | Embedder, *, tracer:Tracer | None = None) -> Embedder

Build an embedder from a model name, or return an embedder unchanged.

Parameters:

• value (str | Embedder) – A sentence-transformers model name, such as "ibm-granite/granite-embedding-small-english-r2" (the default model), or an already-constructed Embedder for full control over device, batching, or caching.
• tracer (Tracer | None) – Passed to the newly-built embedder. Not valid together with an already-constructed value -- that instance's tracer, if any, was already fixed at its own construction.

Returns:

• Embedder – A ready-to-use embedder.

Raises:

• ValueError – tracer is given together with an already-constructed value.