Hints

1
from signalwire import AgentBase
2
3
class MyAgent(AgentBase):
4
    def __init__(self):
5
        super().__init__(name="my-agent")
6
        self.add_language("English", "en-US", "rime.spore")
7
8
        # Add single hint
9
        self.add_hint("Acme")
10
        self.add_hint("SignalWire")

1
## Add list of hints
2
self.add_hints([
3
    "Acme",
4
    "SignalWire",
5
    "API",
6
    "webhook",
7
    "SWML"
8
])

1
self.add_hints([
2
    "Acme", "Acme Pro", "Acme Enterprise",
3
    "account", "billing", "refund", "exchange", "return",
4
    "cancel", "upgrade", "downgrade",
5
    "representative", "supervisor", "escalate", "ticket",
6
    "case number", "reference number"
7
])

1
self.add_hints([
2
    "Windows", "macOS", "Linux", "Chrome", "Firefox",
3
    "reboot", "restart", "reinstall", "cache", "cookies",
4
    "browser", "firewall", "antivirus", "driver",
5
    "error code", "blue screen", "crash", "freeze",
6
    "not responding", "won't start"
7
])

1
self.add_hints([
2
    "appointment", "reschedule", "cancel", "follow-up",
3
    "prescription", "refill", "pharmacy", "dosage",
4
    "medication", "symptoms", "diagnosis",
5
    "cardiology", "dermatology", "pediatrics", "radiology",
6
    "Tylenol", "Advil", "Lipitor", "Metformin"
7
])

1
self.add_hints([
2
    "checking", "savings", "IRA", "401k", "Roth",
3
    "transfer", "deposit", "withdrawal", "wire",
4
    "ACH", "routing number", "account number",
5
    "mortgage", "auto loan", "credit card", "overdraft",
6
    "social security", "date of birth", "mother's maiden name"
7
])

1
self.add_pattern_hint(
2
    hint="what STT should listen for",
3
    pattern=r"regex pattern to match",
4
    replace="normalized output",
5
    ignore_case=True  # optional, default False
6
)

1
self.add_pattern_hint(
2
    hint="Acme",
3
    pattern=r"(acme|ackme|ac me|acmee)",
4
    replace="Acme",
5
    ignore_case=True
6
)
7
8
self.add_pattern_hint(
9
    hint="SignalWire",
10
    pattern=r"(signal wire|signalwire|signal-wire)",
11
    replace="SignalWire",
12
    ignore_case=True
13
)

1
self.add_pattern_hint(
2
    hint="account number",
3
    pattern=r"\d{8}",
4
    replace="${0}"
5
)
6
7
self.add_pattern_hint(
8
    hint="order ID",
9
    pattern=r"ORD[-\s]?\d{5,8}",
10
    replace="${0}",
11
    ignore_case=True
12
)

1
self.add_pattern_hint(
2
    hint="phone number",
3
    pattern=r"\d{3}[-.\s]?\d{3}[-.\s]?\d{4}",
4
    replace="${0}"
5
)

1
self.add_pattern_hint(
2
    hint="email",
3
    pattern=r"\S+@\S+\.\S+",
4
    replace="${0}"
5
)

1
self.add_pattern_hint(
2
    hint="date",
3
    pattern=r"(jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec)[a-z]*\s+\d{1,2}(st|nd|rd|th)?",
4
    replace="${0}",
5
    ignore_case=True
6
)

1
import logging
2
logging.basicConfig(level=logging.DEBUG)

1
class OrganizedHintsAgent(AgentBase):
2
    BRAND_HINTS = ["Acme", "Acme Pro", "Acme Enterprise"]
3
    ACTION_HINTS = ["account", "billing", "refund", "cancel"]
4
    SUPPORT_HINTS = ["representative", "supervisor", "escalate"]
5
6
    def __init__(self):
7
        super().__init__(name="organized-hints")
8
        self.add_language("English", "en-US", "rime.spore")
9
        self.add_hints(self.BRAND_HINTS)
10
        self.add_hints(self.ACTION_HINTS)
11
        self.add_hints(self.SUPPORT_HINTS)

1
class DynamicHintsAgent(AgentBase):
2
    DEPARTMENT_HINTS = {
3
        "sales": ["pricing", "quote", "demo", "trial", "discount"],
4
        "support": ["ticket", "bug", "error", "fix", "issue"],
5
        "billing": ["invoice", "payment", "refund", "charge"]
6
    }
7
8
    def __init__(self):
9
        super().__init__(name="dynamic-hints")
10
        self.add_language("English", "en-US", "rime.spore")
11
        self.add_hints(["Acme", "account", "help"])
12
13
    def on_swml_request(self, request_data=None, callback_path=None, request=None):
14
        call_data = (request_data or {}).get("call", {})
15
        called_num = call_data.get("to", "")
16
17
        if "555-1000" in called_num:
18
            self.add_hints(self.DEPARTMENT_HINTS["sales"])
19
        elif "555-2000" in called_num:
20
            self.add_hints(self.DEPARTMENT_HINTS["support"])
21
        else:
22
            self.add_hints(self.DEPARTMENT_HINTS["billing"])