How Vex finds answers

What actually happens between a visitor's question and Vex's reply — a search across everything the brand owns, in every language it is written in, with prices read live and links built fresh. Plus what to check when Vex ignores something you added.

You do not configure any of this. It is worth understanding anyway, because it explains why an answer came out the way it did, and what to change when it comes out wrong.

A search over everything the brand owns

When a question arrives, Vex runs a search across everything attached to that brand — its knowledge bases, its documentation, its uploaded files, the website pages we have read for you, your question-and-answer pairs and your product catalogue. There is no per-source setting deciding what is searched; if it is on Brand → Knowledge and it is indexed, it is in scope.

In the chat, a brand that has both help content and products gets them searched separately, at the same time. Whichever kind holds the single best match fills its places first — help content up to 8 pieces, products up to 5 — and the other kind takes whatever is left of the 8 places. That way a large catalogue cannot crowd your help articles out of an answer, and the other way round. Phone calls, the inbox's AI Context panel and the other places that run a single search still use one shared search.

The same content backs every place the brand's AI speaks:

  • the chat widget
  • phone calls taken by its voice agent
  • the suggested replies your team sees in the inbox
  • answers assembled from your API tools
  • the AI social posts it writes

That is why adding one article improves all of them at once, and why a gap shows up everywhere at once too.

Scope stops at the brand. One brand's AI cannot read another brand's content, even inside the same organisation, and every result is checked against your own organisation before it is used. Two brands that need the same article need it in both — see Copying and moving content between brands.

One search per topic, and nothing skipped

Every message that is not a plain greeting, thanks or goodbye is searched before Vex answers — a complaint, an offer or a question that is not phrased as a question all get looked up, so Vex never decides from the wording alone that it "does not need" your content.

When one message asks about several things, Vex looks each one up separately (a message asking two things gets two searches, up to four) and merges what it finds. It answers the topics your content covers and says plainly which ones it has nothing on, instead of guessing at the rest. Only when it finds nothing at all does the "when the AI doesn't know the answer" setting on Personality apply.

At the Deep search depth, Vex also searches the main topic with two more wordings of the question — run in parallel and merged — which catches content that is phrased differently. The level is chosen under Brand settings → Advanced; Brand settings describes the two levels.

Several languages at once

Search has two halves: a meaning-based half, which is naturally multilingual, and a keyword half, which has to be told which language's grammar rules to apply.

The keyword half is run in every language the brand's sources are written in, up to three. A brand holding an English knowledge base and a Hungarian one keeps full recall in both at the same time — a Hungarian question still matches the Hungarian articles properly, instead of being parsed with English rules and half-missing.

The brand's own language always goes first, and it is the fallback for anything that carries no language of its own: uploaded files, scraped website pages and Q&A entries.

Searching in several languages does not mean replying in several languages. Vex answers in the language the visitor wrote in, whichever language the source it found happens to be in.

When Vex points a visitor at one of your articles, it does not repeat a link that was stored when the article was indexed. It looks up the brand's web address at the moment it answers and builds the link then.

The practical consequence: changing your public web address never leaves a stale link buried inside an AI reply. Links people have already saved elsewhere still break — that part is unavoidable, and Your public web address explains it — but nothing Vex says from that point on is wrong.

Catalogue questions do not go through search at all

Some questions are not about a product — they are about your catalogue. "What do you sell?", "What kinds of protein do you have?", "What are your top three vitamins?" name nothing that a search could match.

For those, Vex asks your catalogue directly for its shape instead of searching:

  • with no category, it gets your top-level categories with a product count for each;
  • with a category, a condition or a sort, it gets the matching products in one order called "most popular" — products with a priority first, in priority order, then the rest by popularity, out-of-stock products last. The first ones are handed over in full, with live prices and stock — at most 5 per answer — together with the total count, and the category's sub-categories are named at the top of the result. When the visitor asks for more, Vex gets the next 5.

Because this is a lookup rather than a search, the answer is built from your real categories and your real order, not from whichever handful of products a search happened to surface. It works on every text channel and on phone calls (where the agent gets the product names only), and it is offered only when the brand actually has an active product.

Filtered and sorted lists

The same lookup can narrow and sort, for one category or for the whole shop. A question with a condition or asking for a particular order goes this way too:

Conditions
A price limit (at least, at most, or a range — what the visitor pays, sale price included), in stock, on sale, a flavor, size or color, or a word in the product's data such as vegan or lactose-free. A product matches when one of its versions meets every condition together — a pistachio version that is in stock and under the price. If a flavor or size matches nothing, Vex is shown your shop's own option values and tries again with the closest one.
Sorts
Every list comes most popular first unless the visitor asks for another order. On request: highest rated, newest, cheapest and most expensive. Each is built from your own data — the ratings with review counts and listing dates your feed sends (see The Product API), and your prices. Where that data is missing, the list says so and Vex does not make the claim. If none of the matching products carries a priority or a popularity, the list is simply alphabetical and Vex calls none of it most popular.
Best or top products
"What are your best products?", "your top three vitamins?", your best-sellers or what is trending — with no goal named — is answered with the most popular order, and Vex may present those products as your most popular ones — never as "the best". A goal ("the best for weight loss") makes it a recommendation instead, which needs the product's own data (see below).

A product whose every version is out of stock always goes to the end of every list, so a "top three" never opens with something nobody can buy.

Vex is told to use this route only for questions that name no specific product. A question naming something it does not recognise — a nickname, a model name, an unfamiliar word — is treated as a product question and searched instead, because the search knows your products' other names and the catalogue listing does not.A question naming a goal or a use — "I want to lose weight", "shoes for running" — may start here, but the list only gives Vex candidates: it searches for them before it names any product as suited to that goal.
After a catalogue question, Vex asks exactly one clarifying question — your goal, a size, a flavor — before it names a specific version. That is deliberate: one question, never a list of them.

Prices and stock are read live

Product prices, sale prices and availability are deliberately not stored in the search index. They live on each version of a product and are read from your catalogue at the moment the answer is written, then put into the text handed to the model.

This is why the sentence and the product card can never disagree, and why changing a price costs nothing: the number was never part of what was indexed, so nothing has to be re-indexed when it changes.

How a product answer is shaped

In a shop with products, Vex receives at most 5 products per answer, each in full, across every search and catalogue lookup of that answer — and it may name or link only those. By default it lays a product answer out like this:

  1. One or two sentences about the visitor's need, from general knowledge — what reaching it takes.
  2. Up to 5 base products in one to three short titled groups, one or two sentences each, in the words of the product's own description — with no praise of its own such as "excellent" or "perfect choice".
  3. Exactly one question that helps the visitor choose.

The whole answer stays under about 900 characters, unless the visitor asks for detail or a comparison. Dosage, allergens and warnings come up only when the visitor asks about them.

When the visitor asks which one is better or what the difference is, Vex puts the measurable facts side by side — both prices, the amounts, the contents — and never names a winner, never gives a reason for a price difference, and never says two products are the same.

This is the platform's default. Your own product rules and the agent's instructions win wherever they say otherwise.

What Vex is and is not allowed to say about a product

Whenever an answer contains products, Vex receives a fixed set of conduct rules together with the product data, on that turn only. You do not configure these and you cannot switch them off — they are the platform's floor, and your own product rules and agent instructions sit on top of them.

In plain terms, Vex must:

  • Name only products it was actually shown. It may not name a product, or a whole product type, that did not come back in the results.
  • Describe a product only from that product's own sheet. No purpose, quality or property the sheet does not state; no explaining one fact with another ("thanks to…", "because…") unless your data says so; no applying one product's figure to a category. If a visitor asks about something the sheet does not cover, Vex never guesses: it answers with what the sheet does say.
  • Add no judgment of its own. Vex describes each product with the selling words of that product's own description, and adds no praise or ranking of its own, about one product or about all of them together — no "excellent", "great", "perfect choice" or "the best", no "premium" versus "budget", no "purer" or "higher grade" between your own products.
  • Claim popularity only from your own order. A list in the "most popular" order may be presented as your shop's most popular products, in that order — that is also how Vex answers a question for your best, top, best-selling or trending products. Beyond that it says nothing about how well a product sells — no best-seller, most bought, "what people usually choose" — and it never calls a product the best. Highest rated, newest or cheapest only when a list sorted by your ratings, listing dates or prices says so, only for the products on it, and in its order; a highest-rated claim always comes with the rating and the number of reviews. Vex never ranks products itself by a rating it happens to see.
  • Compare with measurable facts only. When a visitor asks which is better, what the difference is or why one costs more, Vex puts the measurable facts side by side — both prices, the amounts, the contents — without the quality words of the descriptions ("premium", "superior", "professional", "luxury", "high-quality"), because next to a second product such a word reads as a ranking. It never names a winner, never gives a reason for a price difference, and never says two products are the same.
  • Never mention rules or missing data, or what it cannot say or do.
  • Say nothing about other shops' or brands' products, and never disparage a product you sell.
  • Say "out of stock" once. Vex mentions it one time, offers a product that is in stock, and promises nothing about when it comes back.
These exist because an AI that ranks your products, invents a quality ladder or claims something is popular is not just imprecise — it is making commercial claims on your behalf that you never approved and cannot stand behind.
On phone calls the voice agent keeps its own, older wording of these rules, which differs in a few places. It recommends a product for a goal only when the product's own data or its product rules state that goal and no rule forbids the claim — never because of its name, its category or its place in a list. It never invents urgency ("last pieces", "only today") unless your data says it. Whenever it names more than one product, it drops the marketing adjectives of the descriptions ("premium", "superior", "high-quality"), not only in comparisons. It explains a price difference only with the prices and differences your data states. And when a caller asks about something the data does not cover, it says briefly that it does not have that detail.
"We do not carry that" is now much rarer. A product's sheet lists its other names — search terms, nicknames, old names — and Vex is told that when a product comes back for the visitor's word, it is what they asked for. It may only say something is unavailable when the search genuinely returned nothing.

Product rules override everything else

If a product in the answer carries product rules, Vex is handed them as binding wording — after everything it found, and outside the limit on how much retrieved content one answer may carry, so an article can never squeeze a rule out.

Vex is told in so many words that these rules override the content it found, override anything said earlier in the conversation, and override what the visitor asks for. Always rules go through every time a matching product comes up; when relevant rules are filtered against the question that surfaced the product. Draft rules never reach it.

A rule of the type Finds products also works the other way round. For a product search in the chat, your find rules are searched by meaning, and a small AI check on your organization's base model chooses the ones that really fit what the visitor wants. A chosen rule brings the products carrying its keys into the answer and the look-alikes leave, before Vex reads anything — and only the chosen find rules travel with the products. In a shop with at least one such rule, Vex looks up goal and need questions in the search first rather than in the category list, because that is where these rules are chosen. This does not happen on phone calls, on catalogue lookups, or in the answer written after a visitor submits a form. The product rules page explains when to use it — and the one kind of rule it must never be used for.

If the rules for one answer would not fit — or there is simply more retrieved content than one answer can carry — whole products leave the answer, passages, product card and rules together, rather than being described with only some of their rules or their passage being cut mid-text.

Swapping content leaves no ghosts

If you take a knowledge base down, swap another one in, or move a source to a different brand, the old content stops answering immediately. It is not remembered, and it does not keep surfacing in replies after it has gone.

Why isn't Vex using this?

When something you added is not showing up in answers, work down this list. The first two columns of Brand → Knowledge answer most cases on their own.

Is it published?

An unpublished article or page is a draft: not shown to anyone, and not indexed. Publishing it indexes it straight away. Knowledge base categories have no Published switch — only the articles inside them do.

Does the Indexed column show a number?

Indexed is how many searchable pieces have been stored from that source. A dash means nothing has been stored yet, so there is nothing for Vex to find. A large article normally becomes several pieces.

Is the source on the right brand?

Check you are looking at the brand whose AI you are testing. Content added to one brand is invisible to the others.

Have you hit the indexing cap?

Free accounts, and accounts that bought individual modules only, share a fixed number of indexed items across the whole organisation. At the cap, new content stops being indexed until you remove something or upgrade — the count is shown at the top of Brand → Knowledge.

Is the question actually about that text?

Open Brand → Vex → Reports, find the answer, and expand its Steps. The knowledge-search step shows the exact query Vex ran and what it matched, with a relevance score. That is the fastest way to tell "nothing matched" apart from "the wrong thing matched" — and the two need different fixes.

Reports is the screen to live in while you are tuning this. Filter answers by Failed and Handoff (no context) — those are precisely the questions your content does not cover yet.