Tool not enabled on the agent, or its description is too vague
Agent calls a tool at the wrong moment
Description describes the API rather than when to use it — see tools
Agent cannot see a data table
No permission granted on the table's Permissions tab
Agent sees no rows
A row scope rule found no matching identity — scope rules fail closed
Cannot search a field by partial match
The field is encrypted — it matches on a whole value, or a whole word if set to Match any word. Never on a fragment
Agent will not read back a value it saved
The field is read-blocked, which is the safe default for personal data
Agent says it will do something, nothing happens
It described the action instead of performing it. It retries once and then reports the failure — if it persists, check the tool is enabled on the agent
Agent cannot save a value to a choice field
The field has no options configured — add them on the table's Fields tab