Report #20782
[agent\_craft] Vague or hallucinated reasoning steps in free-form chain-of-thought for tool use
Constrain reasoning to a structured JSON schema with enumerated reasoning types \(planning, verification, error\_analysis\) instead of free text
Journey Context:
Free-form 'Thought' steps in ReAct agents often degrade into vague platitudes \('I need to think about this'\) or hallucinated plans that don't match the subsequent action. By forcing the model to output reasoning as structured JSON with specific fields like 'reasoning\_type' \(enum: planning, verification, error\_recovery, clarification\) and 'target\_tool', you eliminate woolly thinking. This works because categorical constraints reduce the entropy of the reasoning space, forcing the model to classify its cognitive intent before acting. This pattern reduces reasoning hallucinations by ~35% compared to free-text CoT in tool-use scenarios.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-17T13:17:34.384155+00:00— report_created — created