Optimization Suggestions

The suggestions engine runs every 15 minutes, comparing your current workflow provider ordering to the optimal ordering based on live performance data.

Suggestion lifecycle

Engine detects improvement → Creates pending suggestion
                                    ↓
                          User applies or dismisses
                                    ↓
                          Applied: workflow updated + published
                          Dismissed: suggestion archived

What a suggestion contains

Field	Description
Current provider order	e.g., [brightdata, oxylabs]
Suggested provider order	e.g., [oxylabs, brightdata]
Reason	Human-readable explanation
Improvement	Percentage improvement (e.g., +12% success rate)
Metric	What improved (success_rate or cost)
Estimated cost before/after	Expected cost per 1,000 requests
Expires at	7 days from creation

Applying a suggestion

From the workflow editor page, click Apply on the suggestion banner. This:

1. Generates a new fallback chain DAG with the suggested provider order
2. Updates the workflow
3. Publishes the new version
4. Marks the suggestion as applied

Dismissing a suggestion

Click Dismiss to archive the suggestion without applying it. A new suggestion can be created if data continues to show improvement.

Auto-apply mode

When a smart workflow is in auto mode, the engine applies changes immediately without creating a pending suggestion. The suggestion is still recorded (as applied) for audit purposes.

Expiration

Pending suggestions expire after 7 days. Expired suggestions are automatically dismissed by the engine. This prevents stale suggestions from accumulating.

Only one pending per workflow

Each smart workflow can have at most one pending suggestion at a time. When the engine creates a new suggestion, any existing pending suggestion is replaced.

Discovering suggestions

• Workflows tab badge: The top-bar Workflows tab shows a count of pending suggestions
• Workflow list: Smart workflows with pending suggestions show a yellow dot indicator
• Workflow editor: A banner appears at the top with the suggestion details

Suggestion history

The workflow editor page shows a history table of past suggestions (applied and dismissed) below the canvas. This provides an audit trail of every optimization decision.