The AI Assistant can only perform a fixed, known set of actions — called tools. It cannot run arbitrary commands, read unrelated data, or bypass your store’s return policy. Tools fall into two groups: customer tools (scoped to the logged-in customer’s own orders) and admin tools (available only to users who can manage WooCommerce).
Customer tools
| Tool | What it does |
|---|---|
list_eligible_orders | Lists the customer’s orders that are still within the return window and have at least one returnable item. |
get_order_items | Shows the line items on one of the customer’s orders, with returnable quantities. |
get_return_reasons | Returns the store’s configured list of return reasons and the refund methods you have enabled. |
create_return_request | Files a new return request for eligible items — same policy checks as the storefront form. |
create_exchange_request | Starts an exchange for an eligible item (including cross-product exchange when enabled). |
search_products | Finds replacement products/variations for an exchange. |
list_my_returns | Lists the customer’s existing return requests with their current status. |
Admin tools
These are available only when the connected account can manage WooCommerce. A regular customer cannot use them even if their assistant knows the names.
| Tool | What it does |
|---|---|
admin_list_return_requests | Lists all return requests, optionally filtered by status. |
admin_get_return_request | Shows the full detail of a single return request. |
admin_update_return_status | Approves, rejects, or completes a return request — the same as the dashboard buttons. |
admin_list_exchange_requests | Lists all exchange requests, optionally filtered by status. |
admin_update_exchange_status | Approves, rejects, or completes an exchange request. |
Built-in safety
- Same policy as your storefront — return window, ownership, excluded products/categories, sale-item rules, payment-method blocks and fraud prevention are all enforced. The AI cannot approve something a customer couldn’t do themselves.
- Own orders only — customer tools read the customer identity from the authenticated session, never from what the AI types, so one customer can never see another’s orders.
- Only enabled refund methods — the AI is offered only the refund methods you’ve turned on in settings.
- Rate limited & logged — every call counts against your per-minute / per-hour limits and is written to the Audit Log.