KnowledgeGraph.pending_questions()

Get pending enrichment questions for this knowledge graph.

Usage

Source

KnowledgeGraph.pending_questions(
    *, refresh=True, sort_by="confusion_impact", limit=None
)

Detects ambiguities (duplicate names, factual conflicts, weak relationships) and returns structured questions sorted by confusion impact.

Parameters

refresh: bool = True

If True (default), run built-in detectors to find new questions before returning.

sort_by: str = "confusion_impact"

Sort field: "confusion_impact" (default, descending) or "created_at" (ascending, oldest first).

limit: int | None = None

Maximum questions to return. Defaults to the queue’s max_per_session (7).

Returns

list[EnrichmentQuestion]

Pending questions sorted by priority.

Examples

import talk_box as tb

kg = tb.KnowledgeGraph(":memory:")
# ... add nodes and edges ...
questions = kg.pending_questions()
for q in questions:
    print(f"[{q.confusion_impact:.2f}] {q.text}")

Skip detection and return only existing questions:

questions = kg.pending_questions(refresh=False)