Issue
Tool Result Not Integrated Correctly
The AI receives a tool result but misreads, ignores, overwrites, misplaces, or fails to incorporate it correctly into the final output or workflow state.
What This Looks Like
A tool, connector, MCP call, retrieval step, calculation, or external system returns a result, but the AI does not incorporate it correctly. The final answer may ignore the result, contradict it, summarize it incorrectly, place it under the wrong field, or continue using an older assumption after the tool has returned newer information.
Why It Matters
Tool use only helps if the result changes the workflow state correctly. If the AI fails to integrate the returned result, users may trust an answer that appears tool-backed but is not actually governed by the tool output. This can break handoffs, reviews, structured output, and downstream decisions.
Structural Signal
A tool result exists, but it is not connected to the final output or next workflow state in a stable way. The issue is not just a bad answer; it is a broken handoff between external result and AI response.
Common Triggers
- The tool result is long, nested, partial, or difficult to align with the user request
- The model continues from its prior assumption instead of reconciling with the result
- The workflow does not declare how tool results should override earlier text
- The AI summarizes the result but loses required fields or constraints
- Multiple tool calls return results that need reconciliation
- The final response is generated from context around the tool result instead of the tool result itself
When to Use This Issue
Use this Issue when a tool or integration returns information, but the AI’s final answer or next step does not correctly reflect that returned result.
When Not to Use This Issue
Do not use this Issue when the tool call itself was invalid, when the tool was unavailable, or when the tool returned bad data. This Issue applies after a result exists and the AI fails to integrate it correctly.
Category
Primary Pattern
Declared Patterns
Orphaned Structure
A structural condition where a node, region, object, state, or declaration exists without linkage to the governing graph or integration pathway.
Interface Mismatch
A structural condition where observed interface behavior, shape, or exchange differs from the declared interface contract.
Contract Drift
A structural condition where a declared contract changes but connected structures, implementations, consumers, or expectations do not update in sync.
Derived Primary Lenses
Absence Lens
Detects structurally required elements that are missing from the observed structure.
Convergence Lens
Compares parallel structural systems to determine whether they align under shared authority.
Interface Contract Lens
Compares declared interface structure to observed runtime structure to detect contract deviations.
Reconciliation Lens
Evaluates whether structural changes align with declared authority updates, version changes, or reconciliation rules.
Derived Secondary Lenses
Determinism Lens
Evaluates whether identical structural inputs produce equivalent structural outputs across repeated executions.
Normalization Lens
Transforms structurally equivalent variants into a canonical form to prevent false divergence.
Propagation Lens
Traces how structural declarations, effects, or state changes propagate across boundaries or stages.
Related AI-Adjacent Issues
Search Intents
- tool result not integrated correctly
- AI ignored tool result
- agent misread tool output
- tool result missing from final answer
- AI overwrote tool response
- tool output not reflected in answer