VoyageAI.Microsoft.Extensions.AI 1.0.1

VoyageAI.Microsoft.Extensions.AI

Microsoft.Extensions.AI integration for the Voyage AI .NET SDK. Implements IEmbeddingGenerator<string, Embedding<float>> over Voyage text embeddings, so Voyage plugs into the standard .NET AI composition model instead of a parallel abstraction.

This is the keystone package for product integrations: once Voyage speaks IEmbeddingGenerator, the MongoDB driver's native auto-embedding, Microsoft.Extensions.VectorData, Semantic Kernel, and MEAI's caching/batching/logging/OpenTelemetry middleware all work with no per-integration embed code.

Targets .NET 10 and .NET 8 (LTS), AOT/trim safe on .NET 10.

Installation

dotnet add package VoyageAI.Microsoft.Extensions.AI

Quick start (DI + middleware composition)

Program.cs:

var builder = Host.CreateApplicationBuilder(args);

// Registers the Voyage SDK + an IEmbeddingGenerator over it, and returns a builder so
// the standard MEAI middleware composes on top.
builder.Services.AddVoyageEmbeddingGenerator(opts =>
{
    opts.Model = VoyageAIModels.Voyage3Large;
    opts.OutputDimension = 1024;
})
.UseOpenTelemetry();   // optional: trace every embedding call

var app = builder.Build();
var generator = app.Services.GetRequiredService<IEmbeddingGenerator<string, Embedding<float>>>();

GeneratedEmbeddings<Embedding<float>> result =
    await generator.GenerateAsync(["I like cats", "I like dogs"]);
Console.WriteLine($"{result.Count} embeddings, {result.Usage.TotalTokenCount} tokens");

API key is resolved the same way as the core SDK: the "VoyageAI:ApiKey" configuration section, falling back to the VOYAGE_API_KEY environment variable.

Standalone (no DI)

IEmbeddingsClient client = ...; // resolved from the Voyage SDK
var generator = new VoyageEmbeddingGenerator(client, new VoyageEmbeddingGeneratorOptions
{
    Model = VoyageAIModels.Voyage3,
    InputType = InputType.Document,
});

Embedding<float> single = (await generator.GenerateAsync(["store hiking boots"]))[0];
Console.WriteLine($"{single.Vector.Length} dims");

Options reference

How mappings work

Microsoft.Extensions.AI → Voyage request:

Voyage response → MEAI:

Getting the raw client back

GetService exposes the underlying client so components that need non-embedding capabilities (rerank, multimodal) can reach them:

if (generator.GetService(typeof(IEmbeddingsClient)) is IEmbeddingsClient raw)
{
    // use raw directly
}

License

MIT — see LICENSE.