How does a mismatch appear in the systems an agent connects to?
Describes the record links, variance fields and tool actions through which a mismatch becomes visible to an agent, and why write-action errors should be part of the design.
In a connected process, a mismatch is a relationship between records in different systems, not a field in one. An agent sees it only if the tools expose both sides and the link between them.
A typical shape has: - a **source record**, such as `BANKTXN-5521` in a bank feed; - a **target record**, such as `LEDGER-88140` in the ledger; - a **match key**, for example a payment reference, that is sometimes missing or malformed; - a **variance** with amount, direction and age; - a **case** record, `CASE-0412`, holding status, owner and notes.
The tools an agent usually needs are read actions (`get_record`, `search_records`, `get_history`), a policy lookup, and a small set of write actions (`propose_adjustment`, `post_correction`, `reassign_case`, `add_note`). Write actions should return structured errors when permissions or approvals block them, because that behaviour is part of what you want to test.
Time matters too. Records carry created, posted and reversed timestamps, so an agent can tell a timing difference from a true error.
Ask for the case record to link back to the generated root cause under a separate key that the agent's tools cannot read. That keeps scoring possible without leaking the answer into the agent's context.
An agent can only investigate what its tools expose, so design both sides of the pair, their link and the write constraints up front.
- Audience:
- Agent developers
- Content type:
- Integration
- Buyer question:
- What it is and why it matters
Content release: r-a220eb6e099b243b
Related questions
- How do I tell if a process is a good fit for mismatch training?
- What does a billing mismatch caused by a transposed meter read look like?
- Why is a mismatch harder for an agent than a normal lookup task?
- What is a record mismatch in a business, and why does it matter for agent evaluation?
- What does a settlement-versus-ledger break look like as an environment task?
- How is a mismatch task different from a record-matching benchmark?