VoiceBuilderExtensions

Namespace Tracon · Assembly Tracon.Voice.dll

Adds the voice tools to the Tracon chain.

public static class VoiceBuilderExtensions

Inheritance

object ← VoiceBuilderExtensions

Inherited Members

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Methods

UseVoice(ITraconBuilder, IConfiguration, Action<VoiceOptions>?)

Registers the voice tools, reading settings from configuration.

public static ITraconBuilder UseVoice(this ITraconBuilder builder, IConfiguration configurationSection, Action<VoiceOptions>? configure = null)

Parameters

builder ITraconBuilder

The Tracon chain.

configurationSection IConfiguration

The Tracon:Voice section.

configure Action<VoiceOptions>?

Changes to apply after configuration binding.

Returns

ITraconBuilder

The continuation of the chain.

Remarks

Registers the speech tools an agent can call. The real-time conversation layer is a separate, opt-in call (UseVoiceConversation).

builder.AddTracon()
       .UseVoice(builder.Configuration.GetSection("Tracon:Voice"));

Exceptions

ArgumentNullException

When a dependency is null.

UseVoice(ITraconBuilder, Action<VoiceOptions>)

Registers the voice tools.

public static ITraconBuilder UseVoice(this ITraconBuilder builder, Action<VoiceOptions> configure)

Parameters

builder ITraconBuilder

The Tracon chain.

configure Action<VoiceOptions>

The settings.

Returns

ITraconBuilder

The continuation of the chain.

Remarks

Registration uses TryAdd*: when the consumer registered its own ISpeechSynthesizer or ISpeechTranscriber implementation BEFORE this call, theirs is preserved.

Three tools are registered: speak, transcribe, list_voices. tools are defined IN CODE; the UI only selects them.

Exceptions

ArgumentNullException

When a dependency is null.