Skip to main content

Edit a Flow with AI

You can ask the AI to modify your existing flow at any time. The AI receives the current graph state and generates targeted operations to apply your requested changes.

How to edit

  1. Open the AI panel
  2. Describe what you want to change (you don’t need to describe the whole flow)
  3. The AI generates only the operations needed for your change

What you can edit

  • Change node parameters — update any parameter on any node (e.g., “Change the greeting to be more formal”)
  • Add steps — insert new conversation nodes into the chain
  • Remove steps — delete nodes and their edges
  • Add branches — turn a linear flow into a branching one
  • Add integrations — connect MCP servers, Exa search, or webhooks
  • Swap providers — change the LLM, TTS, or STT provider

How operations are applied

When the AI returns operations, applyOperations() applies them to the React Flow state:
  • update_node — merges new parameter values and reapplies template metadata
  • add_node — creates a new node with defaults and marks the canvas for auto-arrange
  • remove_node — deletes the node and cascades to remove all connected edges
  • add_edge — creates a new animated edge between two nodes
  • remove_edge — removes matching edges
All changes are added to the version history as a named snapshot.

Iterating

If the result isn’t what you expected:
  1. Look at the canvas to understand what changed
  2. Open the AI panel again
  3. Describe what’s wrong specifically: “The billing branch is missing a Burst node before the End”
The AI will apply corrective operations on top of the current state.