Skip to content

Commit cb0a1e0

Browse files
authored
docs: automated update - 2026-W17 (#32)
1 parent a7c95fd commit cb0a1e0

1 file changed

Lines changed: 93 additions & 35 deletions

File tree

‎docs/user-guide/studio-app-ui-overview.mdx‎

Lines changed: 93 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -9,30 +9,37 @@ import { HelpCircle, Info, Delete, Maximize2, PlusSquare, Copy, ListRestart } fr
99

1010
# TangleML Studio UI Guide
1111

12-
TangleML Studio provides a comprehensive web-based interface for building, managing, and running machine learning pipelines. This guide walks you through the three main areas of the application: Home screen, Editor, and Pipeline Run.
12+
TangleML Studio provides a comprehensive web-based interface for building, managing, and running machine learning pipelines. This guide walks you through the main areas of the application: Home screen, Editor, Pipeline Run, and Settings.
1313

1414
## Home screen
1515

1616
The home screen serves as your dashboard for managing pipelines and monitoring runs across your TangleML instance.
1717

1818
### All runs
1919

20-
The **All Runs** section displays a comprehensive list of all pipeline runs on your TangleML instance. This centralized view helps you track execution history and monitor pipeline performance across your organization.
20+
The **All Runs** section displays a comprehensive list of all pipeline runs on your TangleML instance.
2121

2222
<img src={require("./assets/HomeScreen_AllRuns.png").default} alt="All Runs" style={{width: "100%", borderRadius: "6px"}} />
2323

24-
- **Filtering**: Filter runs by creator to find specific executions. Patila matches are not supported, you must use the full name.
24+
The runs list includes a filter bar with the following controls:
25+
26+
- **Name search**: Filter runs by pipeline name. Partial matches are supported.
27+
- **Created by**: Filter to show only runs created by a specific user.
28+
- **Date range**: Narrow results by creation date using start and end date pickers.
29+
- **Annotation filters**: Add key/value annotation predicates to filter runs by custom metadata attached at submission time.
30+
- **Active filter chips**: Active filters appear as removable chips below the filter controls. Click **Clear all** to reset.
2531
- **Run status**: View the current status of each run (**Running**, **Succeeded**, **Failed**, **Cancelled**).
2632
- **Quick access**: Click on any run to view detailed execution information.
2733

28-
2934
### My Pipelines
3035

31-
The **My Pipelines** section manages your draft pipelines stored locally in browser storage. This is your personal workspace for pipeline development before submission.
36+
The **My Pipelines** section manages your draft pipelines stored locally in browser storage.
3237

3338
<img src={require("./assets/HomeScreen_MyPipelines.png").default} alt="My Pipelines" style={{width: "100%", borderRadius: "6px"}} />
3439

35-
- **Local storage**: All draft pipelines are stored in your browser's local storage. For more on local vs shared storage, see [Pipelines Peristence](/docs/getting-started/pipelines-persistence).
40+
- **Local storage**: All draft pipelines are stored in your browser's local storage. For more on local vs shared storage, see [Pipelines Persistence](/docs/getting-started/pipelines-persistence).
41+
- **Filter and search**: Use the filter bar to search pipelines by name. Matching text is highlighted in search results. Sort by name or last modified date.
42+
- **Tags**: Pipelines with tags display them directly in the list row for quick identification.
3643
- **Bulk operations**: Select multiple pipelines using checkboxes for bulk delete operations.
3744
- **Run history**: Pipelines with existing runs display a "runs" popover showing execution history.
3845
- **Quick actions**: Edit, duplicate, or delete pipelines directly from the list.
@@ -56,11 +63,11 @@ The Editor consists of four main areas:
5663

5764
The top bar provides quick access to essential functions:
5865

59-
- **Pipeline name:** Shows the current pipeline’s name. Click to edit and rename your pipeline.
66+
- **Pipeline name:** Shows the current pipeline's name. Click to edit and rename your pipeline.
6067
- **Import pipeline:** Load a pipeline into the editor from a file or by pasting YAML content.
6168
- **New pipeline:** Start a fresh, empty pipeline project.
6269
- **Backend status:** Check the status of your backend connection at a glance.
63-
- **Settings:** Access backend settings and adjust your personal preferences.
70+
- **Settings:** Navigate to the Settings page to configure your backend connection, personal preferences, beta features, and secrets.
6471

6572
### Left panel
6673

@@ -123,7 +130,6 @@ The Canvas Toolbar provides a set of essential tools to manage and navigate your
123130

124131
<ImageAnnotation src={require("./assets/GroupSelection.png").default} alt="Canvas Toolbar">
125132

126-
127133
- **Mini-map**: Offers a visual overview of your entire pipeline layout, letting you quickly jump to different areas.
128134
- **Zoom In/Out**: Adjusts the canvas scale so you can focus on details or see the bigger picture.
129135
- **Fit to View**: Automatically rescales and centers your pipeline to fit the entire view.
@@ -139,6 +145,7 @@ The Canvas Toolbar provides a set of essential tools to manage and navigate your
139145
- Tasks appear as rectangles with inputs on the left, outputs on the right
140146
- Connection points (handles) for creating data flows
141147
- Visual indicators for validation status and recent changes. Red dot indicates a validation error.
148+
- Click the collapse button in the node header to toggle between expanded and collapsed view. Collapsed nodes show only the node title and connection handles, reducing visual clutter on large pipelines.
142149

143150
</ImageAnnotation>
144151

@@ -157,17 +164,23 @@ The editor tracks the last 50 changes, and you can undo and redo changes from th
157164

158165
#### Group operations
159166

160-
To activate group operations, select **Group Selection** in the canvas toolbar. From there, you can:
167+
To activate group operations, select **Group Selection** in the canvas toolbar or hold `Ctrl/Cmd` and click individual nodes. From there, you can:
161168

162169
- **Delete**: Remove all selected nodes and their connections.
163-
- **Duplicate**: Create copies of selected nodes while preserving their connections.
170+
- **Duplicate**: Create copies of selected nodes while preserving their connections.
164171
- **Update**: Apply version updates or configuration changes to all selected nodes simultaneously. Useful when upgrading multiple components to newer versions.
165172
- **Move as group**: Drag any selected node to move the entire selection while maintaining relative positions.
166173

174+
When multiple nodes are selected, the right panel displays a **Multiselection Context Panel** summarising the selected nodes by type (tasks, inputs, outputs). You can view and perform bulk actions on the selection from there.
175+
167176
:::tip
168177
Use Ctrl/Cmd+A to select all nodes, then deselect specific ones with Ctrl/Cmd+Click.
169178
:::
170179

180+
:::warning
181+
Tasks with validation errors will prevent pipeline execution. Check the validation section to identify and resolve issues before submitting runs.
182+
:::
183+
171184
### Pipeline context panel
172185

173186
When no Task is selected, the panel shows pipeline-level information:
@@ -181,6 +194,12 @@ When no Task is selected, the panel shows pipeline-level information:
181194
- Unique digest identifier (click to copy)
182195
- Validation status and errors
183196

197+
**Tags:**
198+
199+
- Add up to 10 tags to a pipeline for categorisation and search.
200+
- Click **Add tag** to create a new tag. Tags appear in the pipeline list on the Home screen.
201+
- Click an existing tag to edit or remove it.
202+
184203
**Pipeline inputs/outputs:**
185204

186205
- All pipeline parameters via Input/Output nodes
@@ -205,6 +224,7 @@ When a task is selected, the panel shows three tabs.
205224
- Copy value to clipboard
206225
- Reset to default value
207226
- Exclude argument from execution
227+
- Copy a shareable link to this node directly to your clipboard
208228
- Green indicator for recently changed values
209229
- Expandable multi-line editor for complex values
210230
- Click row to view argument description
@@ -213,13 +233,23 @@ When a task is selected, the panel shows three tabs.
213233
When configuring component inputs, you have several actions available through the toolbar buttons:
214234

215235

216-
| Action | Icon | Description |
217-
| -------------------- | ---- | ------------------------------------------- |
218-
| **Copy value** | <Copy/> | Copies the current input value to clipboard |
219-
| **Reset to default** | <ListRestart /> | Resets input to its default value from YAML |
220-
| **Exclude argument** | <Delete /> | Excludes this input from execution |
221-
| **Include argument** | <PlusSquare /> | Re-includes a previously excluded input |
236+
| Action | Icon | Description |
237+
| -------------------- | ---- | ------------------------------------------- |
238+
| **Copy value** | <Copy/> | Copies the current input value to clipboard |
239+
| **Reset to default** | <ListRestart /> | Resets input to its default value from YAML |
240+
| **Exclude argument** | <Delete /> | Excludes this input from execution |
241+
| **Include argument** | <PlusSquare /> | Re-includes a previously excluded input |
242+
| **Copy node link** | Link icon | Copies a shareable URL that opens the pipeline run and navigates directly to this node |
222243

244+
#### Argument types
245+
246+
Task arguments support three input modes, selectable via the dropdown on each argument field:
247+
248+
- **Plain value**: Enter a static string, number, or other value directly.
249+
- **Secret**: Reference a secret stored in Settings > Secrets. The secret value is resolved at runtime and never exposed in the pipeline definition.
250+
- **System data**: Reference dynamic runtime data provided by the execution environment (for example, the current pipeline run ID or execution timestamp).
251+
252+
To switch an argument to a different mode, click the **dynamic data dropdown** icon at the right of the argument field and select the desired type.
223253

224254
#### Exclude/include argument
225255

@@ -247,7 +277,7 @@ For arguments that require sensitive or runtime-generated values, click the **dy
247277
Default values are specified in the component's YAML definition and serve as fallback values when an input is not explicitly provided. Authors specify default values in the component specification.
248278

249279
:::warning Default value divergence
250-
The default value shown in the UI comes from the component's YAML definition, but it may differ from what the actual component implementation uses.
280+
The default value shown in the UI comes from the component's YAML definition, but it may differ from what the actual component implementation uses.
251281
:::
252282

253283

@@ -281,16 +311,6 @@ The default value shown in the UI comes from the component's YAML definition, bu
281311

282312
</ImageAnnotation>
283313

284-
:::tip
285-
You can collapse the task node. Just add a `w` and `h` field to your Node position annotation on a node.
286-
<img src={require("./assets/CondenseNode.png").default} alt="Collapsed task node example" width="100%" />
287-
:::
288-
289-
290-
:::warning
291-
Tasks with validation errors will prevent pipeline execution. Check the validation section to identify and resolve issues before submitting runs.
292-
:::
293-
294314
## Pipeline Run view
295315

296316
The **Pipeline Run** view provides detailed insights into pipeline execution, allowing you to monitor progress, inspect outputs, and debug issues.
@@ -304,16 +324,16 @@ The main area displays the pipeline graph with execution status for each task:
304324
- Visual indicators show task status (Pending, Running, Succeeded, Failed, Skipped)
305325
- Execution timeline and duration for completed tasks
306326
- Real-time updates for running pipelines
327+
- Click the collapse button on any node to hide its inputs and outputs and reduce visual clutter
307328

308329
### Run actions
309330

310331
Available actions depend on run status:
311332

312-
- **Inspect**: Open the pipeline editor for the run. Only available for pipelines that are stored in the local browser storage.
313-
- **Cancel**: Stop a running pipeline. Only user that created the run can cancel it.
314-
- **Re-run**: Re-run a pipeline with same parameters.
315-
- **Clone**: Create new pipeline from this run's configuration.
316-
333+
- **Inspect**: Open the pipeline editor for the run. Only available for pipelines stored in local browser storage.
334+
- **Cancel**: Stop a running pipeline. Only the user who created the run can cancel it.
335+
- **Re-run**: Re-run a pipeline with the same parameters.
336+
- **Clone**: Create a new pipeline from this run's configuration.
317337

318338
:::tip
319339
Use the logs tab to debug failed tasks. Error messages and stack traces help identify issues quickly.
@@ -333,9 +353,11 @@ When viewing the overall run:
333353
- Input parameters used
334354
- Overall pipeline outputs
335355

356+
Output nodes in the graph display their artifact values inline when the run has completed.
357+
336358
#### Task Execution details (task selected)
337359

338-
When a specific Task is selected, three tabs provide comprehensive Execution information:
360+
When a specific Task is selected, three tabs provide comprehensive execution information:
339361

340362
#### 1. Artifacts tab
341363

@@ -349,7 +371,6 @@ When a specific Task is selected, three tabs provide comprehensive Execution inf
349371

350372
See [Understanding Artifacts](/docs/core-concepts/artifacts) for a full list of supported viewer formats.
351373

352-
353374
#### 2. Details tab
354375

355376
<ImageAnnotation src={require("./assets/RunView_Details.png").default} alt="Pipeline Run View">
@@ -360,6 +381,7 @@ See [Understanding Artifacts](/docs/core-concepts/artifacts) for a full list of
360381
- Resource usage statistics
361382
- Component version used
362383
- Execution environment details
384+
363385
</ImageAnnotation>
364386

365387
#### 3. Logs tab
@@ -371,15 +393,51 @@ See [Understanding Artifacts](/docs/core-concepts/artifacts) for a full list of
371393
- System messages
372394
- Error traces for debugging
373395
- Log filtering and search capabilities
396+
- Logs auto-scroll to the latest entry while a task is running. Scroll up to pause auto-scroll.
397+
- Timestamps show elapsed time while the task is running and switch to absolute time after it completes.
398+
374399
</ImageAnnotation>
375400

401+
## Settings
402+
403+
The Settings page is accessible from the top bar and provides a sidebar layout with four sections:
404+
405+
### Backend
406+
407+
Configure the connection to your TangleML backend instance:
408+
409+
- **Backend URL**: The URL of your TangleML backend.
410+
- **Connection status**: Live indicator showing whether the backend is reachable.
376411

412+
### Preferences
413+
414+
Adjust personal preferences that apply to your browser session:
415+
416+
- Theme and display options
417+
- Editor behaviour settings
418+
419+
### Beta Features
420+
421+
Enable or disable opt-in features that are still under active development. Beta features are toggled per-browser and do not affect other users.
422+
423+
### Secrets
424+
425+
Store credentials for use in pipeline component arguments. Secrets are encrypted at rest and resolved at execution time — their values are never stored in the pipeline YAML.
426+
427+
- **Add secret**: Provide a name and value. The name is used to reference the secret in task arguments.
428+
- **Replace secret**: Update the value of an existing secret without changing its name.
429+
- **Delete secret**: Remove a secret. Any pipeline arguments referencing it will need to be updated.
430+
431+
:::tip
432+
To use a secret in a task argument, open the argument's dynamic data dropdown and select **Secret**, then choose the secret by name.
433+
:::
377434

378435
## Best practices
379436

380437
- **Save frequently**: Use **Save Pipeline** regularly to preserve your work
381438
- **Validate before running**: Check the validation panel for errors before submitting
382439
- **Use descriptions**: Add meaningful descriptions to help others understand your pipeline
440+
- **Use tags**: Tag pipelines with project names or status labels to make them easier to find in the pipeline list
383441
- **Organize components**: Keep your **User Components** library organized by removing unused items
384442
- **Monitor runs**: Check the **All Runs** section to track pipeline performance over time
385443

0 commit comments

Comments
 (0)