Skip to main content
Cartesia provides and runs system tools; you choose which ones to enable and configure on the agent. config.system_tools supports end_call, send_dtmf, transfer_to_number, skip_turn, and voicemail_detection.
Tools page in the Playground showing End call turned on and Add buttons for Send keypad tones, Voicemail detection, Skip turn, and Transfer call

Add system tools from the Tools page in the Playground.

Agent responses include all five system tools, with disabled tools set to null. In config.system_tools for a PATCH request:
  • Omit the tool to leave its current setting unchanged.
  • Send null to disable the tool.
  • Send the config object to enable or update any tool settings.
For end_call, send_dtmf, skip_turn, and voicemail_detection, {} enables a disabled tool with defaults or preserves an enabled tool’s settings. To enable transfer_to_number, provide a list of transfer destinations (transfers). For all our system tools, we recommend keeping the default description, which is optimized for our system. However, if you’d like more control, you can set description to direct how and when the agent invokes the tool. Set it to null to use the built-in description. pre_tool_speech controls whether the agent speaks before acting. auto lets the agent decide, force asks it to speak first, and off doesn’t ask it to.

End call

Allows the agent to end a call when the conversation is complete or the caller asks to hang up.

Skip turn

Skips the agent’s response when the caller asks for a moment. Set wait_timeout_secs to temporarily extend the check-in timeout; user speech or DTMF restores the original timing.

Voicemail detection

Allows the agent to detect voicemail and end the call. Set message to leave a spoken message before hanging up; it plays without interruption, even when pre_tool_speech is off. The call’s end_reason is voicemail_detected. With initial_message_interruptions set to ignore, the agent still checks what the caller says during the initial message for an answering machine greeting, without replying. If it finds one, the initial message stops and voicemail detection runs as usual. The same happens under respond_after.

Send DTMF

Allows the agent to send one or more keypad tones, such as 12#, while navigating a phone menu. Supported tones are 0 through 9, *, and #.

Transfer to number

Transfers a phone call to a configured destination. For each destination, provide a phone number in E.164 format, such as +14155550123, a SIP URI such as sip:user@host, or a dynamic variable such as {{transfer_number}}. Add a condition that tells the model when to use it. Set the destinations with Update agent, using your agent ID:
Supply dynamic variables such as transfer_number in the outbound call request or through a webhook assignment. A variable used as a phone destination must contain a valid E.164 number when the transfer runs. Conditions and tool descriptions also support dynamic variables. In the Playground, open Tools, click Add next to Transfer call, and choose Phone number, SIP URI, or Dynamic variable for each rule’s Destination. Set type to "sip_uri" and provide sip_uri in the form sip:user@host or sips:user@host, using a lowercase scheme and including both a user and a host. The sip_uri can also be a single dynamic variable, such as {{sip_uri}}, whose value is the complete SIP URI when the transfer runs. Variables inside a URI, such as sip:{{user}}@host, are not supported. In the Playground, choose Dynamic variable for the rule’s Destination and set Destination type to SIP URI.
Configure Transfer call form in the Playground with a destination and transfer condition

Transfer rules in the Playground.

Transfers work on phone calls, including Cartesia numbers, numbers imported from Twilio, and SIP-trunked numbers. SIP URI destinations require SIP trunking. On Playground previews and WebSocket sessions, the tool returns an error instead of transferring the call.