Product copy, categories, import mapping and the reorder narrative; what the AI may do on its own; the 23 tools every agent sells from.
Two different things carry the word AI here, and they are switched on in two different places:
ai:inventory_ai:write, which the seeded Member and Manager roles hold.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.
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.
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.
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.
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.
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.
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.
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.
inventory_reorder_suggestions, drafts purchase orders for the lines marked now and emails the buyer the list.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.
No sparkle buttons. The AI feature is not on for the workspace (ask a super admin), or your role lacks ai:inventory_ai:write.
"Suggest categories" is disabled. Nothing is ticked, or the AI feature is off.
The import automations did nothing. They act only on products the import created that had no description (or no category); updated products are skipped. Check the switches and the AI feature, and that the product was new.
An agent says it cannot find a product the catalog has. The agent's Tools tab does not include the inventory tools, or the module is hidden for the workspace. Tick the tools and save the agent.
An agent promised stock that was not there. incoming was read as available — check the agent's instructions do not override the tool's rule — or the level changed between the check and the order. The order itself is refused when the units are gone, so the customer is told at the order, not after.
An agent would not tell a customer about their order. The conversation is not linked to the order's customer and the customer did not give the email address or phone number on the order. Check the order carries the customer's email or phone, or link the conversation to the contact. For an agent only your team uses, choose Any order, by its number.
An order an agent took is still Pending although the customer paid. That is the default for a customer's word. Open the order, read the note, check the payment and record it under Payments (Record payment). To have the agent's word count, choose Mark the order paid.