Katexs
Troubleshooting tools

Tools

Troubleshooting tools

Find out why a tool failed, timed out or was never called.

The tool never fires

  • Check the tool is enabled on the agent, not just in the workspace.
  • Make the description say exactly when to call it, and add a matching rule to the prompt.
  • Make sure the function name is unique and doesn't clash with a built-in tool name. Clashing functions are skipped.

The agent says "That tool isn't available right now"

The tool is disabled, the URL was refused by the security checks (not https, internal host, private IP, credentials in the URL), or the agent doesn't exist in this workspace. Fix the configuration and save the agent again.

The agent says "I didn't get everything I need for that"

The model's arguments failed schema validation: a required field is missing, a type is wrong, or a value isn't in the enum. Open the tool call in Traces to see which field failed, then improve the parameter descriptions.

The agent says "That's taking longer than expected"

Your endpoint didn't answer within 800 ms. Make it faster or mark the function async. See Latency and async tools.

The agent says "That didn't go through on my side"

Your endpoint returned a non-2xx status, redirected, or the connection failed. Check your server logs for the call id and timestamp.

Status reference

Logged statusMeaning
okThe tool ran and returned a result.
errorThe tool failed, timed out or returned invalid output.
deniedThe tool is not enabled for this agent, or its URL was blocked.
rate_limitedThe workspace or contact exceeded its tool rate limit.

Last updated November 2026 · Found a problem? Email support@katexs.com