SWAIG (SignalWire AI Gateway)

1
from signalwire import AgentBase, FunctionResult
2
3
class MyAgent(AgentBase):
4
    def __init__(self):
5
        super().__init__(name="my-agent")
6
7
    @AgentBase.tool(
8
        name="get_balance",
9
        description="Get account balance for a customer",
10
        parameters={
11
            "type": "object",
12
            "properties": {
13
                "account_id": {
14
                    "type": "string",
15
                    "description": "The account ID to look up"
16
                }
17
            },
18
            "required": ["account_id"]
19
        }
20
    )
21
    def get_balance(self, args, raw_data):
22
        account_id = args.get("account_id")
23
        return FunctionResult(f"Account {account_id} has a balance of $150.00")

1
from signalwire import AgentBase
2
3
class MyAgent(AgentBase):
4
    def __init__(self):
5
        super().__init__(name="my-agent")
6
7
        self.data_map.add_tool(
8
            name="get_balance",
9
            description="Get account balance",
10
            parameters={
11
                "account_id": {
12
                    "type": "string",
13
                    "description": "The account ID"
14
                }
15
            },
16
            data_map={
17
                "webhooks": [
18
                    {
19
                        "url": "https://api.example.com/accounts/${enc:args.account_id}/balance",
20
                        "method": "GET",
21
                        "headers": {
22
                            "Authorization": "Bearer ${env.API_KEY}"
23
                        },
24
                        "output": {
25
                            "response": "Account balance is $${balance}",
26
                            "action": [{"set_global_data": {"balance": "${balance}"}}]
27
                        }
28
                    }
29
                ]
30
            }
31
        )

1
def my_function(self, args, raw_data):
2
    # Call metadata
3
    # Call information (nested under 'call' key)
4
    call_data = raw_data.get("call", {})
5
    call_id = call_data.get("call_id") or raw_data.get("call_id")  # Fallback for compatibility
6
    call_sid = raw_data.get("call_sid")
7
8
    # Caller information (from nested call object)
9
    from_number = call_data.get("from") or call_data.get("from_number")
10
    to_number = call_data.get("to") or call_data.get("to_number")
11
12
    # Global data (shared state)
13
    global_data = raw_data.get("global_data", {})
14
    customer_name = global_data.get("customer_name")
15
16
    # Conversation context
17
    meta_data = raw_data.get("meta_data", {})
18
19
    return FunctionResult("Processed")

1
self.define_tool(
2
    name="search_orders",
3
    description="Search customer orders",
4
    parameters={
5
        "type": "object",
6
        "properties": {
7
            "customer_id": {
8
                "type": "string",
9
                "description": "Customer ID to search for"
10
            },
11
            "status": {
12
                "type": "string",
13
                "enum": ["pending", "shipped", "delivered", "cancelled"],
14
                "description": "Filter by order status"
15
            },
16
            "limit": {
17
                "type": "integer",
18
                "description": "Maximum number of results",
19
                "default": 10
20
            },
21
            "include_details": {
22
                "type": "boolean",
23
                "description": "Include full order details",
24
                "default": False
25
            }
26
        },
27
        "required": ["customer_id"]
28
    },
29
    handler=self.search_orders
30
)

1
## Function-specific token security
2
self.define_tool(
3
    name="sensitive_action",
4
    description="Perform a sensitive action",
5
    parameters={...},
6
    handler=self.sensitive_action,
7
    secure=True  # Enables per-function token validation
8
)

1
def get_balance(self, args, raw_data):
2
    account_id = args.get("account_id")
3
4
    if not account_id:
5
        return FunctionResult(
6
            "I need an account ID to look up the balance. "
7
            "Could you provide your account number?"
8
        )
9
10
    try:
11
        balance = self.lookup_balance(account_id)
12
        return FunctionResult(f"Your current balance is ${balance:.2f}")
13
    except AccountNotFoundError:
14
        return FunctionResult(
15
            "I couldn't find an account with that ID. "
16
            "Could you verify the account number?"
17
        )