Docs

Search Domain

Use Evidpath for Search to test rankers across relevance, freshness, ambiguity, typo tolerance, zero-result behavior, and personalization.

What It Tests

  • Navigational queries where the top result should satisfy a direct intent.
  • Time-sensitive queries where fresh sources need to rank highly.
  • Ambiguous and typo queries where useful diversity and recall matter.
  • Zero-result behavior where precision is better than hallucinated matches.
  • Personalized-vs-anonymous behavior where context should help without collapsing variety.

Native HTTP Contract

Endpoint

GET /health

Purpose

Confirm the search service is alive before a run.

Endpoint

GET /metadata

Purpose

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

Endpoint

POST /search

Purpose

Return ranked results for a domain-built search request.

Useful Commands

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

evidpath audit --domain search \
  --target-url http://127.0.0.1:8051 \
  --scenario time-sensitive-query \
  --seed 7

evidpath compare --domain search \
  --baseline-url http://127.0.0.1:8051 \
  --candidate-url http://127.0.0.1:8052 \
  --rerun-count 2

Source Links

  • Contract: https://github.com/NDETERMINA/limitation/blob/main/products/evidpath/EXTERNAL_TARGET_CONTRACT_SEARCH.md
  • Product source: https://github.com/NDETERMINA/limitation/tree/main/products/evidpath
  • Issues and example requests: https://github.com/NDETERMINA/limitation/issues