update_tools | SignalWire

Replace the agent’s tool list mid-session. The new tools take effect immediately, replacing all previously registered tools on this agent.

Parameters

tools

list[Any]Required

A new list of @function_tool-decorated functions.

Returns

None

Example

1 from signalwire.livewire import Agent, AgentSession, AgentServer, JobContext, function_tool, run_app
2 
3 @function_tool
4 def greet(name: str) -> str:
5     """Greet the caller by name."""
6     return f"Hello, {name}!"
7 
8 @function_tool
9 def farewell(name: str) -> str:
10     """Say goodbye to the caller."""
11     return f"Goodbye, {name}!"
12 
13 agent = Agent(instructions="You are a greeter.", tools=[greet])
14 
15 # Later, swap in a different tool set
16 await agent.update_tools([farewell])