Voice & Language

1
from signalwire import AgentBase
2
3
class MyAgent(AgentBase):
4
    def __init__(self):
5
        super().__init__(name="my-agent")
6
7
        # Basic language setup
8
        self.add_language(
9
            name="English",       # Display name
10
            code="en-US",         # Language code for STT
11
            voice="rime.spore"    # TTS voice
12
        )

1
## Simple voice (engine.voice)
2
self.add_language("English", "en-US", "rime.spore")
3
4
## With model (engine.voice:model)
5
self.add_language("English", "en-US", "elevenlabs.josh:eleven_turbo_v2_5")

1
self.add_language(
2
    name="English",
3
    code="en-US",
4
    voice="rime.spore",
5
    speech_fillers=[
6
        "Um",
7
        "Well",
8
        "Let me think",
9
        "So"
10
    ],
11
    function_fillers=[
12
        "Let me check that for you",
13
        "One moment please",
14
        "I'm looking that up now",
15
        "Bear with me"
16
    ]
17
)

1
class MultilingualAgent(AgentBase):
2
    def __init__(self):
3
        super().__init__(name="multilingual-agent")
4
5
        # Multi-language support (auto-detects and matches caller's language)
6
        self.add_language(
7
            name="Multilingual",
8
            code="multi",
9
            voice="rime.spore"
10
        )
11
12
        self.prompt_add_section(
13
            "Language",
14
            "Automatically detect and match the caller's language without "
15
            "prompting or asking them to verify. Respond naturally in whatever "
16
            "language they speak."
17
        )

1
class CustomMultilingualAgent(AgentBase):
2
    def __init__(self):
3
        super().__init__(name="custom-multilingual")
4
5
        # English (primary)
6
        self.add_language(
7
            name="English", code="en-US", voice="rime.spore",
8
            speech_fillers=["Um", "Well", "So"],
9
            function_fillers=["Let me check that"]
10
        )
11
12
        # Spanish
13
        self.add_language(
14
            name="Spanish", code="es-MX", voice="rime.luna",
15
            speech_fillers=["Eh", "Pues", "Bueno"],
16
            function_fillers=["Dejame verificar", "Un momento"]
17
        )
18
19
        # French
20
        self.add_language(
21
            name="French", code="fr-FR", voice="rime.claire",
22
            speech_fillers=["Euh", "Alors", "Bon"],
23
            function_fillers=["Laissez-moi verifier", "Un instant"]
24
        )
25
26
        self.prompt_add_section(
27
            "Language",
28
            "Automatically detect and match the caller's language without "
29
            "prompting or asking them to verify."
30
        )

1
class AgentWithPronunciation(AgentBase):
2
    def __init__(self):
3
        super().__init__(name="pronunciation-agent")
4
        self.add_language("English", "en-US", "rime.spore")
5
6
        # Fix brand names
7
        self.add_pronunciation(replace="ACME", with_text="Ack-me")
8
9
        # Fix technical terms
10
        self.add_pronunciation(replace="SQL", with_text="sequel")
11
12
        # Case-insensitive matching
13
        self.add_pronunciation(replace="api", with_text="A P I", ignore_case=True)
14
15
        # Fix names
16
        self.add_pronunciation(replace="Nguyen", with_text="win")

1
## Set all pronunciations at once
2
self.set_pronunciations([
3
    {"replace": "ACME", "with": "Ack-me"},
4
    {"replace": "SQL", "with": "sequel"},
5
    {"replace": "API", "with": "A P I", "ignore_case": True},
6
    {"replace": "CEO", "with": "C E O"},
7
    {"replace": "ASAP", "with": "A sap"}
8
])

1
class DynamicVoiceAgent(AgentBase):
2
    DEPARTMENT_VOICES = {
3
        "support": {"voice": "rime.spore", "name": "Alex"},
4
        "sales": {"voice": "rime.marsh", "name": "Jordan"},
5
        "billing": {"voice": "rime.coral", "name": "Morgan"}
6
    }
7
8
    def __init__(self):
9
        super().__init__(name="dynamic-voice")
10
11
    def on_swml_request(self, request_data=None, callback_path=None, request=None):
12
        call_data = (request_data or {}).get("call", {})
13
        called_num = call_data.get("to", "")
14
15
        if "555-1000" in called_num:
16
            dept = "support"
17
        elif "555-2000" in called_num:
18
            dept = "sales"
19
        else:
20
            dept = "billing"
21
22
        config = self.DEPARTMENT_VOICES[dept]
23
        self.add_language("English", "en-US", config["voice"])
24
        self.prompt_add_section("Role", f"You are {config['name']}, a {dept} representative.")