Example scenarios
The questions here were tried against real store data and seen to work; you can copy them and ask them directly.
Where to find: The chat screen of the AI app you connected Who it's for: Anyone whose connection is ready In short: The questions here were tried against real store data and seen to work; you can copy them and ask them directly.
How to ask
You do not need to learn a special language — everyday English is enough. Three small habits noticeably improve the answers:
- State the threshold and the period. Not "the ones low on stock" but "the ones whose stock fell below 5". Not "recently" but "in the last 30 days".
- Say how many results you want. Something like "the top 5 selling products". Otherwise the app picks a default number.
- Ask one question, then go deeper. First the list, then "give me the details of the third one".
Questions that were tried
The questions below were tried against real store data through Treyza's tool surface.
| Question | What comes back | Pack needed |
|---|---|---|
| "Which store are you connected to in Treyza?" | Store name, plan, the key's mode and the open packs | Basic |
| "List the products whose stock fell below 5." | Products under the threshold; an empty list if there are none | Catalog (read) |
| "Can you list the categories in the store?" | The category list | Catalog (read) |
| "Show me this product's variants and their stock." | Variant names, stock and prices | Catalog (read) |
| "Show me the shipped orders." | Orders whose status is shipped | Orders (read) |
| "What is the status of this order?" | A single order's summary | Orders (read) |
| "Where is this order's shipment?" | Carrier, tracking code and movement history | Orders (read) |
| "List the pending return requests." | Return and exchange requests | Orders (read) |
| "How much revenue did we make in the last 30 days?" | Revenue, order count, average basket, conversion | Reports |
| "Which are this month's best-selling products?" | The period's top-earning products | Reports |
| "Where is our traffic coming from?" | Source breakdown and totals | Reports |
About the packs: Tool catalogue
Scenario 1 · Finding products running low
The problem: you do not know which products need reordering.
Ask:
List the products whose stock fell below 5.
The AI fetches the product list filtered by the stock threshold. Each row that comes back has the product name, its status and its total stock.
Then:
Are all of these published? Separate out the ones that are not.
How is the stock figure calculated? It is the total across all of the product's warehouses, and for a product with variants the variant warehouses count towards that total too. So products that "look like zero stock but actually have goods in their variants" do not fall into this list. Deleted products do not appear either.
It returned an empty list — is it broken? No. It means "there are no products below the threshold", which is good news. If you want to check, raise the threshold: "list the products whose stock is below 50".
Scenario 2 · Today's order situation
Ask:
Show me the shipped orders.
Then drill into a single order:
Give me the details of the first order in the list: the items and the delivery address.
Where is this order's shipment?
The last question returns the carrier name, the tracking code and the movement history.
Customer details come back masked. The name appears as A*** Y***, the phone with its last two digits only, and the street address as [masked]. City and district are shown. To lift the mask the key's scope must include CUSTOMERS_READ, and every reveal is written to the audit log. Details: Security and permissions
Scenario 3 · The summary of the day or month
Ask:
How much revenue did we make in the last 30 days? How does that compare with the previous period?
What comes back: revenue, order count, average basket value, conversion rate, visitors and sessions — plus the percentage change against the previous period if you ask for it.
Then:
Which are this month's five best-selling products?
Where is our traffic coming from?
Where do the numbers come from?
The report tools are not all fed from the same place: some read from order records, some from events collected on store visits. That is usually why two tools answer the same question with different numbers — and most of the time both are correct.
Which tool reads its numbers from where is written in one place, and that table is generated from the tool registry, so it never goes stale: the "Where do the numbers come from?" section on Tool catalogue. If a new report tool is added, or a tool's source changes, that page updates itself.
For anything that must be exact — accounting, reconciliation, how many units a product sold — use the order list:
List the last 30 days' orders and work out the total amount.
Scenario 4 · Searching for a product and drilling in
Find the products with the word "camp" in them.
Give me the details of the second one.
Show me that product's variants and their stock.
The app finds the product by name and then uses the product's ID internally to fetch the details. You never need to know the ID.
Questions outside the scope
The AI uses Treyza's tools only for store questions. For example:
What will the weather be like in Istanbul tomorrow?
calls no Treyza tool at all; the app answers from its own knowledge or says it is limited to store data. That is the expected behaviour.
If the answer is not what you expected
| Symptom | Likely cause |
|---|---|
| It says "I can't do that / I have no such tool" | That pack is not open on the key — check with Edit scope |
| The list is shorter than expected | Tools return a limited number of rows at a time; say "fetch the rest" |
| The numbers differ from the panel | For the definition gap between revenue and Net Revenue, and for which number comes from where, see Troubleshooting |
| It gives no answer, only an error | Troubleshooting |
Next step
- Review what you opened up and to whom: Security and permissions
- See every tool you have: Tool catalogue
Was this page helpful?