Themis.Maf 1.0.0

Themis.Maf

Use Themis.Maf when an application already uses Microsoft Agent Framework or Microsoft.Extensions.AI and wants to connect that conversational flow to Themis. The package adapts a registered IInferenceProvider into an IChatClient and agent factory; it does not turn typed decision inference into chat or provide a model by itself.

The package targets .NET 10. AddThemisMaf registers Themis services and the adapter; provide a conversational inference provider and its model separately. The separate Themis.Inference.Ollama package implements chat without its own ONNX Runtime or tokenizer dependency. The legacy Themis.Maf registration still depends on Themis to preserve existing AddThemisMaf behavior.

services.AddThemisMaf(
    configure: maf =>
    {
        maf.Model = "chat-model";
        maf.Temperature = 0.2;
        maf.MaxOutputTokens = 512;
        maf.TopP = 0.9;
        maf.EnableToolCalls = true;
        maf.EnableStructuredOutput = true;
        maf.EnableStreaming = true;
    },
    configureServices: registrations =>
        registrations.AddSingleton<IInferenceProvider, MyConversationalProvider>());

The package registers IChatClient, IThemisMafProvider, and ThemisMafAgentFactory. The provider abstraction keeps the adapter independent from a specific remote chat vendor; applications can replace IThemisMafProvider or IChatClient through configureServices. The MAF options supply default generation settings; per-request ChatOptions.ModelId, temperature, maximum output tokens, top-p, stop sequences, and seed take precedence. IInferenceProvider must be registered for conversational inference, while Themis options and other service implementations can be configured through the same registration call. Tool calls, JSON response formats, and true provider streaming are disabled by default. Enable them explicitly with the corresponding ThemisMafOptions properties; the Ollama provider supports these capabilities. Unsupported content or provider capabilities fail with an informative NotSupportedException rather than being ignored. The adapter also forwards frequency and presence penalties to providers that support them; Ollama reports them as unsupported because its chat API does not provide equivalent controls. Non-streaming token usage maps to ChatResponse.Usage; streamed usage is available on the final update through the rldc.usage additional property. This adapter targets conversational inference through IInferenceProvider; typed decision inference is a separate IDecisionInferenceProvider contract and is not automatically adapted into an MAF chat client.

Use the factory's callback to configure the chat-backed agent:

var agent = serviceProvider
    .GetRequiredService<ThemisMafAgentFactory>()
    .Create(static _ => { });

Typed application-input mapping is provided by the separate Themis.Engine project; see the root README for its attributes, runtime criteria, and keyed mapping examples.

License

Themis' adapter code is licensed under MIT, and the NuGet package includes the Themis license text. Its Microsoft Agent Framework and Microsoft.Extensions.AI dependencies retain their own terms; model assets and providers are also separately licensed.