Agents | SignalWire

The Agents namespace provides the core framework for building AI-powered voice agents with SignalWire. It includes the central AgentBase class, SWML document generation, tool/function definitions, skills, multi-agent hosting, CLI tools for local testing and deployment, and configuration management for security and environment settings.

The Agents SDK generates SWML documents under the hood. Each agent produces a SWML document with the ai verb that the SignalWire platform executes.

Example

A complete agent that answers calls, uses an AI prompt, and exposes a custom tool:

1 from signalwire import AgentBase
2 from signalwire.core.function_result import FunctionResult
3 
4 agent = AgentBase(name="support-agent", route="/support")
5 agent.set_prompt_text(
6     "You are a friendly support agent for Acme Corp. "
7     "Help customers check their order status. "
8     "Be concise and professional."
9 )
10 agent.set_params({"temperature": 0.5, "end_of_speech_timeout": 800})
11 
12 @agent.tool(description="Look up an order by ID")
13 def check_order(args, raw_data):
14     order_id = args.get("order_id", "unknown")
15     return FunctionResult(f"Order {order_id} shipped on March 28 and arrives tomorrow.")
16 
17 agent.add_skill("datetime")
18 
19 if __name__ == "__main__":
20     agent.serve()