Helper Functions

1
from signalwire import (
2
    create_simple_context,
3
    create_simple_api_tool,
4
    create_expression_tool,
5
    list_skills_with_params,
6
    register_skill,
7
    add_skill_directory,
8
)

1
from signalwire import create_simple_context
2
3
ctx = create_simple_context()
4
ctx.add_step("greet").set_text("Say hello to the caller.")
5
ctx.add_step("help").set_text("Ask how you can help today.")

1
from signalwire import create_simple_api_tool
2
3
weather_tool = create_simple_api_tool(
4
    name="get_weather",
5
    url="https://api.weather.com/v1/current?key=API_KEY&q=${args.location}",
6
    response_template="Weather in ${args.location}: ${response.current.condition.text}, ${response.current.temp_f}F",
7
    parameters={
8
        "location": {
9
            "type": "string",
10
            "description": "City name",
11
            "required": True
12
        }
13
    }
14
)

1
from signalwire import create_expression_tool
2
from signalwire import FunctionResult
3
4
playback_tool = create_expression_tool(
5
    name="playback_control",
6
    patterns={
7
        "${args.command}": (
8
            r"play.*",
9
            FunctionResult().add_action("start_playbook", {"file": "${args.filename}"})
10
        ),
11
        "${args.command}": (
12
            r"stop.*",
13
            FunctionResult().add_action("stop_playback", True)
14
        ),
15
    },
16
    parameters={
17
        "command": {"type": "string", "description": "Playback command", "required": True},
18
        "filename": {"type": "string", "description": "File to play"},
19
    }
20
)

1
from signalwire import list_skills_with_params
2
3
schema = list_skills_with_params()
4
for skill_name, skill_info in schema.items():
5
    print(f"{skill_name}: {skill_info.get('description', '')}")
6
    for param, meta in skill_info.get("parameters", {}).items():
7
        print(f"  {param}: {meta['type']} (required={meta.get('required', False)})")

1
from signalwire import register_skill
2
from signalwire import AgentBase
3
4
class MyWeatherSkill:
5
    SKILL_NAME = "my_weather"
6
    SKILL_DESCRIPTION = "Custom weather lookup"
7
8
    def setup(self):
9
        return True
10
11
    def register_tools(self):
12
        self.define_tool(name="get_weather", handler=self._get_weather, description="Get weather")
13
14
    def _get_weather(self, args, raw_data):
15
        return {"response": "Sunny, 72F"}
16
17
register_skill(MyWeatherSkill)
18
19
agent = AgentBase(name="my-agent")
20
agent.add_skill("my_weather")

1
from signalwire import add_skill_directory, AgentBase
2
3
add_skill_directory("/opt/custom_skills")
4
5
agent = AgentBase()
6
agent.add_skill("my_custom_skill")  # Found in /opt/custom_skills/my_custom_skill/