Troubleshooting

1
agent = AgentBase(name="myagent", route="/", port=3001)

1
## Correct
2
@agent.tool(description="My function")
3
def my_function(param: str) -> SwaigFunctionResult:
4
    return SwaigFunctionResult("Done")
5
6
## Wrong: Missing parentheses
7
@agent.tool
8
def my_function(param: str) -> SwaigFunctionResult:
9
    pass
10
11
## Wrong: Missing description
12
@agent.tool()
13
def my_function(param: str) -> SwaigFunctionResult:
14
    pass

1
from signalwire_agents import AgentBase
2
from signalwire_agents.core.function_result import SwaigFunctionResult
3
4
agent = AgentBase(name="test", route="/")
5
6
## Functions must be defined before run()
7
@agent.tool(description="Test function")
8
def test_func() -> SwaigFunctionResult:
9
    return SwaigFunctionResult("Test")
10
11
## Then run
12
if __name__ == "__main__":
13
    agent.run()

1
## Correct
2
@agent.tool(description="Get status")
3
def get_status() -> SwaigFunctionResult:
4
    return SwaigFunctionResult("Status is OK")
5
6
## Wrong: Returns string instead of SwaigFunctionResult
7
@agent.tool(description="Get status")
8
def get_status() -> SwaigFunctionResult:
9
    return "Status is OK"  # This won't work!

1
agent = AgentBase(
2
    name="secure",
3
    route="/",
4
    basic_auth=("username", "password")
5
)

1
agent.set_params({
2
    "confidence": 0.5,       # Lower = more sensitive
3
    "energy_level": 40       # Lower = quieter speech detected
4
})

1
agent.set_params({
2
    "barge_confidence": 0.8,  # Higher = harder to interrupt
3
    "barge_min_words": 3      # Require 3+ words to barge
4
})

1
agent.set_params({
2
    "end_of_speech_timeout": 1500  # Wait 1.5s of silence (default 700ms)
3
})

1
## Use fillers
2
@agent.tool(
3
    description="Long operation",
4
    fillers=["One moment please..."]
5
)
6
def long_operation() -> SwaigFunctionResult:
7
    pass

1
agent.set_params({
2
    "inactivity_timeout": 300000  # 5 minutes (default 10 minutes)
3
})

1
data_map.add_parameter("city", "string", "City name", required=True)
2
3
## URL must use same name
4
data_map.add_webhook(
5
    url="https://api.example.com?q=${enc:args.city}",  # "city" matches
6
    ...
7
)

1
## List available skills
2
print(agent.list_available_skills())
3
4
## Add by exact name
5
agent.add_skill("datetime")
6
agent.add_skill("native_vector_search")

1
## handler.py
2
from my_agent import agent
3
4
def handler(event, context):
5
    return agent.serverless_handler(event, context)

1
import logging
2
logging.basicConfig(level=logging.DEBUG)
3
4
# Or for specific components
5
logging.getLogger("signalwire_agents").setLevel(logging.DEBUG)

1
@agent.tool(description="Debug function")
2
def debug_info(args=None, raw_data=None) -> SwaigFunctionResult:
3
    import json
4
    print("RAW DATA:", json.dumps(raw_data, indent=2))
5
    return SwaigFunctionResult("Debug complete")

1
# Reduce speech rate via prompt
2
agent.prompt_add_section("Speech", "Speak at a moderate pace. Pause briefly between sentences.")

1
# Add pronunciation rules
2
agent.add_pronounce([
3
    {"replace": "www", "with": "dub dub dub"},
4
    {"replace": ".com", "with": "dot com"},
5
    {"replace": "API", "with": "A P I"}
6
])

1
agent.set_params({
2
    "energy_level": 52.0,        # Higher = requires louder speech (default 52)
3
    "input_sensitivity": 45.0    # Higher = less sensitive to background
4
})

1
@agent.tool(
2
    description="Slow operation",
3
    fillers=["One moment please...", "Let me check that..."]
4
)
5
def slow_operation() -> SwaigFunctionResult:
6
    # Long running code
7
    pass

1
# BAD: Shared state across calls
2
class Agent(AgentBase):
3
    cart = []  # Shared between all calls!
4
5
# GOOD: Per-call state
6
agent.set_global_data({"cart": []})