Troubleshooting

Agent Behavior Issues

Agent says “I’m not sure” too often

Likely causes

• Knowledge source doesn’t contain the answer

• Confidence threshold is set too high

• Instructions force escalation when uncertain

How to fix

• Verify relevant documents are connected

• Lower confidence threshold slightly (e.g. 0.8 → 0.7)

• Review escalation rules in instructions

Agent gives inconsistent answers

Likely causes

• Instructions are vague or open-ended

• Too many knowledge sources connected

• Temperature is set too high

How to fix

• Rewrite instructions to be explicit and scoped

• Remove unnecessary knowledge sources

• Set temperature between 0.1 – 0.3 for production agents

Agent makes assumptions or hallucinates

Likely causes

• Missing guardrails in instructions

• Broad or unrestricted knowledge access

How to fix

• Add explicit constraints:

  • “Do not guess”

  • “Say you’re unsure if information is missing”

• Limit knowledge to verified sources only

General Debugging Checklist

Before reaching out for support, check:

• Instructions are clear and scoped

• Knowledge sources are correct

• Temperature is low for production

• Memory settings are intentional

• Workflow paths are defined

• Test inputs are realistic

Most issues come from over-configuration, not missing features.

Still Stuck?

If the issue persists:

• Reproduce it with a simple input

• Check execution logs

• Contact support with:

  • Agent ID

  • Workflow (if used)

  • Input + expected output