1
from signalwire_agents 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 datetime capability
9
        self.add_skill("datetime")
10
11
        # Add math capability
12
        self.add_skill("math")
13
14
        self.prompt_add_section(
15
            "Role",
16
            "You are a helpful assistant that can tell time and do math."
17
        )

1
#!/usr/bin/env python3
2
# assistant_agent.py - Agent with multiple skills
3
from signalwire_agents import AgentBase
4
5
class AssistantAgent(AgentBase):
6
    def __init__(self):
7
        super().__init__(name="assistant")
8
        self.add_language("English", "en-US", "rime.spore")
9
10
        # Add multiple skills
11
        self.add_skill("datetime")
12
        self.add_skill("math")
13
14
        self.prompt_add_section(
15
            "Role",
16
            "You are a helpful assistant named Alex."
17
        )
18
19
        self.prompt_add_section(
20
            "Capabilities",
21
            body="You can help with:",
22
            bullets=[
23
                "Telling the current date and time",
24
                "Performing math calculations"
25
            ]
26
        )
27
28
if __name__ == "__main__":
29
    agent = AssistantAgent()
30
    agent.run()

1
from signalwire_agents.skills import SkillBase
2
from signalwire_agents.core.function_result import SwaigFunctionResult
3
4
5
class MySkill(SkillBase):
6
    # Required class attributes
7
    SKILL_NAME = "my_skill"
8
    SKILL_DESCRIPTION = "Does something useful"
9
    SKILL_VERSION = "1.0.0"
10
11
    # Optional requirements
12
    REQUIRED_PACKAGES = []      # Python packages needed
13
    REQUIRED_ENV_VARS = []      # Environment variables needed
14
15
    # Multi-instance support
16
    SUPPORTS_MULTIPLE_INSTANCES = False
17
18
    def setup(self) -> bool:
19
        """Initialize the skill. Return True if successful."""
20
        return True
21
22
    def register_tools(self) -> None:
23
        """Register SWAIG tools with the agent."""
24
        self.define_tool(
25
            name="my_function",
26
            description="Does something",
27
            parameters={},
28
            handler=self.my_handler
29
        )
30
31
    def my_handler(self, args, raw_data):
32
        """Handle function calls."""
33
        return SwaigFunctionResult("Result")

1
def register_tools(self) -> None:
2
    self.define_tool(
3
        name="get_time",
4
        description="Get current time",
5
        parameters={
6
            "timezone": {
7
                "type": "string",
8
                "description": "Timezone name"
9
            }
10
        },
11
        handler=self.get_time_handler
12
    )

1
def get_prompt_sections(self):
2
    return [
3
        {
4
            "title": "Time Information",
5
            "body": "You can tell users the current time.",
6
            "bullets": [
7
                "Use get_time for time queries",
8
                "Support multiple timezones"
9
            ]
10
        }
11
    ]

1
def get_hints(self):
2
    return ["time", "date", "clock", "timezone"]

1
def get_global_data(self):
2
    return {
3
        "datetime_enabled": True,
4
        "default_timezone": "UTC"
5
    }

1
# Skill NOT loaded yet
2
agent = MyAgent()
3
4
# Skill loaded when first referenced
5
agent.add_skill("datetime")  # datetime skill loaded here
6
7
# Already loaded, reused
8
agent.add_skill("datetime")  # Uses cached class

1
class MySkill(SkillBase):
2
    SUPPORTS_MULTIPLE_INSTANCES = True
3
4
    def get_instance_key(self) -> str:
5
        # Unique key for this instance
6
        tool_name = self.params.get('tool_name', self.SKILL_NAME)
7
        return f"{self.SKILL_NAME}_{tool_name}"

1
# Add two instances with different configs
2
agent.add_skill("web_search", {
3
    "tool_name": "search_news",
4
    "search_engine_id": "NEWS_ENGINE_ID",
5
    "api_key": "KEY"
6
})
7
8
agent.add_skill("web_search", {
9
    "tool_name": "search_docs",
10
    "search_engine_id": "DOCS_ENGINE_ID",
11
    "api_key": "KEY"
12
})

1
self.add_skill("web_search", {
2
    "api_key": "your-key",
3
    "tool_name": "custom_search",
4
    "max_results": 5
5
})

1
def setup(self) -> bool:
2
    self.api_key = self.params.get("api_key")
3
    self.max_results = self.params.get("max_results", 3)
4
    return True

1
def search_handler(self, args, raw_data):
2
    query = args.get("query")  # From AI's function call
3
    max_results = self.max_results  # From skill config
4
    # ...

1
def my_handler(self, args, raw_data):
2
    # Success case
3
    return SwaigFunctionResult("The result is 42")
4
5
    # With actions
6
    return (
7
        SwaigFunctionResult("Updated your preferences")
8
        .update_global_data({"preference": "value"})
9
    )
10
11
    # Error case - still return a result for the AI
12
    return SwaigFunctionResult("I couldn't complete that request. Please try again.")

1
def api_handler(self, args, raw_data):
2
    try:
3
        result = self.call_external_api(args)
4
        return SwaigFunctionResult(f"Result: {result}")
5
    except requests.Timeout:
6
        return SwaigFunctionResult(
7
            "The service is taking too long to respond. Please try again."
8
        )
9
    except requests.RequestException as e:
10
        self.agent.log.error(f"API error: {e}")
11
        return SwaigFunctionResult(
12
            "I'm having trouble connecting to the service right now."
13
        )
14
    except Exception as e:
15
        self.agent.log.error(f"Unexpected error: {e}")
16
        return SwaigFunctionResult(
17
            "Something went wrong. Please try again."
18
        )

1
# In your agent
2
print(f"Skills loaded: {list(self._skill_manager._skills.keys())}")