DocsHow-to
Choose when tools run
Every caller tool has a switch and a short rule. Both are saved with the agent.
By the Callaroo team. Updated November 2026
Callaroo gives the assistant named tools for orders, callbacks, reservations, texts, transfers and ending a call. On the Agent page you can turn a tool off, or keep it on and describe when it may be used. The description is not documentation for your team; it is an instruction the assistant reads before the call.
- Local tools
- 16: 10 caller-side and 6 staff-side
- Also available
- Web search, which runs in the live call and is off by default
- Where
- Dashboard → Agent → Configuration → Tools
- Saved with
- Agent settings. Save settings applies changes to the next call.
Edit a tool
Open Dashboard → Agent → Configuration → Tools.
Select the tool row, or open its menu and choose Edit.
Read the fixed tool name. It cannot be changed, so support references stay stable.
Edit Use only when. This is the instruction the assistant follows.
Set Use in new calls on or off. Some tools also need setup before they can run.
Select Save changes in the dialog, then Save settings at the top of the page.
Test the change in Try it live. It uses the last saved settings.
Reset to default restores the built-in rule for that tool. Copy tool ID copies the fixed name if you need to refer to it in support or an integration.
What the description controls
- When the assistant should reach for the tool, in the caller's terms.
- What it must confirm before a write, such as an order read back or an accepted reservation time.
- What it must not claim, such as saying a transfer connected before the tool reports success.
- It does not change access or safety checks. The tool still checks the details before it runs.
- It does not enable a capability that is switched off. A reservation, text or transfer needs its own setup as well.
Default rules
These are the built-in rules for the tools in the Agent list. They are the text Reset to default restores. Web search runs in the live call. The staff tools at the end are not on this list: they run in the staff assistant, not the caller conversation, and the Agent page does not edit them.
| Agent tool | Default rule |
|---|---|
| create_order | Use after the caller gives the food and a pickup name. Use the exact saved item and size. The draft is read back before confirmation. If it fails, say you could not save the order. |
| update_order | Use only when they change food or a name on an order already started in this call. |
| confirm_order | Use only after they say yes to the read back. If it needs review, say the shop will check it. Do not call it confirmed. |
| create_callback_request | Use only when they ask the shop to call them back. If it fails, say you could not leave a callback. Do not offer it on your own. |
| check_availability | Use only after they give a date and party size. Offer only returned times. |
| book_appointment | Use only after they accept one offered time and give a name. |
| cancel_appointment | Use only after they agree to cancel a reservation you found. |
| send_sms_confirmation | Use only after they say yes to a text. Say you will text them. If it fails, say the text was not sent. |
| transfer_to_staff | Use only when they ask for a person. If it fails, say you cannot connect them and stop. Do not offer a callback unless they ask. |
| end_call | Use after they say goodbye or they are done, or after one redirect if they stay off the shop. Say goodbye in a few words first. |
| web_search | Use only when the shop notes say to look up something that is not the menu. Never use it for food, hours, or prices. |
Staff tools
The workspace assistant has six staff tools. They use the signed-in membership and are not attached to a caller conversation. There is no on/off switch for them on the Agent page.
| Staff tool | What it does |
|---|---|
| get_recent_orders | Read recent orders, with a limit. |
| get_order_details | Read one order from the signed-in workspace. |
| count_item_sales | Count item sales from saved order records. |
| update_order_status | Move an order to the next allowed status, with confirmation where needed. |
| queue_customer_callback | Queue staff follow-up for an order; it does not place a call. |
| block_number | Add a number to this workspace's blocklist after staff confirm. |
On, off and setup
- The Agent Tools list includes the 10 caller tools and web search. Turning one off removes it from new caller conversations.
- Web search is off by default. To turn it on, describe a specific public-information reason; the default text is not accepted.
- Transfer needs a saved staff number and a live phone connection. Without both, transfer cannot run; a caller can ask for a callback.
- Reservations need the reservations capability and a saved weekly schedule with opening hours.
- Text confirmation needs messaging to be enabled, the number approved and the message service connected.
- End call needs a phone connection that can hang up on request. It cannot end a browser test.
- Staff tools are not attached to caller conversations. They run through a signed-in staff account and cannot be switched on for callers.
Individual tool switches and editable descriptions require the current settings update. If the page says a settings update is missing, keep using the existing settings and ask support. Do not edit the records directly.
What a description cannot do
- It cannot make a tool ignore the workspace, the safety checks or a required confirmation.
- It cannot change a tool's arguments, output or error handling.
- It cannot make an unavailable capability available.
- It cannot promise a caller something the shop has not saved, such as a delivery radius or a discount.
- It cannot override a guardrail. Guardrails come first, then shop notes, then the tool result.
Test the change
Save settings, then open Try it live.
Ask a question that should use the tool. Check that the answer is read back and that the assistant does not announce a lookup.
Turn the tool off and repeat. The assistant should say it cannot do that, or offer the next best option, rather than pretending.
Make one small real call before relying on the change during service.
Try it live can test conversation and tool selection, but it cannot save an order, transfer a call or send a text. Use a real call for those steps.