Unresolved controversies are fine
You do not need to resolve every controversy before agents can use Sphinx. When relevant knowledge contains an unresolved controversy, Sphinx automatically conveys the conflicting claims and uncertainty to agents. This helps prevent hallucinations and lets agents express appropriately lower confidence instead of presenting one claim as settled fact. In the refund example, an agent can explain that the sources disagree, describe both policies, and ask for confirmation before promising a refund. The disagreement remains useful context while your team investigates it. Resolve a controversy when you have enough evidence to establish the correct rule or explain when each claim applies. It is fine to leave it unresolved when the answer is still uncertain.Before you start
Select your workspace and identify someone who can confirm the correct business rule. Have the authoritative source or decision available before submitting a resolution.Investigate the disagreement
- Open Controversies from the sidebar. The default view shows Open and Elevated controversies; use the status filter to change the view.
- Expand the controversy and read each competing claim.
- Follow the page title to see the disagreement in context. Inspect its citations and References to understand the evidence.
- Use Copy link to this controversy to obtain a direct link for the relevant knowledge owner.
Provide a resolution
Under Resolution options, select an offered option if one matches the confirmed decision, or select Write a resolution to explain it yourself. A useful resolution states:- The correct definition or rule.
- Its scope, version, and effective date where relevant.
- Which source supports it and what happens to the competing claim.