Call Recording

1
from signalwire import AgentBase
2
from signalwire.core.function_result import FunctionResult
3
4
class RecordingAgent(AgentBase):
5
    def __init__(self):
6
        super().__init__(name="recording-agent")
7
        self.add_language("English", "en-US", "rime.spore")
8
9
        self.prompt_add_section(
10
            "Role",
11
            "You are a customer service agent. "
12
            "Start recording when the customer agrees."
13
        )
14
15
        self.define_tool(
16
            name="start_recording",
17
            description="Start recording the call with customer consent",
18
            parameters={"type": "object", "properties": {}},
19
            handler=self.start_recording
20
        )
21
22
    def start_recording(self, args, raw_data):
23
        return (
24
            FunctionResult("Recording has started.")
25
            .record_call(
26
                control_id="main_recording",
27
                stereo=True,
28
                format="wav"
29
            )
30
        )
31
32
if __name__ == "__main__":
33
    agent = RecordingAgent()
34
    agent.run()

1
def start_stereo_recording(self, args, raw_data):
2
    return (
3
        FunctionResult("Recording in stereo mode")
4
        .record_call(
5
            control_id="stereo_rec",
6
            stereo=True,  # Caller on left, agent on right
7
            format="wav"
8
        )
9
    )

1
def start_mono_recording(self, args, raw_data):
2
    return (
3
        FunctionResult("Recording in mono mode")
4
        .record_call(
5
            control_id="mono_rec",
6
            stereo=False,  # Mixed audio (default)
7
            format="mp3"
8
        )
9
    )

1
## Record only what the AI/agent speaks
2
def record_agent_only(self, args, raw_data):
3
    return (
4
        FunctionResult("Recording agent audio")
5
        .record_call(direction="speak")
6
    )
7
8
## Record only what the caller says
9
def record_caller_only(self, args, raw_data):
10
    return (
11
        FunctionResult("Recording caller audio")
12
        .record_call(direction="listen")
13
    )
14
15
## Record both sides (default)
16
def record_both(self, args, raw_data):
17
    return (
18
        FunctionResult("Recording full conversation")
19
        .record_call(direction="both")
20
    )

1
def start_recording_with_callback(self, args, raw_data):
2
    return (
3
        FunctionResult("Recording started")
4
        .record_call(
5
            control_id="webhook_rec",
6
            status_url="https://example.com/recording-complete"
7
        )
8
    )

1
def start_auto_stop_recording(self, args, raw_data):
2
    return (
3
        FunctionResult("Recording with auto-stop")
4
        .record_call(
5
            max_length=300.0,        # Stop after 5 minutes
6
            end_silence_timeout=5.0, # Stop after 5 seconds of silence
7
            terminators="#"          # Stop if user presses #
8
        )
9
    )

1
from signalwire import AgentBase
2
from signalwire.core.function_result import FunctionResult
3
4
class ControlledRecordingAgent(AgentBase):
5
    def __init__(self):
6
        super().__init__(name="controlled-recording-agent")
7
        self.add_language("English", "en-US", "rime.spore")
8
9
        self.prompt_add_section(
10
            "Role",
11
            "You handle call recordings. You can start and stop recording."
12
        )
13
14
        self._register_functions()
15
16
    def _register_functions(self):
17
        self.define_tool(
18
            name="start_recording",
19
            description="Start recording the call",
20
            parameters={"type": "object", "properties": {}},
21
            handler=self.start_recording
22
        )
23
24
        self.define_tool(
25
            name="stop_recording",
26
            description="Stop recording the call",
27
            parameters={"type": "object", "properties": {}},
28
            handler=self.stop_recording
29
        )
30
31
    def start_recording(self, args, raw_data):
32
        return (
33
            FunctionResult("Recording has started")
34
            .record_call(control_id="main")
35
        )
36
37
    def stop_recording(self, args, raw_data):
38
        return (
39
            FunctionResult("Recording has stopped")
40
            .stop_record_call(control_id="main")
41
        )
42
43
if __name__ == "__main__":
44
    agent = ControlledRecordingAgent()
45
    agent.run()

1
def start_recording_with_beep(self, args, raw_data):
2
    return (
3
        FunctionResult("This call will be recorded")
4
        .record_call(
5
            beep=True,  # Plays a beep before recording starts
6
            format="mp3"
7
        )
8
    )

1
#!/usr/bin/env python3
2
## compliance_agent.py - Agent with recording compliance features
3
from signalwire import AgentBase
4
from signalwire.core.function_result import FunctionResult
5
6
class ComplianceAgent(AgentBase):
7
    """Agent with full recording compliance features"""
8
9
    def __init__(self):
10
        super().__init__(name="compliance-agent")
11
        self.add_language("English", "en-US", "rime.spore")
12
13
        self.prompt_add_section(
14
            "Role",
15
            "You are a customer service agent. Before recording, you must "
16
            "inform the customer and get their verbal consent."
17
        )
18
19
        self.prompt_add_section(
20
            "Recording Policy",
21
            """
22
            1. Always inform customer: "This call may be recorded for quality purposes."
23
            2. Ask for consent: "Do you agree to the recording?"
24
            3. Only start recording after explicit "yes" or agreement.
25
            4. If customer declines, proceed without recording.
26
            """
27
        )
28
29
        self._register_functions()
30
31
    def _register_functions(self):
32
        self.define_tool(
33
            name="start_compliant_recording",
34
            description="Start recording after customer consent is obtained",
35
            parameters={"type": "object", "properties": {}},
36
            handler=self.start_compliant_recording
37
        )
38
39
        self.define_tool(
40
            name="pause_recording",
41
            description="Pause recording for sensitive information",
42
            parameters={"type": "object", "properties": {}},
43
            handler=self.pause_recording
44
        )
45
46
        self.define_tool(
47
            name="resume_recording",
48
            description="Resume recording after sensitive section",
49
            parameters={"type": "object", "properties": {}},
50
            handler=self.resume_recording
51
        )
52
53
    def start_compliant_recording(self, args, raw_data):
54
        call_id = raw_data.get("call_id", "unknown")
55
56
        return (
57
            FunctionResult("Recording has begun. Thank you for your consent.")
58
            .record_call(
59
                control_id=f"compliance_{call_id}",
60
                stereo=True,
61
                format="wav",
62
                beep=True,
63
                status_url="https://example.com/recordings/status"
64
            )
65
            .update_global_data({"recording_active": True})
66
        )
67
68
    def pause_recording(self, args, raw_data):
69
        call_id = raw_data.get("call_id", "unknown")
70
71
        return (
72
            FunctionResult(
73
                "Recording paused. You may now provide sensitive information."
74
            )
75
            .stop_record_call(control_id=f"compliance_{call_id}")
76
            .update_global_data({"recording_active": False})
77
        )
78
79
    def resume_recording(self, args, raw_data):
80
        call_id = raw_data.get("call_id", "unknown")
81
82
        return (
83
            FunctionResult("Recording resumed.")
84
            .record_call(
85
                control_id=f"compliance_{call_id}",
86
                stereo=True,
87
                format="wav"
88
            )
89
            .update_global_data({"recording_active": True})
90
        )
91
92
if __name__ == "__main__":
93
    agent = ComplianceAgent()
94
    agent.run()

1
self.prompt_add_section(
2
    "Recording Disclosure",
3
    """
4
    At the start of every call:
5
    1. Say: "This call may be recorded for quality and training purposes."
6
    2. Ask: "Do you consent to recording?"
7
    3. If yes: Call start_recording function
8
    4. If no: Say "No problem, I'll proceed without recording" and continue
9
    5. NEVER start recording without explicit consent
10
    """
11
)