get_agent | SignalWire

Retrieve a specific agent by its route. Returns None if no agent is registered at the given path.

Parameters

route

strRequired

The route to look up (e.g., "/sales"). Leading slashes are added and trailing slashes are stripped automatically for matching.

Returns

AgentBase | None — The agent instance registered at the route, or None if not found.

Example

1 from signalwire import AgentServer
2 from signalwire import AgentBase
3 
4 agent1 = AgentBase(name="sales", route="/sales")
5 agent2 = AgentBase(name="support", route="/support")
6 server = AgentServer(port=3000)
7 server.register(agent1)
8 agent = server.get_agent("/sales")
9 if agent:
10     print(f"Found: {agent.get_name()}")
11 else:
12     print("No agent at /sales")