Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.neuronsearchlab.com/llms.txt

Use this file to discover all available pages before exploring further.

Use this guide when launching recommendations into a new surface (for example homepage, PDP, checkout upsell, or email digest).

Setup

1

Define the business goal

Define the business goal for the new surface (CTR, conversion, AOV, retention).
2

Create a dedicated context

Create a dedicated context in Console -> Contexts.
3

Configure retrieval controls

Configure the model family and any pre-query filters for that context.

Common workflows

Validate context behavior in staging

  • Call the Core API recommendation endpoint with the new context_id and representative user_id values.
  • Compare output quality with and without the context applied.
  • Confirm the right item categories and constraints are reflected.

Roll out progressively

  • Start with a small traffic segment.
  • Keep context-specific instrumentation so results can be measured independently.
  • Increase rollout percentage only after quality checks pass.

Keep context docs operational

For each context, maintain a short owner note with purpose, constraints, and KPI target so changes remain auditable.

Example app journey: Checkout upsell launch

1

Define upsell objectives

Merchandising defines checkout upsell objectives.
2

Create the checkout context

Team creates context 205 with checkout-safe filters.
3

Request checkout recommendations

Backend requests recommendations using context_id=205 during checkout.
4

Tag checkout events

Events are tagged from checkout interactions and posted to /v1/events.
5

Evaluate lift

Analytics is filtered by the checkout context to evaluate lift.

Next steps