Things that trip people up

1. 1

   “My exclusion returns almost nothing.”

   Most of your records are unknown on that field. Check unknown_safety_fields on a plain search and work the review queue.

2. 2

   “The rules are not matching anything.”

   Your synonyms are probably examples rather than words. Check them against a record you have never read, and check that sourceColumns actually includes the column with the text in it.

3. 3

   “Everything is going to review.”

   Either minConfidence is too high for the field, or the field is one a record genuinely cannot answer. A difficulty rating is not usually written down in a catalog; equipment is.

4. 4

   “I get a 406 from the MCP endpoint.”

   Add Accept: application/json, text/event-stream. Both values, on every POST.

5. 5

   “I edited a contract and nothing changed.”

   Editing bumps the version but does not re-tag anything. Start a run. Values a person locked stay locked regardless, which is usually what you wanted.