Skip to main content

Troubleshooting Flows

Learn how to fix your broken flows

Updated over 2 weeks ago

As you work with flows in elvex, you may encounter issues that need troubleshooting. This guide will help you address common problems and improve the quality of your flow outputs.

How do I fix a broken flow?

When you encounter a broken flow, follow these steps to identify and resolve the issue:

  1. Review the error message: Always start by carefully reading the error message. It often contains valuable information about what went wrong.

  2. Check the failing step: Identify which step in the flow is failing. This will help you focus your troubleshooting efforts.

  3. Examine the step's configuration: Review the settings, instructions, and tools enabled for the failing step. Ensure everything is correctly configured.

  4. Analyze the input data: Verify that the input data for the failing step is correct and in the expected format.

  5. Test individual steps: Use the testing functionality to run individual steps and identify where the problem occurs.

  6. Review the "thinking" tab: For each step, examine the "thinking" tab to understand the AI's reasoning and identify potential issues.

  7. Check for edge cases: Consider if the flow is failing due to an unexpected input or edge case that wasn't accounted for in your instructions.

  8. Simplify and isolate: If the issue persists, try simplifying the flow or isolating the problematic step to narrow down the cause.

  9. Update instructions: Refine the instructions for the failing step to be more explicit and handle potential edge cases.

  10. Consult the elvex documentation: Check the official elvex documentation for any known issues or limitations related to your problem.

How can I improve the quality of output of a flow?

To enhance the quality of your flow outputs, consider the following strategies:

  • Break down complex tasks: Divide complex operations into smaller, more manageable steps. This allows for better control and error handling.

  • Provide clear instructions: Write concise, specific instructions for each step. Avoid ambiguity and provide examples where necessary.

  • Use appropriate tools: Ensure you're using the right tools for each step. Familiarize yourself with the available tools and their capabilities.

  • Manage context effectively: Be mindful of the context provided in each step. Too much context can lead to off-topic responses, while too little can result in inaccurate outputs.

  • Implement error handling: Add steps to handle potential errors or unexpected inputs. This can improve the robustness of your flow.

  • Validate inputs and outputs: Include validation steps to ensure data is in the correct format before proceeding to the next step.

  • Iterate and refine: Continuously test your flow with various inputs and refine the steps based on the results.

  • Leverage data sources: Utilize relevant data sources to provide accurate and up-to-date information to your flow.

  • Monitor and analyze: Regularly review the performance of your flows and analyze any recurring issues or patterns.

Remember that troubleshooting flows often requires patience and iteration. Don't hesitate to experiment with different approaches and configurations to achieve the desired results.

If you encounter persistent issues that you can't resolve, consider reaching out to the elvex support team for assistance.

Did this answer your question?