***
title: FunctionResult
slug: /reference/python/agents/function-result
description: Fluent interface for returning responses and actions from SWAIG tool functions.
max-toc-depth: 3
---------------------
For a complete index of all SignalWire documentation pages, fetch https://signalwire.com/docs/llms.txt
[tool]: /docs/server-sdks/reference/python/agents/agent-base#tool
[define-tool]: /docs/server-sdks/reference/python/agents/agent-base/define-tool
[agentbase]: /docs/server-sdks/reference/python/agents/agent-base
[swaig-function]: /docs/swml/reference/ai/swaig/functions
[swml-swaig-functions-reference]: /docs/swml/reference/ai/swaig/functions
[setresponse]: /docs/server-sdks/reference/python/agents/function-result/set-response
[setpostprocess]: /docs/server-sdks/reference/python/agents/function-result/set-post-process
[addaction]: /docs/server-sdks/reference/python/agents/function-result/add-action
[addactions]: /docs/server-sdks/reference/python/agents/function-result/add-actions
[todict]: /docs/server-sdks/reference/python/agents/function-result/to-dict
[connect]: /docs/server-sdks/reference/python/agents/function-result/connect
[hangup]: /docs/server-sdks/reference/python/agents/function-result/hangup
[hold]: /docs/server-sdks/reference/python/agents/function-result/hold
[swmltransfer]: /docs/server-sdks/reference/python/agents/function-result/swml-transfer
[say]: /docs/server-sdks/reference/python/agents/function-result/say
[waitforuser]: /docs/server-sdks/reference/python/agents/function-result/wait-for-user
[stop]: /docs/server-sdks/reference/python/agents/function-result/stop
[playbackgroundfile]: /docs/server-sdks/reference/python/agents/function-result/play-background-file
[stopbackgroundfile]: /docs/server-sdks/reference/python/agents/function-result/stop-background-file
[recordcall]: /docs/server-sdks/reference/python/agents/function-result/record-call
[stoprecordcall]: /docs/server-sdks/reference/python/agents/function-result/stop-record-call
[tap]: /docs/server-sdks/reference/python/agents/function-result/tap
[stoptap]: /docs/server-sdks/reference/python/agents/function-result/stop-tap
[updateglobaldata]: /docs/server-sdks/reference/python/agents/function-result/update-global-data
[removeglobaldata]: /docs/server-sdks/reference/python/agents/function-result/remove-global-data
[setmetadata]: /docs/server-sdks/reference/python/agents/function-result/set-metadata
[removemetadata]: /docs/server-sdks/reference/python/agents/function-result/remove-metadata
[swmlchangestep]: /docs/server-sdks/reference/python/agents/function-result/swml-change-step
[swmlchangecontext]: /docs/server-sdks/reference/python/agents/function-result/swml-change-context
[switchcontext]: /docs/server-sdks/reference/python/agents/function-result/switch-context
[swmluserevent]: /docs/server-sdks/reference/python/agents/function-result/swml-user-event
[simulateuserinput]: /docs/server-sdks/reference/python/agents/function-result/simulate-user-input
[togglefunctions]: /docs/server-sdks/reference/python/agents/function-result/toggle-functions
[enablefunctionsontimeout]: /docs/server-sdks/reference/python/agents/function-result/enable-functions-on-timeout
[adddynamichints]: /docs/server-sdks/reference/python/agents/function-result/add-dynamic-hints
[cleardynamichints]: /docs/server-sdks/reference/python/agents/function-result/clear-dynamic-hints
[setendofspeechtimeout]: /docs/server-sdks/reference/python/agents/function-result/set-end-of-speech-timeout
[setspeecheventtimeout]: /docs/server-sdks/reference/python/agents/function-result/set-speech-event-timeout
[updatesettings]: /docs/server-sdks/reference/python/agents/function-result/update-settings
[enableextensivedata]: /docs/server-sdks/reference/python/agents/function-result/enable-extensive-data
[replaceinhistory]: /docs/server-sdks/reference/python/agents/function-result/replace-in-history
[sendsms]: /docs/server-sdks/reference/python/agents/function-result/send-sms
[pay]: /docs/server-sdks/reference/python/agents/function-result/pay
[createpaymentprompt]: /docs/server-sdks/reference/python/agents/function-result/create-payment-prompt
[createpaymentaction]: /docs/server-sdks/reference/python/agents/function-result/create-payment-action
[createpaymentparameter]: /docs/server-sdks/reference/python/agents/function-result/create-payment-parameter
[siprefer]: /docs/server-sdks/reference/python/agents/function-result/sip-refer
[joinroom]: /docs/server-sdks/reference/python/agents/function-result/join-room
[joinconference]: /docs/server-sdks/reference/python/agents/function-result/join-conference
[executeswml]: /docs/server-sdks/reference/python/agents/function-result/execute-swml
[executerpc]: /docs/server-sdks/reference/python/agents/function-result/execute-rpc
[rpcdial]: /docs/server-sdks/reference/python/agents/function-result/rpc-dial
[rpcaimessage]: /docs/server-sdks/reference/python/agents/function-result/rpc-ai-message
[rpcaiunhold]: /docs/server-sdks/reference/python/agents/function-result/rpc-ai-unhold
`FunctionResult` is the return type for all SWAIG tool functions. It wraps a response
message (text for the AI to speak) and an ordered list of actions (transfers, SMS,
data updates, context switches, and more). Every method returns `self`, so you can
chain calls into a single fluent expression.
Returned from functions defined with the [`@tool()`][tool] decorator
or [`define_tool()`][define-tool] on
[`AgentBase`][agentbase].
FunctionResult builds the response payload for a [SWAIG function][swaig-function].
See the [SWML SWAIG functions reference][swml-swaig-functions-reference] for the
full response format specification.
## **Properties**
Text the AI speaks back to the caller after the function executes.
Ordered list of action objects to execute. Actions run sequentially in the
order they were added.
When `True`, the AI speaks the response and takes one more conversational turn
with the user before executing actions. When `False` (default), actions execute
immediately after the response.
## **Example**
```python {10}
from signalwire import AgentBase
from signalwire import FunctionResult
agent = AgentBase(name="my-agent", route="/agent")
agent.set_prompt_text("You are a helpful assistant.")
@agent.tool(name="transfer_to_billing", description="Transfer the caller to billing")
def transfer_to_billing(args, raw_data):
return (
FunctionResult(
"I'll transfer you to billing. Anything else first?",
post_process=True
)
.update_global_data({"transferred": True})
.send_sms(
to_number="+15551234567",
from_number="+15559876543",
body="You are being transferred to billing."
)
.connect("+15551234567", final=True)
)
agent.serve()
```
## **Fluent Chaining Pattern**
Every method on `FunctionResult` returns `self`, so you build complex responses
in a single expression. Actions execute in the order they are added.
Terminal actions like `connect(final=True)` and `hangup()` end the call flow.
Place them **last** in the chain so that preceding actions (data updates, SMS, etc.)
have a chance to execute.
```python {11}
from signalwire import AgentBase
from signalwire import FunctionResult
agent = AgentBase(name="my-agent", route="/agent")
agent.set_prompt_text("You are a helpful assistant.")
@agent.tool(name="transfer_call", description="Transfer the call")
def transfer_call(args, raw_data):
# Data update + SMS execute before the terminal transfer
return (
FunctionResult("Transferring you now.")
.update_global_data({"transferred": True})
.send_sms(
to_number="+15551234567",
from_number="+15559876543",
body="Your call is being transferred."
)
.connect("+15551234567", final=True) # terminal — goes last
)
agent.serve()
```
## **Methods**
### Core
Set or replace the response text on a FunctionResult.
Enable or disable post-processing on a FunctionResult.
Append a raw action to the FunctionResult action list.
Append multiple raw actions to the FunctionResult action list.
Serialize a FunctionResult to the SWAIG response format.
### Call Control
Transfer or connect the call to another destination.
End the call immediately.
Put the call on hold with an optional timeout.
Transfer the call to a SWML endpoint with a return message.
### Speech
Make the AI agent speak specific text immediately.
Control how the agent pauses and waits for user input.
Stop the agent execution immediately.
### Media
Play an audio or video file in the background during a call.
Stop the currently playing background audio file.
Start recording the call in the background.
Stop an active background call recording.
Stream call audio to an external endpoint via WebSocket or RTP.
Stop an active media tap stream.
### Data
Set or update key-value pairs in the global session data.
Remove one or more keys from the global session data.
Set function-scoped metadata on a FunctionResult.
Remove one or more keys from the current function's metadata store.
### Context Navigation
Transition to a different step within the current conversation context.
Switch to a different conversation context.
Perform an advanced context switch with prompt replacement and history control.
### Events
Send a custom user event through SWML for real-time UI updates.
Inject text as simulated user speech input.
### Functions
Enable or disable specific SWAIG functions at runtime.
Allow SWAIG function calls when a speaker timeout occurs.
### Hints
Add speech recognition hints dynamically during a call.
Remove all dynamically added speech recognition hints.
### Settings
Adjust the end-of-speech silence timeout for speech recognition.
Adjust the speech event timeout for noisy environments.
Update AI runtime settings dynamically during a call.
Send full data to the LLM for the current turn only.
Control how this function call appears in the AI's conversation history.
### SMS
Send an SMS or MMS message from a tool function.
### Payment
Collect and process a credit card payment during a call.
Build a payment prompt object for use with pay().
Build a single action entry for a payment prompt.
Build a parameter entry for the pay() method.
### SIP
Send a SIP REFER message to transfer the call in a SIP environment.
### Rooms and Conferences
Join a SignalWire RELAY room for multi-party communication.
Join an ad-hoc audio conference with extensive configuration options.
### SWML and RPC
Execute a raw SWML document as an action.
Execute a generic RPC method on a call.
Dial out to a phone number with a destination SWML URL via RPC.
Inject a message into the AI agent running on another call.
Release another call from hold via RPC.