Tools

Builtin tools

The catalogue of tools the platform ships, grouped by what they do.

Builtin tools run inside Vertical AI. There is no URL and no headers to set. You add one and it works. A few take a setting or two, such as the number a transfer rings or the inbox a message goes to.

Each ships with a description already written. Keep it, or sharpen it for your business. See Tools for how descriptions drive behaviour.

Ending and escalating

ToolWhat it does
transfer_to_humanHands the call to a person, either straight through or as a screened warm transfer that announces the caller first. With no destination configured the agent says so honestly and keeps helping. See phone numbers.
end_callEnds the call after a warm closing line. The runtime refuses to hang up while a tool is still running or before the agent has told the caller what a tool returned, and the tool's description tells the agent a bare "okay" or "thanks" is not a goodbye.
escalate_emergencySpeaks one fixed "hang up and call triple zero" line, then puts the caller through to a person when a transfer number is set. It never triages and never advises.
take_a_messageGathers a name, a callback number and a short summary, then emails it to the inbox you configured.

transfer_to_human fires when the caller asks for a person, when policy requires an escalation, or when nothing else can resolve the request. end_call fires once the caller has clearly signed off and there is nothing left to handle.

take_a_message covers a caller who wants a callback, leaves an enquiry, or asks for someone who cannot take the call.

escalate_emergency fires on a genuine emergency: injury, a medical crisis, a fire, or a safety threat. It is biased towards escalating, because failing to escalate a real emergency is the worst outcome a voice agent can produce.

Answering questions

ToolWhat it does
search_knowledge_baseSearches the agent's knowledge base and returns matching passages. The agent answers from what it found and cites the source by name.
get_current_timeReturns the date and time in the agent's timezone, and the caller's when known.
calculateWorks out a sum exactly: adds, subtracts, multiplies and divides, and returns the answer in figures and in words.

search_knowledge_base fires on factual questions about the business: pricing, hours, policies, products.

Every call already opens with the local date and time, so the agent can resolve "tomorrow" without get_current_time. Add it for a fresh reading partway through a long call, or to quote the time where the caller is.

calculate keeps quoted prices right. A model can slip on arithmetic, so an agent with this tool works out every total, rate and GST figure with it, never in its head.

Texting the caller

ToolWhat it does
send_text_messageTexts the caller a link or a short piece of information on the number they are calling from. If texting is unavailable, the tool tells the agent to read it aloud instead.
send_live_linkCreates a live web page for the call and texts the link. Companion tools push content onto that page while the conversation continues. In a text conversation it returns the link for the agent to send in its reply.

send_text_message fires when the caller asks for a link, or when reading a long URL aloud would be awkward. send_live_link fires when the caller would get more from seeing something than from hearing it.

Capturing details by form

Some values are slow and error-prone to take by voice: an email address, a postcode, an unusual spelling. These two tools work as a pair.

ToolWhat it does
request_details_formTexts the caller a link to a short web form. A location field opens a map and returns a tidy street address.
check_captured_detailsReads back what the caller submitted. This is the only way those values reach the agent.

The form is an accelerator, not a gate. If the caller cannot use the link, the agent takes the detail by voice instead.

The agent calls check_captured_details once it is ready to use the details and before passing them to another tool such as take_a_message.

Verifying an order

Another pair. The first sends a code, the second checks it, and only a correct read-back unlocks the order tools.

ToolWhat it does
send_order_verification_codeTexts the caller a one-time six-digit code to prove they own an order.
verify_order_codeChecks the code the caller reads back. A match unlocks the order tools for the rest of the call. A wrong, expired or missing code keeps them locked.

The code goes out before any order detail is revealed. The agent asks the caller to read it back and verifies immediately.

Wire the gate with prerequisites so the order tools cannot run until verification succeeds.

Working the phone line

ToolWhat it does
call_and_connectRings a person or business the caller asks for and puts them through. Australian mobiles, landlines and 13, 1300 and 1800 numbers only. It never rings an emergency, overseas or 19 number.
press_keysPresses keys on the agent's own line. Accepts 0-9, A-D, *, and #. Used for navigating an upstream IVR menu. Off a live call it says so and the agent carries on by voice.
capture_digitsReads the digits the caller keys in, such as an account number or a PIN. Turn on Keypad input under Call handling first, or it can't hear the keys.
add_to_do_not_callPuts the number the call is connected to on the workspace do-not-call list, so no campaign or lead callback dials it again.

add_to_do_not_call fires when the person asks not to be contacted again, and the agent confirms the opt-out only after it succeeds. Every campaign call and lead callback has it without you adding it; add it to an agent so inbound callers can opt out too.

On this page