Docs

Recommender Domain

Use Evidpath for Recommenders to test recommendation slates, simulated users, trust collapse, repetition, novelty, cold start, and abandonment before release.

What It Tests

  • Whether returning-user and sparse-history sessions receive useful slates.
  • Whether recommendations become repetitive, stale, over-concentrated, or too popularity-heavy.
  • Whether low-patience or exploratory users lose trust or abandon.
  • Whether a candidate release changes cohort behavior relative to a baseline.

Native HTTP Contract

Endpoint

GET /health

Purpose

Confirm the service is alive before a run.

Endpoint

GET /metadata

Purpose

Return stable dataset, model, backend, and artifact metadata.

Endpoint

POST /recommendations

Purpose

Return an ordered recommendation slate for one simulated step.

Useful Commands

evidpath check-target --domain recommender \
  --target-url http://127.0.0.1:8051

evidpath audit --domain recommender \
  --target-url http://127.0.0.1:8051 \
  --scenario returning-user-home-feed \
  --seed 7

evidpath run-swarm --domain recommender \
  --target-url http://127.0.0.1:8051 \
  --brief "test trust collapse and weak first-slate behavior"

Source Links

  • Contract: https://github.com/NDETERMINA/limitation/blob/main/products/evidpath/EXTERNAL_TARGET_CONTRACT.md
  • Native HTTP example: https://github.com/NDETERMINA/limitation/tree/main/products/evidpath/examples/recommender_http_service
  • Schema-mapped JSONPath example: https://github.com/NDETERMINA/limitation/tree/main/products/evidpath/examples/recommender_schema_mapped_jsonpath
  • Python callable example: https://github.com/NDETERMINA/limitation/tree/main/products/evidpath/examples/recommender_in_process_python_api