Decision Site

Search documentation

Search for pages in the documentation

Troubleshooting

Diagnose and resolve issues with workflows

This section helps you diagnose and resolve common issues with Agents workflows.

Troubleshooting Resources

Common Issues

Quick solutions to frequently encountered problems:

  • Workflow not triggering
  • Nodes not executing
  • Integration failures
  • AI output issues
  • Data flow problems

Error Messages

Explanation of error messages and how to resolve them:

  • Validation errors
  • Execution errors
  • Integration errors
  • AI/parsing errors

FAQ

Answers to frequently asked questions about:

  • Platform capabilities
  • Pricing and limits
  • Security and privacy
  • Integration setup

Quick Troubleshooting Guide

Workflow Not Running?

  1. Is it released? Check workflow status is Active
  2. Is the trigger configured? Verify event type
  3. Are there validation errors? Review workflow configuration
  4. Check execution logs for error details

→ See Common Issues: Workflow Not Triggering

Node Failing?

  1. Check the error message in execution details
  2. Review node configuration for missing fields
  3. Verify input data matches expected format
  4. Check integration connection if applicable

→ See Common Issues: Node Execution Failures

Integration Not Working?

  1. Verify connection status in integrations settings
  2. Check OAuth tokens haven't expired
  3. Confirm permissions are sufficient
  4. Test the integration independently

→ See Common Issues: Integration Problems

AI Output Wrong?

  1. Review the prompt for clarity
  2. Check the input data being sent
  3. Verify return type matches expected output
  4. Try higher model tier for complex tasks

→ See Common Issues: AI Node Issues

Diagnostic Tools

Execution Logs

View detailed logs for each execution:

  1. Navigate to Workflows
  2. Select the workflow
  3. Click on an execution
  4. Review node-by-node status

Node State Inspector

Examine individual node state:

  • Input data received
  • Output data produced
  • Error messages
  • Retry attempts

Integration Status

Check integration health:

  1. Go to Settings → Integrations
  2. View connection status
  3. Test connection if available
  4. Check last sync time

Getting Help

Self-Service Resources

  • Documentation - This documentation site
  • Tutorials - Step-by-step guides
  • Reference - Technical specifications

Support Channels

If you can't resolve an issue:

  1. Check FAQ - Common questions answered
  2. Review error messages - Often contain resolution hints
  3. Contact support - For persistent issues

Providing Information for Support

When contacting support, include:

  1. Workflow name and organization
  2. Execution ID if available
  3. Error message (exact text)
  4. Steps to reproduce
  5. When it started happening
  6. What you've tried already

Prevention

Best Practices to Avoid Issues

  1. Test workflows before releasing
  2. Use error handling in workflows
  3. Monitor executions regularly
  4. Keep integrations updated
  5. Review DLQ periodically

Regular Maintenance

  • Weekly: Check execution success rates
  • Monthly: Review integration connections
  • Quarterly: Audit workflow configurations

Related