add_action | SignalWire

Append a raw action to the action list. Prefer the named convenience methods (connect(), hangup(), say(), etc.) for common operations.

Parameters

name

strRequired

Action type identifier (e.g., "hold", "hangup", "set_global_data").

data

AnyRequired

Action payload. Can be a string, boolean, dict, or list depending on the action type.

Returns

FunctionResult — self, for chaining.

Example

1 from signalwire import AgentBase
2 from signalwire import FunctionResult
3 
4 agent = AgentBase(name="my-agent", route="/agent")
5 agent.set_prompt_text("You are a helpful assistant.")
6 
7 @agent.tool(name="custom_action", description="Process a custom action")
8 def custom_action(args, raw_data):
9     return (
10         FunctionResult("Processing your request.")
11         .add_action("set_global_data", {"status": "active"})
12         .add_action("hold", 60)
13     )
14 
15 agent.serve()