Quick Start: Your First Agent

1
#!/usr/bin/env python3
2
## my_first_agent.py - A simple voice AI agent
3
"""
4
My First SignalWire Agent
5
6
A simple voice AI agent that greets callers and has conversations.
7
"""
8
9
from signalwire import AgentBase
10
11
class MyFirstAgent(AgentBase):
12
    def __init__(self):
13
        super().__init__(name="my-first-agent")
14
15
        # Set the voice
16
        self.add_language("English", "en-US", "rime.spore")
17
18
        # Define the AI's personality and behavior
19
        self.prompt_add_section(
20
            "Role",
21
            "You are a friendly and helpful assistant. Greet the caller warmly "
22
            "and help them with any questions they have. Keep responses concise "
23
            "and conversational."
24
        )
25
26
        self.prompt_add_section(
27
            "Guidelines",
28
            body="Follow these rules:",
29
            bullets=[
30
                "Be friendly and professional",
31
                "Keep responses brief (1-2 sentences when possible)",
32
                "If you don't know something, say so honestly",
33
                "End conversations politely when the caller is done"
34
            ]
35
        )
36
37
if __name__ == "__main__":
38
    agent = MyFirstAgent()
39
    print("Starting My First Agent...")
40
    print("Server running at: http://localhost:3000")
41
    print("Press Ctrl+C to stop")
42
    agent.run()

1
#!/usr/bin/env python3
2
## my_first_agent_with_function.py - Agent with custom function
3
"""
4
My First SignalWire Agent - With Custom Function
5
"""
6
7
from signalwire import AgentBase, FunctionResult
8
9
class MyFirstAgent(AgentBase):
10
    def __init__(self):
11
        super().__init__(name="my-first-agent")
12
13
        # Set the voice
14
        self.add_language("English", "en-US", "rime.spore")
15
16
        # Define the AI's personality
17
        self.prompt_add_section(
18
            "Role",
19
            "You are a friendly assistant who can tell jokes. "
20
            "When someone asks for a joke, use your tell_joke function."
21
        )
22
23
        # Register the custom function
24
        self.define_tool(
25
            name="tell_joke",
26
            description="Tell a joke to the caller",
27
            parameters={"type": "object", "properties": {}},
28
            handler=self.tell_joke
29
        )
30
31
    def tell_joke(self, args, raw_data):
32
        """Return a joke for the AI to tell."""
33
        import random
34
        jokes = [
35
            "Why do programmers prefer dark mode? Because light attracts bugs!",
36
            "Why did the Python programmer need glasses? Because they couldn't C!",
37
            "What's a programmer's favorite hangout spot? Foo Bar!",
38
        ]
39
        joke = random.choice(jokes)
40
        return FunctionResult(f"Here's a joke: {joke}")
41
42
if __name__ == "__main__":
43
    agent = MyFirstAgent()
44
    print("Starting My First Agent (with jokes!)...")
45
    print("Server running at: http://localhost:3000")
46
    agent.run()

1
#!/usr/bin/env python3
2
## complete_first_agent.py - Complete agent example with multiple features
3
"""
4
Complete First Agent Example
5
6
Demonstrates: voice config, AI parameters, prompt sections, custom functions, speech hints.
7
"""
8
9
from signalwire import AgentBase, FunctionResult
10
11
class CompleteFirstAgent(AgentBase):
12
    def __init__(self):
13
        super().__init__(
14
            name="complete-agent",
15
            auto_answer=True,
16
            record_call=False
17
        )
18
19
        # Voice and language
20
        self.add_language("English", "en-US", "rime.spore")
21
22
        # AI behavior parameters
23
        self.set_params({
24
            "end_of_speech_timeout": 500,      # Wait 500ms for speaker to finish
25
            "attention_timeout": 15000         # 15 second attention span
26
        })
27
28
        # Speech recognition hints (improves accuracy)
29
        self.add_hints([
30
            "SignalWire",
31
            "SWML",
32
            "AI agent"
33
        ])
34
35
        # Prompt sections
36
        self.prompt_add_section(
37
            "Identity",
38
            "You are Alex, a helpful AI assistant created by SignalWire."
39
        )
40
41
        self.prompt_add_section(
42
            "Capabilities",
43
            body="You can help callers with:",
44
            bullets=[
45
                "Answering general questions",
46
                "Telling jokes",
47
                "Providing the current time",
48
                "Basic conversation"
49
            ]
50
        )
51
52
        self.prompt_add_section(
53
            "Style",
54
            "Keep responses brief and friendly. Use a conversational tone."
55
        )
56
57
        # Register functions
58
        self.define_tool(
59
            name="get_current_time",
60
            description="Get the current time",
61
            parameters={"type": "object", "properties": {}},
62
            handler=self.get_current_time
63
        )
64
65
        self.define_tool(
66
            name="tell_joke",
67
            description="Tell a random joke",
68
            parameters={"type": "object", "properties": {}},
69
            handler=self.tell_joke
70
        )
71
72
    def get_current_time(self, args, raw_data):
73
        """Return the current time."""
74
        from datetime import datetime
75
        now = datetime.now()
76
        return FunctionResult(f"The current time is {now.strftime('%I:%M %p')}")
77
78
    def tell_joke(self, args, raw_data):
79
        """Return a random joke."""
80
        import random
81
        jokes = [
82
            "Why do programmers prefer dark mode? Because light attracts bugs!",
83
            "Why did the developer go broke? Because they used up all their cache!",
84
            "There are only 10 types of people: those who understand binary and those who don't.",
85
        ]
86
        return FunctionResult(random.choice(jokes))
87
88
if __name__ == "__main__":
89
    agent = CompleteFirstAgent()
90
    print("Complete First Agent running at http://localhost:3000")
91
    agent.run()