AI Assistance and Agent Tools

Product copy, categories, import mapping and the reorder narrative; what the AI may do on its own; the 23 tools every agent sells from.

AI Assistance and Agent Tools

Two different things carry the word AI here, and they are switched on in two different places:

AI assistance

What you'll need

Draft product copy

On a product page, click Draft copy. Optionally set a Tone, an Audience and Notes for this draft, then generate. The drawer shows a Short description, a Description, Selling points, an SEO title and SEO description, a suggested category and tags, and the list of things the AI had to assume because the record did not say. Nothing is saved until you click Apply copy or Apply copy, category & tags. The product then shows Copy drafted by AI under its name.

The draft is written from this product's record and the catalog's own categories and tags — not from the web, and never from customer data.

Suggest categories

On Inventory → Catalog → Products, tick products and click Suggest categories. The result lists each product with the suggested category (marked (new) when it is not one the catalog already uses), tags, a confidence and a one-clause reason, under the heading Suggested categories — nothing applied yet. Click Apply all or Dismiss. The AI is told to reuse existing categories verbatim and to invent a new path only when nothing fits, so the catalog stays consistent.

Import column mapping

On Import, the preview pre-fills the Field for every column the importer recognises by name. With AI assistance on, the columns it could not match are sent — headers and a few sample values only — and come back with a suggested field and a reason. Change any of them; nothing is imported until you click Import.

Explain the plan

On Stock → Reorder plan, click Explain the plan. The AI writes a buyer's summary — what is urgent, what can wait, what looks odd (a fast seller with no reorder point, a slow one still flagged) — and re-orders the lines by what to act on first, with a reason beside each. Caveats appear only when the figures justify them (a thin sales window, incoming stock that may cover it). It never changes a quantity: the plan is arithmetic, the summary is words.

Brief me

On Stock, click Brief me for a short brief over the ledger: what is low or out, what moved most, what to look at today, with the time it was written. It reads aggregates and catalog rows — no customer names.

What the AI may do without being asked

Inventory → Setup → Inventory Settings → What the AI may do without being asked holds two switches, both off until you turn them on:

Switch What it does
Draft a description for a product an import brings in with none After a store sync, a webhook or a spreadsheet import creates a product with an empty description, the AI drafts and applies the description, short description and SEO fields. Products that already have a description are never touched.
Suggest a category and tags for every imported product that has none After an import creates products with no category, the AI suggests one with tags and applies it only when it is at least 60% sure. Categorised products are never touched.

Both run a few seconds after the import finishes (for a spreadsheet import, when its last row is written) and stamp what they wrote on the product, so the product page says Copy drafted by AI. The on-demand buttons above need neither switch. This is the autonomy principle applied to the catalog: the choice is yours, the effect is visible, and the default is what you had before.

Agent tools

Every agent type — voice, chat, SMS, email and task — and the MCP connector can use the inventory tools. They are offered on the agent's Tools tab like any other tool (hidden when the module is switched off for the workspace) and listed under Inventory in the MCP tool catalog.

Tool What it answers or does
inventory_search_products Search by name, SKU, barcode, brand, category or tag; returns each sellable variant with its price and what is available now
inventory_get_product One product in full: description, every variant with its price, stock per location
inventory_check_stock How many of one variant can be sold now, in total and per location, and whether a wanted quantity can be fulfilled — the answer to "do you have X?"
inventory_list_low_stock What is at or below its reorder point, or out
inventory_reorder_suggestions The reorder plan's lines
inventory_create_product · inventory_update_product Add a simple product (a SKU is minted; opening stock goes through the ledger) or edit one
inventory_adjust_stock · inventory_transfer_stock Receive, return, adjust or count stock; move it between locations
inventory_create_sales_order · inventory_get_order · inventory_update_order_status Take an order (units are reserved; a short line is refused with the figure; an order past a customer's credit limit is refused when the workspace says so), look one up, move it to paid, fulfilled or cancelled. On a customer conversation, see What agents may do for a customer
inventory_create_purchase_order · inventory_receive_purchase_order Draft a purchase order and receive it into stock, up to the workspace's over-receipt allowance
inventory_get_price What this customer pays for a quantity — their price list, a volume tier or the catalog price — before an order is taken
inventory_create_shipment · inventory_edit_order Ship an order in part or in full (with carrier and tracking, serials or lots); change an open order's lines
inventory_record_return Goods back from a customer against an order: restocked or written off, with the refund
inventory_list_backorders Open orders waiting on stock, oldest first, with what each is waiting for
inventory_lookup_serial · inventory_list_expiring_lots One unit by its serial: the product, whether it is in stock or sold, and the order it was sold on (on a customer conversation, only for the customer who bought it); lots expiring soon
inventory_build_assembly Build an assembly from its parts (or take one apart)
inventory_report Sales and margin (by product, customer, category or channel), slow stock, ageing, ABC, turnover, and what stock was worth on a day

Rules every channel gets from the tool descriptions, so a tenant prompt never has to repeat them: available is what can be sold now; incoming is on order and never promised; prices are per unit in the given currency; a SKU comes from a search, not from memory. A voice agent is told to confirm before any write — every inventory write moves a figure or an order — and plays a short filler while the lookup runs.

Every write stamps where it came from: the channel it ran on and the chat session, the call, the text thread, the task run or the orchestration. The ledger row and the order both link back to it, so a person reviewing an order can read what was said. When an agent changes a product, the product page says Last changed by with the fields it changed and a link to the conversation.

What agents may do for a customer

An agent on website chat, a call, a text thread or email is talking to a member of the public, and an order number read out by a stranger should not be enough to hear someone else's order or to cancel it. Inventory → Setup → Inventory Settings → What agents may do for a customer holds two choices. Task agents and MCP clients act for your own team and are never narrowed.

Setting Choices What happens
Which orders an agent shares or changes Only the customer's own orders (default) · Any order, by its number With Only the customer's own orders, an agent reads an order out when one of three things is true: the order was taken in the same conversation; it belongs to the person the conversation is linked to (the same contact, or the email or phone the order carries is theirs, including the number they are calling or texting from); or the customer gives the order number together with the email address or phone number on the order. Asked for "my orders", it lists the linked person's own. It cancels, edits, ships or records a return only in the first two cases. With Any order, by its number, the number alone is enough for all of it, which suits an agent only your own team talks to.
When a customer says they have paid Note it for a person to confirm (default) · Mark the order paid Agents take no payments, so "paid" from a customer is their word. With Note it for a person to confirm, the order stays Pending and carries a note: The customer told an agent (Website chat) that this order is paid. The agent took no payment. Check that it arrived, then press Mark paid. The agent tells the customer the payment will be confirmed. Mark paid closes the note. With Mark the order paid, the order is confirmed on the agent's word, and anything set to happen when an order is paid (stock leaving the count, an invoice in your books) happens then.

When an agent holds back, it says so and offers the next step: it asks for the email address or phone number on the order, or tells the customer it will pass the request to your team. It gives the same answer whether or not an order with that number exists.

Both settings are choices, in line with the autonomy principle: what an agent may do is yours to decide, and what it did is visible on the order. Before 10 November 2026 an agent on any channel acted as the second choice of each row describes. To keep that, pick the second choice in both rows.

Examples

Workflow triggers and notifications

The module's events are workflow triggers under Products & inventory when you build an orchestration: stock reached its reorder point, ran out, is back above zero, was adjusted; a product was created; a sales order was created, fulfilled or cancelled; a shipment was sent; a return was authorised or received; back-ordered stock arrived for an order; a lot is about to expire; a purchase order was received; a store sync failed. Each carries the SKU, location, figures, channel or platform as conditions, and none needs a contact.

Nine notifications live under Notification Preferences: A product reached its reorder point, A new order arrived from a connected store, A store sync stopped working, Stock is about to expire, Stock and its records disagree, A purchase order is overdue, A back-ordered order can now ship, A store disconnected Karmaflow and A store sent a customer privacy request, each reaching only the people who hold the matching permission.

Troubleshooting

Next steps