Query the world model
query_world_modelRead-onlyIdempotent
Answer state and structure questions about ONE entity from the knowledge graph: current and past relations, dependencies, recent changes, evidence, contradictions and uncertainty.
Suited to questions like "where does X work now?", "what does X depend
on?" or "what changed for X this week?". Each relation carries
``estado`` (CURRENT | HISTORICAL | UNRESOLVED | UNKNOWN) and
``confianza`` (0-1). UNRESOLVED relations or open contradictions mean
the current state is ambiguous. For topic-based questions across stored
memories use cognitive_query.
Args:
subject: Entity name, alias or id.
aspect: What to return:
"current_state" (default) — current relations; legacy relations
without a reliable date are listed under ``unknown``.
"historical_state" — also relations that are no longer true.
"contradictions" — open and resolved contradictions.
"evidence" — relations with their evidence and whether each is
justified.
"relationships" — all incoming and outgoing relations, excluding
the structural root link.
"dependencies" — transitive current dependencies (depends_on,
part_of, uses).
"changes" — what started, ended, was learned late or was resolved
within ``ventana_dias``.
"uncertainty" — what is not known with confidence, with a reason.
"all" — all of the above plus recent facts and episodes.
at: Optional ISO date: answer as NEXUS knew it on that date, hiding
what was not yet known or not yet true.
depth: Hops of neighbors to include via current relations (0-2).
ventana_dias: Window in days for "changes" (1-365, default 30).
Returns data for the chosen aspect; ``truncated: true`` means the
neighbor traversal hit its node limit.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| at | No | ||
| depth | No | ||
| aspect | No | current_state | |
| subject | Yes | ||
| ventana_dias | No |