Voices & Languages

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

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",
8
            code="en-US",
9
            voice="rime.spore",
10
            speech_fillers=["Um", "Well", "So"],
11
            function_fillers=["Let me check that"]
12
        )
13
14
        # Spanish
15
        self.add_language(
16
            name="Spanish",
17
            code="es-MX",
18
            voice="rime.luna",
19
            speech_fillers=["Eh", "Pues", "Bueno"],
20
            function_fillers=["Dejame verificar", "Un momento"]
21
        )
22
23
        # French
24
        self.add_language(
25
            name="French",
26
            code="fr-FR",
27
            voice="rime.claire",
28
            speech_fillers=["Euh", "Alors", "Bon"],
29
            function_fillers=["Laissez-moi verifier", "Un instant"]
30
        )
31
32
        self.prompt_add_section(
33
            "Language",
34
            "Automatically detect and match the caller's language without "
35
            "prompting or asking them to verify."
36
        )

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(
8
            replace="ACME",
9
            with_text="Ack-me"
10
        )
11
12
        # Fix technical terms
13
        self.add_pronunciation(
14
            replace="SQL",
15
            with_text="sequel"
16
        )
17
18
        # Case-insensitive matching
19
        self.add_pronunciation(
20
            replace="api",
21
            with_text="A P I",
22
            ignore_case=True
23
        )
24
25
        # Fix names
26
        self.add_pronunciation(
27
            replace="Nguyen",
28
            with_text="win"
29
        )

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
        # Determine department from called number
13
        call_data = (request_data or {}).get("call", {})
14
        called_num = call_data.get("to", "")
15
16
        if "555-1000" in called_num:
17
            dept = "support"
18
        elif "555-2000" in called_num:
19
            dept = "sales"
20
        else:
21
            dept = "billing"
22
23
        config = self.DEPARTMENT_VOICES[dept]
24
25
        self.add_language("English", "en-US", config["voice"])
26
27
        self.prompt_add_section(
28
            "Role",
29
            f"You are {config['name']}, a {dept} representative."
30
        )

1
from signalwire_agents import AgentBase
2
3
4
class FullyConfiguredVoiceAgent(AgentBase):
5
    def __init__(self):
6
        super().__init__(name="voice-configured")
7
8
        # Primary language with all options
9
        self.add_language(
10
            name="English",
11
            code="en-US",
12
            voice="rime.spore",
13
            speech_fillers=[
14
                "Um",
15
                "Well",
16
                "Let me see",
17
                "So"
18
            ],
19
            function_fillers=[
20
                "Let me look that up for you",
21
                "One moment while I check",
22
                "I'm searching for that now",
23
                "Just a second"
24
            ]
25
        )
26
27
        # Secondary language
28
        self.add_language(
29
            name="Spanish",
30
            code="es-MX",
31
            voice="rime.luna",
32
            speech_fillers=["Pues", "Bueno"],
33
            function_fillers=["Un momento", "Dejame ver"]
34
        )
35
36
        # Pronunciation fixes
37
        self.set_pronunciations([
38
            {"replace": "ACME", "with": "Ack-me"},
39
            {"replace": "www", "with": "dub dub dub"},
40
            {"replace": ".com", "with": "dot com"},
41
            {"replace": "@", "with": "at"}
42
        ])
43
44
        self.prompt_add_section(
45
            "Role",
46
            "You are a friendly customer service agent."
47
        )