Buyers guide
When a query needs prior education before a decision ("which laptop should I buy for video editing?"), the conversational agent can accompany the results with a buyers guide: a table of key factors to consider, a list of what to avoid and price ranges per tier.
Types at.
Shape
type ImportanceLevel = 'ESSENTIAL' | 'HIGH' | 'MEDIUM' | 'LOW'
interface KeyFactor {
factor: string
importance: ImportanceLevel
recommendation: string | null
}
interface PriceRangeItem {
range: string // "Up to €800"
description: string | null
}
interface PriceRangesGuide {
budget: PriceRangeItem | null
midRange: PriceRangeItem | null
premium: PriceRangeItem | null
}
interface BuyersGuide {
enabled: boolean
title: string | null
keyFactors: KeyFactor[]
avoid: string[]
priceRanges: PriceRangesGuide | null
}
— highlighted block.
InlineBuyersGuide— inline version in the chat.
Visual importance
importance | UI |
|---|---|
ESSENTIAL | Red "Essential" badge. |
HIGH | Orange "High" badge. |
MEDIUM | Blue "Medium" badge. |
LOW | Gray "Low" badge. |
i18n strings: buyersGuide.importance.essential / high / medium / low at , it shows them as three cards with their narrative description. Prices come from the shop, not market guidelines: the agent computes them over the real catalog.
What to avoid
avoid: string[] appears as a list with a warning icon. Useful to flag common pitfalls (for example "TN panel for color editing").