Skip to the article
Browse all docs

What can an AI assistant do in Tacey? Every tool, what it reads or changes, and which ones can move money

A table of all 45 tools an AI assistant can use in Tacey: what each one does, whether it only reads, changes something, or can move money, and what you have to approve first. ChatGPT and Claude can use all 45 (writes and money only when you have allowed them); Sidekick uses only 18 of the read tools.

Odera Joseph, FounderWritten by Odera JosephFounderUpdated
View as Markdown
Ask AI

Send the Markdown address of this page to an assistant.

Open in ChatGPTOpen in PerplexityOpen in Grok

When you connect ChatGPT or Claude to Tacey, or ask Sidekick about Tacey, the assistant works through a fixed list of tools. A tool is one thing the assistant is allowed to do. There are 45 in all. ChatGPT and Claude can use any of them that the connection's permissions and your switches allow. Sidekick uses only 18 of the read tools. Most tools only read your records. A few change something, and only when you have switched that action on. Six deal with money, and they have their own page: How does an AI assistant move money in Tacey, and what do I have to confirm?

If you have not connected an assistant yet, start with Use Tacey from Claude or ChatGPT and the step-by-step pages for ChatGPT and Claude.

In short

  • Read tools (27). They look something up and change nothing. They need only the read permission.
  • Preview tools (3). prepare_order_action, prepare_address_change and prepare_settings_change show what an action would do. They change nothing.
  • Change tools (15). Each makes one change. Each needs its own permission on the connection and its own switch turned on in Tacey, and each works only from a preview made in the last 10 minutes (5 minutes for money), once.
  • Six of the change tools deal with money. Three can move money. Three only record that you handled it in Shopify. See the money page.
  • Tacey does not send a customer's name, email or phone back through any of these tools. Each tool returns a fixed set of fields, such as order numbers, statuses, reasons, counts and links. Anything you type into the chat yourself, such as a unit number, is in the chat and is visible to the assistant.

Before you start

  • Connect an assistant first: Tacey, then Integrations.
  • To let an assistant change anything, tick the matching permission when you connect it, and switch the action on under Integrations in Tacey. A permission without the switch does nothing, and a switch without the permission does nothing.
  • AI changes are off for the store until both are done. The platform also has its own master switch for changes and a separate one for money. If the one for changes is off, the assistant is told assistant actions are "not available yet"; if the one for money is off, it is told moving money from an assistant is not available. Either way the tool is not listed.
  • The directory version of the connector (the address the app directories use) is read only. It never lists a change tool or a money tool.

How to use it

Ask in plain words. The assistant picks the tool. For anything that changes something, the assistant first shows a preview, you say yes, and only then does the change run. Where you chose to approve address changes or merges in Tacey instead of in the chat, the tool answers with a link to Tacey and changes nothing until you press the button there. If you want the assistant to point you to a page instead, ask it to open the page in Tacey.

The tools

Read tools: look something up

ToolWhat it doesChanges anything?
get_unverified_ordersLists orders whose address check needs attention, newest first, up to 10No
get_order_validation_detailExplains the address check on one order in plain sentencesNo
get_validation_analyticsCounts address checks by status and country, optionally for a date rangeNo
get_order_edit_historyShows what Tacey recorded changing on one order, up to 10 changesNo
get_pending_money_actionsLists orders where money is waiting on you: stuck refunds, balances owed, held paymentsNo
get_ledger_summaryCounts order edits and totals the money Tacey collected or refunded through themNo
get_order_merge_historyLists merges Tacey made or tried, with their statusNo
get_plan_and_usageShows your Tacey plan, order usage in the current 30 days and your trialNo
get_edit_breakdownBreaks edits down by country, kind of edit or who made themNo
get_dashboard_overviewGives the Tacey Home numbers for a periodNo
list_ordersLists the orders Tacey has checked, like the Orders page, with filtersNo
get_order_overviewGives everything Tacey stored about one order: address check, changes, money waiting, merge, holdsNo
list_order_changesLists what changed after checkout, like the Order changes pageNo
get_setup_healthLists what is switched on but cannot work, and what needs attentionNo
get_tool_settingsShows how the shopper tools are set upNo
get_app_settingsShows one settings area: edit window, validation, holds, payments, merge, combine, reminders or notificationsNo
list_editing_rulesLists your rules and whether each can fireNo
list_fulfillment_holdsLists orders Tacey is holding back from fulfilment and when each endsNo
get_assistant_activityLists connected assistants and what each has read in the last 30 daysNo
get_tacey_linkReturns a link to a page in TaceyNo
get_analytics_report_linkReturns a link to an analytics report with filters already setNo
list_merchant_notificationsLists what is in your notification bellNo
list_shopper_feedbackLists the ratings customers gave after editingNo
search_help_articlesFinds up to 3 published help articles for a how-to questionNo
list_merge_candidatesLists pairs of orders that fit your merge conditions today. It reads Shopify live and can take several secondsNo
list_buyer_requestsLists customer requests to remove items, still waiting for your answerNo
list_setting_changesLists the settings an AI assistant changed on your store, with before and after valuesNo

Preview tools: show what would happen

ToolWhat it doesChanges anything?
prepare_order_actionPreviews one action on an order (re-check an address, merge two orders, apply a suggested address, ask a customer to fix or pay, place or release a hold) or a money step. Returns what it will and will not change and a proposal valid for 10 minutes, onceNo
prepare_address_changePreviews setting parts of one order's shipping address, for example the unit numberNo
prepare_settings_changePreviews changing one Tacey settingNo

Change tools: make one change, after your approval

ToolWhat it doesNeeds
recheck_addressRuns the address check again on one order and stores the new resultRe-check permission and switch, a preview from prepare_order_action
apply_suggested_addressApplies the correction Tacey's check found and confirmed for one orderAddress permission and switch, a preview
change_shipping_addressSets parts of one order's address to the values you gave, as shown by prepare_address_changeAddress permission and switch, a preview, used once within 10 minutes
merge_ordersMerges two orders of one customer that ship to the same address and fit your merge conditions: the older order is kept and gains the newer order's items at no charge, and the newer order is cancelled without a refundMerge permission and switch, a preview
ask_customer_to_fixPrepares the email asking the customer to fix a flagged address. It does not send it: it waits on the order in Tacey for you to press SendContact permission and switch, a preview
ask_customer_to_payPrepares the email asking the customer to pay a balance after an edit. It waits for you to press SendContact permission and switch, a preview
place_fulfillment_holdHolds one order's fulfilment in Shopify until a time you choose, at most 72 hours ahead. A warehouse or app that reads orders directly instead of waiting for Shopify's fulfilment request may still pick the order upHold permission and switch, a preview
release_fulfillment_holdReleases a hold an assistant placed. It never releases your own holdHold permission and switch, a preview
change_settingChanges the one setting prepare_settings_change described, to exactly that value, only if the setting still has the value it had at the preview. An assistant can only move a setting toward less risk (customers can do less, fewer emails go out, fewer orders are touched). A change the other way, and any setting about money, customer-facing words, who sees what or notification addresses, is left for you in TaceySettings permission and switch, you approve in the chat
approve_refund, confirm_merge_shipping_refund, capture_paymentMove money. See the money pageMoney permission, typed-back amount, see the money page
record_manual_refund, resolve_cancel_refund, acknowledge_swap_balanceRecord only. They note that you handled something in Shopify. They move no moneyMoney permission, see the money page

What you will see

  • The assistant answers in its own words and gives order numbers and links that open in Tacey.
  • An address change or merge you approved, and a money step, is written to the order's change history in Tacey with the assistant named, and a setting change appears in Settings changes.
  • Integrations shows the connections, and get_assistant_activity lists what each has read.

If it does not work

The assistant says a tool is not available. Three different things produce this, and the assistant's message says which. "Not available yet" means the platform switch for changes is off, and a message that moving money from an assistant is not available means the platform switch for money is off. "Needs more permission" means the connection was made without the matching permission: disconnect and connect again, ticking it. "Switched off" means the action's switch under Integrations in Tacey is off.

The assistant says my preview ran out. A preview lasts 10 minutes (5 for money) and works once. Ask for the action again.

The email it prepared did not go out. That is by design. ask_customer_to_fix and ask_customer_to_pay only prepare the email. Open the order in Tacey and press Send.

It changed a setting I did not expect. Open the list of settings changes: ask the assistant to run list_setting_changes, or open it in Tacey. It shows the value before and after and which assistant changed it.

Still stuck?

Contact Tacey support from the chat bubble inside the Tacey app, or email hello@taceysupport.app. Tell us which assistant you use, the tool name if the assistant gave it, and the message it showed.

Learn more

What this does not do

  • Tacey does not send a customer's name, email address or phone back through these tools. What you type into the chat yourself is in the chat.
  • An assistant cannot change anything you have not switched on, and cannot move money unless you have also given it the money permission within the last 24 hours and the other conditions on the money page are met.
  • An assistant cannot release a hold you placed yourself.
  • The preview tools change nothing.

Was this helpful?

One tap tells us whether this article did its job.

For AI agents: this article as markdownthe whole help centerllms.txt