Docs / Guides Build
Querying Knowledge
Choose between search, structured lookup, EKL, graph traversal and grounded questions.
| You want | Use | LLM? |
|---|---|---|
| Find things by name or content | ekos query find / ekos_search |
no |
| An entity's facts or dependency graph | ekos_query |
no |
| See how EKOS routes a question | ekos_retrieve / --explain |
no |
| Exact structured selection | EKL | no |
| What connects to X | ekos_neighborhood, ekos_dependents, ekos_impact |
no |
| A cited natural-language answer | ekos ask |
yes |
| Where two sources disagree | ekos conflicts list / ekos_conflicts |
no |
| Names that resolve to nothing | ekos check refs / ekos_xref_check |
no |
Tips
- Search with 2–3 keywords, not a sentence. Trailing
*gives prefix search (order*). - Feed a result's id to
ekos_statefor the object, its relationships and evidence. mode=hybridfuses BM25 and vectors when[embeddings]is configured.- A claim about an attribute with an open conflict carries
disputed: trueand the conflict ids: its value is only the side EKOS kept.ekos asktells the model the same.
EKL
FIND Object WHERE kind = 'Table' AND name CONTAINS 'order' ORDER BY name LIMIT 10
FIND Object SEMANTIC 'customer churn' LIMIT 20
EKL supports AS OF <timestamp>, COUNT, GROUP BY, VIA <relationship-kind> and SEMANTIC candidate sets.
Time travel
ekos diff --from 2026-09-01T00:00:00Z --to 2026-09-19T00:00:00Z
ekos_state with at reconstructs one object as it was at a past time.