Search and knowledge
Search, select, then resolve details
The knowledge routes are designed for a simple product pattern: search when the user is exploring, store the selected ID, then resolve details when you need stable display data. Related-concept lookup adds cross-domain context around a principle or strategy.
Decision rule
Use semantic concept search
Best for themes, questions, partial ideas, and exploratory UI. The score ranks retrieval fit.
Use concept text search
Best for autocomplete, exact review, and known words. It does not expand meaning semantically.
Use concept detail
Best after a selection, when the UI needs stable concept fields and field context.
A typical concept flow
Find fields
Optional: choose domain lenses.
Search concepts
Rank candidates from user wording.
Resolve detail
Load the selected concept by ID.
Add adjacency
Use related concepts for broader context.
Routes
Semantic concept search
GET /v1/search/concepts
Finds concept candidates from loose wording, questions, themes, or partial ideas. Use it for discovery.
Field search
GET /v1/search/fields
Finds academic or professional fields that can frame a problem. Use it to choose lenses and filters.
Concept text search
GET /v1/knowledge/concepts/search
Finds concepts when the user already knows the exact or near-exact words. Use it for deterministic lookup flows.
Concept detail
GET /v1/knowledge/concepts/{id}
Reads one concept and its field context by ID. Use it after discovery when your UI needs stable details.
Related concepts
POST /v1/knowledge/concepts/related
Moves from a principle or strategy into adjacent concepts from other fields. Use it for cross-domain ideation and explanation.
How to present results
Search scores
Present scores only as ranking signals. They are not confidence, scientific certainty, or importance.
Empty results
Empty lists are valid. Offer shorter wording, fewer filters, or semantic search when exact text lookup returns nothing.
Related concepts
Treat related-concept output as adjacent context for exploration, not as proof that two concepts are equivalent.