Skills

1
from signalwire.skills import SkillBase
2
from signalwire.core.function_result import FunctionResult
3
4
class MySkill(SkillBase):
5
    # Required class attributes
6
    SKILL_NAME = "my_skill"
7
    SKILL_DESCRIPTION = "Does something useful"
8
    SKILL_VERSION = "1.0.0"
9
10
    # Optional requirements
11
    REQUIRED_PACKAGES = []      # Python packages needed
12
    REQUIRED_ENV_VARS = []      # Environment variables needed
13
14
    # Multi-instance support
15
    SUPPORTS_MULTIPLE_INSTANCES = False
16
17
    def setup(self) -> bool:
18
        """Initialize the skill. Return True if successful."""
19
        return True
20
21
    def register_tools(self) -> None:
22
        """Register SWAIG tools with the agent."""
23
        self.define_tool(
24
            name="my_function",
25
            description="Does something",
26
            parameters={},
27
            handler=self.my_handler
28
        )
29
30
    def my_handler(self, args, raw_data):
31
        """Handle function calls."""
32
        return FunctionResult("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 FunctionResult("The result is 42")
4
5
    # With actions
6
    return (
7
        FunctionResult("Updated your preferences")
8
        .update_global_data({"preference": "value"})
9
    )
10
11
    # Error case - still return a result for the AI
12
    return FunctionResult("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 FunctionResult(f"Result: {result}")
5
    except requests.Timeout:
6
        return FunctionResult(
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 FunctionResult(
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 FunctionResult(
17
            "Something went wrong. Please try again."
18
        )

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