Skip to content

Pipeline Config

VoicePipelineConfig dataclass

Configuration for a VoicePipeline.

Source code in src/agents/voice/pipeline_config.py 
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
@dataclass
class VoicePipelineConfig:
    """Configuration for a `VoicePipeline`."""

    model_provider: VoiceModelProvider = field(default_factory=OpenAIVoiceModelProvider)
    """The voice model provider to use for the pipeline. Defaults to OpenAI."""

    tracing_disabled: bool = False
    """Whether to disable tracing of the pipeline. Defaults to `False`."""

    tracing: TracingConfig | None = None
    """Tracing configuration for this pipeline."""

    trace_include_sensitive_data: bool = True
    """Whether to include sensitive data in traces. Defaults to `True`. This is specifically for the
      voice pipeline, and not for anything that goes on inside your Workflow."""

    trace_include_sensitive_audio_data: bool = True
    """Whether to include audio data in traces. Defaults to `True`."""

    workflow_name: str = "Voice Agent"
    """The name of the workflow to use for tracing. Defaults to `Voice Agent`."""

    group_id: str = field(default_factory=gen_group_id)
    """
    A grouping identifier to use for tracing, to link multiple traces from the same conversation
    or process. If not provided, we will create a random group ID.
    """

    trace_metadata: dict[str, Any] | None = None
    """
    An optional dictionary of additional metadata to include with the trace.
    """

    stt_settings: STTModelSettings = field(default_factory=STTModelSettings)
    """The settings to use for the STT model."""

    tts_settings: TTSModelSettings = field(default_factory=TTSModelSettings)
    """The settings to use for the TTS model."""

    if TYPE_CHECKING:

        def __init__(
            self,
            model_provider: VoiceModelProvider = ...,
            tracing_disabled: bool = False,
            tracing: TracingConfig | None = None,
            trace_include_sensitive_data: bool = True,
            trace_include_sensitive_audio_data: bool = True,
            workflow_name: str = "Voice Agent",
            group_id: str = ...,
            trace_metadata: dict[str, Any] | None = None,
            stt_settings: STTModelSettings | dict[str, Any] = ...,
            tts_settings: TTSModelSettings | dict[str, Any] = ...,
        ) -> None: ...

    def __post_init__(self) -> None:
        self.stt_settings = coerce_dataclass_config(
            self.stt_settings,
            _declared_dataclass_type(type(self), "stt_settings", STTModelSettings),
            parameter_name="voice.stt",
        )
        self.tts_settings = coerce_dataclass_config(
            self.tts_settings,
            _declared_dataclass_type(type(self), "tts_settings", TTSModelSettings),
            parameter_name="voice.tts",
        )

model_provider class-attribute instance-attribute 

model_provider: VoiceModelProvider = field(
    default_factory=OpenAIVoiceModelProvider
)

The voice model provider to use for the pipeline. Defaults to OpenAI.

tracing_disabled class-attribute instance-attribute 

tracing_disabled: bool = False

Whether to disable tracing of the pipeline. Defaults to False.

tracing class-attribute instance-attribute 

tracing: TracingConfig | None = None

Tracing configuration for this pipeline.

trace_include_sensitive_data class-attribute instance-attribute 

trace_include_sensitive_data: bool = True

Whether to include sensitive data in traces. Defaults to True. This is specifically for the voice pipeline, and not for anything that goes on inside your Workflow.

trace_include_sensitive_audio_data class-attribute instance-attribute 

trace_include_sensitive_audio_data: bool = True

Whether to include audio data in traces. Defaults to True.

workflow_name class-attribute instance-attribute 

workflow_name: str = 'Voice Agent'

The name of the workflow to use for tracing. Defaults to Voice Agent.

group_id class-attribute instance-attribute 

group_id: str = field(default_factory=gen_group_id)

A grouping identifier to use for tracing, to link multiple traces from the same conversation or process. If not provided, we will create a random group ID.

trace_metadata class-attribute instance-attribute 

trace_metadata: dict[str, Any] | None = None

An optional dictionary of additional metadata to include with the trace.

stt_settings class-attribute instance-attribute 

stt_settings: STTModelSettings = field(
    default_factory=STTModelSettings
)

The settings to use for the STT model.

tts_settings class-attribute instance-attribute 

tts_settings: TTSModelSettings = field(
    default_factory=TTSModelSettings
)

The settings to use for the TTS model.