AI-Assisted Editing

The AI text tab lets you build and change a scenario by describing what should happen in plain language. The text is processed by AI, which generates the matching actions in the Scenario Description area.

Nothing is applied behind your back: generated changes arrive in a preview that you either accept or discard, and the resulting actions stay visible in the Commands tree like any hand-built ones.

📸 Screenshot needed — /img/editor/ai-editing/overview.png

Capture: the AI text tab with a scenario of several actions in Scenario Description and the prompt input visible. Why it is new: this whole view has no screenshots.

---

Settings

Setting	What it does
Show details	Renders the low-level technical detail under every action.
Auto-focus	Sends only the changed sections to the AI instead of the whole scenario — automatic context passing.
Show context	Highlights which actions are included in the AI context window. Actions that are not sent are dimmed.
Auto mode	Syncs and applies changes automatically, without confirming with Enter or the Preview Changes button. Queries run continuously as you type.
Context	How many actions are sent as context. Default 3 — so each edit sends the 3 actions before and the 3 after. Range 0–50.

With Auto mode on, a delay control sets how long the Editor waits after you stop typing before querying the AI (0.5–30 s, default 2 s).

tip

Leave Context at its default. Raising it sends more of the scenario to the AI, which costs time without usually improving the result; lowering it to 0 strips the surrounding context the AI needs to place an action correctly.

---

Adding an action

1. Move the cursor between two actions — a line appears between them — and click.
2. In the input field, type what the action should do.
3. Confirm with Enter.
4. A progress indicator appears. Cancel interrupts generation at any point — useful when it takes too long or you change your mind.
5. Unless Auto mode is on (it is off by default), the result arrives in Preview Mode, where you decide whether to keep it.

📸 Screenshot needed — /img/editor/ai-editing/add-action.png

Capture: two images — the insertion line between two actions with the prompt field open, and the resulting Preview Mode with a +NEW badge.

The preview

Button	Effect
Apply	Accepts the change and inserts the action. A +NEW badge marks a newly created action.
Discard	Rejects the change; the scenario returns to the state it was in before the prompt.

Change states shown in the preview:

State	Meaning
NEW	A new action.
UPDATE	A change to an existing action.
DELETE	The action will be removed.

---

Editing an action

1. Click the action, put the cursor on the text you want to change, and rewrite it.
2. Confirm with Enter.
3. The Editor asks whether to preview the change or discard it and go back. Choose Preview Changes.
4. The request goes to the AI and comes back in preview mode, exactly as when creating an action.
5. The change is shown as EDIT: the original text struck through and the new text next to it. Confirm with Apply or reject with Discard.

📸 Screenshot needed — /img/editor/ai-editing/edit-action.png

Capture: the EDIT preview with the old text struck through and the replacement visible.

Deleting an action

Hover over an action and a cross appears — click it to delete. The action can also be deleted from the ordinary Commands view.

---

The prompt itself

Control	Effect
Generate	Sends the prompt and generates actions. Shortcut Ctrl+Enter.
Preview Changes	Sends a manual edit for the AI to interpret.
Regenerate Prompt	Generates a fresh prompt based on the modified actions.
Update Prompt	Updates the prompt so it reflects manual changes you made to the actions.
Clear prompt	Empties the prompt field.
Accept / Back	Confirms the result, or returns to the previous step.

The prompt field has a character limit, shown as a counter next to it.

tip

Update Prompt keeps the description and the actions in sync. If you hand-edit generated actions and then regenerate from a stale prompt, your edits are replaced — refresh the prompt first.

---

Context menu on an action

Right-clicking an action in Scenario Description offers:

Item	Effect
Run	Runs that action.
Run and continue	Runs the action and carries on with the following ones.
Edit	Opens the ordinary action form. Double-clicking does the same.
Delete	Deletes the action.

Action statuses

Just as in the ordinary view, you see the state of each action during a run — whether it is in progress or already finished. The states are the same as in the Runs panel.

---

Bulk editing several actions

In the Commands view you can select several actions and invoke a bulk AI action over them — for changing or reorganizing many actions at once.

1. Select the actions in Commands.
2. Invoke the AI prompt over the selection and type the instruction — for example to delete all the selected actions.
3. Press Send and switch to the AI text tab.
4. Depending on Auto mode, either confirm or discard the change.

📸 Screenshot needed — /img/editor/ai-editing/bulk-edit.png

Capture: several actions selected in Commands with the AI prompt open over the selection, and the resulting change in the AI text tab.

TODO — more complex operations

The source handbook this page is based on leaves the section on loops, conditions and other composite structures unwritten. Once the behaviour is settled, describe here how the AI handles a request that has to produce a Condition or a loop rather than a flat list of actions.

---

Related

• Prompt Actions — the same idea as a single action inside an otherwise hand-built scenario.
• AI Read — extracting structured data, rather than generating actions.