Inventory insights
Ask about stock levels, storage units, movements, low-stock items, and inventory value.
Order overview
Review recent orders, open orders, vendor history, and order spending.
Reorder support
Get reorder suggestions, prepare draft orders, and manage suggestions directly from chat.
The AI Assistant is a new feature and is continuously being improved. If the assistant behaves unexpectedly, gives incorrect answers, or does something that does not make sense, we would really appreciate you letting us know at info@mathership.com. Your feedback directly helps us make it better.
Opening the assistant
The assistant opens as a two-panel layout:
| Panel | What it shows |
|---|---|
| Left panel | Your conversation history list |
| Right panel | The active chat area |
Scope
Before sending a message, choose which data the assistant should work with using the scope selector in the top right of the chat panel.| Scope | What it covers |
|---|---|
| This company | Inventory, orders, stock, and suggestions for the currently selected company |
| Organization | Data across all companies that belong to your organization |
The Organization scope is only available if your company belongs to an organization. If no organization is configured, the scope selector will show that no organization is available.
Starting a conversation
When you open a new chat, the assistant shows a set of suggested prompts to help you get started quickly.- Company scope
- Organization scope
| Suggestion | What it does |
|---|---|
| What’s low on stock? | Shows ingredients that are running low or at critical levels |
| Show me recent orders | Lists recent orders placed by your company |
| Get reorder suggestions | Surfaces pending reorder suggestions for your ingredients |
| Show yesterday’s movements | Summarizes inventory movements from the previous day |
| Tell me what you can do | The assistant explains its capabilities |
Sending messages
Type your question or instruction in the input field at the bottom of the chat panel and press Enter or click Send. The assistant responds with one or more message parts depending on the question. Responses can include plain text, tables, metric cards, charts, comparisons, and interactive elements.Response types
The assistant can respond with different types of structured content depending on what you asked.Text
A plain written answer. Used for explanations, summaries, and conversational responses.
Metric card
A highlighted figure with a title, a primary metric value, and optional secondary metrics.
Table
A data table with labelled columns and rows. Used for ingredient lists, order summaries, stock breakdowns, and similar multi-row data.
Comparison
A ranked list that compares entities by a metric, such as ingredients, vendors, or companies.
Time series
A chart showing one or more data series over time.
Brief
A structured multi-section report across multiple topics.
Choice chips
Clickable buttons shown when the assistant needs you to pick an option before it can continue.
Error
An error block describing what went wrong if the assistant cannot process part of your request.
Tables
Tables can include:- Quantities with units
- Currency values
- Percentages
- Relative timestamps
- Packaging breakdowns
- Inline action buttons
Comparison
A comparison is used for questions like “which ingredient has the highest waste” or “which vendor has the most orders”. Each row can show the value, its share of the total, and a delta against a baseline.Time series
A time series is used for trend questions such as order volume over the last 30 days or stock changes per week.Brief
A brief is used when the assistant prepares a comprehensive overview across multiple topics. Each section can contain its own text, tables, and data parts.Draft order preview
When you ask the assistant to prepare an order, it shows a draft preview before anything is created. The preview includes:- Number of vendors
- Number of items
- Estimated total value
Ask the assistant to prepare an order
For example, ask the assistant to create a draft order based on reorder suggestions.
Select a delivery location, if required
If a delivery location is missing, the assistant will ask you to choose one.
Creating a draft from the assistant does not send the order. You still review and send it from the orders page.
Reorder suggestion actions
When the assistant surfaces reorder suggestions, it can include action buttons directly in the response.| Action | What it does |
|---|---|
| Snooze | Snoozes the reorder suggestion for the period chosen by the assistant |
| Dismiss | Permanently removes the reorder suggestion from your list |
What you can ask
The following are examples of questions the assistant can handle.- Inventory
- Orders
- Reorder suggestions
- Organization
- What’s the current stock level of [ingredient]?
- Which ingredients are below the reorder point?
- Show me everything in [storage unit]
- What was the total inventory value last week?
- Which items have had no movement in the last 30 days?
- Show me yesterday’s stock movements
Conversations
Every chat session is saved as a conversation. You can return to previous conversations at any time to continue where you left off or review past answers.Conversation list
The left panel shows all your conversations grouped by recency:| Group | When |
|---|---|
| Today | Conversations with activity today |
| Yesterday | Conversations with activity yesterday |
| Older | All earlier conversations |
Search conversations
Use the search field at the top of the left panel to filter conversations by title.Starting a new conversation
Click New chat in the top right of the chat panel to start a fresh conversation. The button is only active when the current conversation already has at least one message.Archived conversations
Conversations can be archived to keep the list clean without deleting them. Click Show archived at the top of the conversation list to switch to archived conversations. Click Show active to return to the main list. Open the actions menu on a conversation in the list to delete it. Deleted conversations cannot be recovered.Actions and confirmations
When the assistant proposes an action — such as creating a draft order, snoozing a suggestion, or dismissing a suggestion — it always shows a confirmation dialog before executing. You can cancel at any point before confirming. After an action completes, the assistant posts a system message in the chat confirming what was done.| Action | Confirmation message |
|---|---|
| Draft created | ”Draft created.” |
| Suggestion snoozed | ”Reorder suggestion snoozed.” |
| Suggestion dismissed | ”Reorder suggestion dismissed.” |
Limitations
The assistant works with the data available in your Mathership account. It does not:- Access data outside Mathership
- Send orders automatically without confirmation
- Modify ingredients, recipes, or product mappings
- Delete inventory records
- Access real-time external prices or market data
- Guarantee 100% accuracy on all calculations
Feedback
The Mathership AI Assistant is actively being developed. If you experience any of the following, please reach out to us at info@mathership.com:- The assistant gives an answer that is clearly wrong
- The assistant creates an action you did not intend
- The assistant is unable to answer questions it should know
- The assistant behaves in a confusing or unexpected way
- A response type displays incorrectly
Related pages
Reorder Suggestions
View and manage the reorder suggestions the assistant can act on.
Ingredients
The ingredient data the assistant queries for stock questions.
Order History
Review the orders the assistant can summarize and query.
Organization Settings
Set up your organization to unlock the organization scope in the assistant.