# Agentic Kits on your search pages

> Curated product bundles on your search pages — the kit band and the dashboard lifecycle that controls it.

Agentic Kits renders a "✨ Poneva-kit" band above the native results on your search pages:
themed bundles of complementary products composed from your real catalog for the
shopper's search term, with quick-filter chips to narrow the set. The band never modifies,
reorders, or hides your native search results — it only adds a row above them. When there
is nothing live to show for a term, nothing renders at all. The band also survives in-page
(SPA) searches: when the shopper searches again, it updates in place for the new term.

## How you control it from the dashboard

Everything is managed under the **Agentic Kits** capability:

1. **Choose terms.** In the Review queue, add the search terms kits should target.
   Terms are your allow-list — kits only ever appear for terms you put live.
2. **Generate.** "Generate kits" composes bundles from your real catalog for each term.
   You can add an optional guidance note (for example, "lean premium, max three products
   per kit") that steers every generation in the batch. Each term shows a live status
   chip — New, Queued, Generating, Failed, Ready, Live, or Paused — and the queue updates
   itself while generation runs.
3. **Review on two axes.** **Approve** lives on each kit and means "this content is
   good". **Live** lives on each term and means "shoppers may see this term". Both must
   be true before a kit serves. Bulk actions ("Approve all & go live", "Go live") cover
   the common path, and a "Pause all kits" switch stops serving everywhere instantly.
4. **Preview on your site.** From any term, "Preview on your site" opens your real search
   page with the candidate kits rendered exactly as shoppers would see them — visible
   only to you, before anything is approved or live. Preview visits never count in your
   analytics.
5. **Publish.** Kits appear on your storefront only for stores that have published the
   capability. The capability page shows **Live** exactly when at least one term is
   serving.

## Appearance

The band uses Poneva's built-in design with your product imagery and prices. Its
appearance — the band's title, accent color, and background — is configurable from the
**Design** section of the Agentic Kits capability, which shows a live preview of the band
beside the controls.

## For engineering teams

The band ships inside the same Poneva runtime the embed script loads; Poneva enables and
wires it for your store as part of Agentic Kits onboarding, so most teams never touch
anything beyond this page. For precise placement control and the wire contract, see
[Integration contract & APIs](./integration-contract.md).