Skip to main content

​
What are tools?

Tools allow your agent to perform actions during a conversation - like ending a call, transferring to a human, or calling an external API. When the agent determines it needs to take an action, it invokes the appropriate tool.

​
Built-in tools

Sonara provides several built-in tools that you can enable with one click:

​
End Call

Allows the agent to hang up the call when the conversation is complete.

​
Transfer Call

Transfers the caller to a specified phone number. Configure the destination number when enabling this tool.

​
Transfer Agent

Hands off the conversation to a different Sonara agent. Useful for routing callers to specialized agents (e.g., transfer from a general support agent to a billing specialist).

​
Custom functions

For advanced use cases, you can define custom functions that your agent can call during conversations.

​
Creating a custom function

1

Click Add Function

In the Tools tab, click Add Function.
2

Define the function

Provide:
  • Name - A descriptive function name (e.g., lookup_order)
  • Description - Explain what this function does and when the agent should use it. The LLM uses this description to decide when to call the function.
  • Parameters - Define the input parameters as a JSON schema.
3

Set the endpoint

Provide the server URL that Sonara should call when this function is invoked. Your endpoint will receive the parameters as a JSON payload and should return a response for the agent to use.

​
Example custom function

Function: lookup_order
Write clear, detailed descriptions for your custom functions. The LLM relies on the description to decide when and how to call each function.
Your custom function endpoint must respond within a reasonable time (under 10 seconds) to avoid noticeable pauses in the conversation.