History Tools
One tool, get_timeline, answers what happened to something: what happened, when, who did it, and the detail behind it, most recent first.
It reads the history of any of these:
| Kind | Where its id comes from |
|---|---|
| Product | search_products or get_product |
| Supplier | search_suppliers or get_supplier |
| Integration | An integration named in another answer |
| Inventory record | An inventory answer |
| Brand | A product or company answer |
| Order fulfillment | list_order_fulfillments |
| Purchase order | search_purchase_orders or get_purchase_order |
| Inbound shipment | search_supply_shipments or get_supply_shipment |
Your AI tools need the kind of thing and its id, and they have both by the time you ask, because they found the thing first.
What It Answers
- “Who changed the price on ABC-100, and when?”
- “What has our Shopify integration refused this week?”
- “Why did the stock level on this SKU move?”
- “What went wrong with this fulfillment?”
Ask what went wrong and your AI tools narrow to warnings and errors, which is usually the difference between a readable answer and a wall of routine entries.
An entry that repeats is answered once, with a count of how many times it appears, so a noisy integration log stays readable.
For an Order, Use the Order Timeline
get_order_timeline reads an order and every fulfillment on it in one call. Use it whenever the subject is an order. See Orders.
What It Is Useful For
This is the tool behind a question about cause. An analytics answer says a stock level dropped; this says who dropped it and why. An order reads as unfulfilled in a channel; this says what the integration refused and when.