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 |
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.
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.