Visual Pipeline Builder Beta Release Notes

The following are release notes for the prerelease versions of the Visual Pipeline Builder App, which provides no-code and low-code tools to help customers quickly build Tetra Data Pipelines that run automated data operations and transformations, and then enrich and push that data to downstream systems.

🚧

IMPORTANT

The Visual Pipeline Builder is available in beta release currently and is activated for customers through coordination with TetraScience. For more information, or to activate the app in your environment, contact your customer account leader.

v0.5.0

Release date: 2 July 2025

What's New

TetraScience has released its first version of the Visual Pipeline Builder App, version 0.5.0, as part of a beta release. The new app provides no-code and low-code tools to help customers quickly build Tetra Data Pipelines that run automated data operations and transformations, and then enrich and push that data to downstream systems. Customers that activate the app have the option to toggle between the existing Pipeline Edit page in the TDP user interface and the new Visual Pipeline Builder experience.

After coordinating with TetraScience to activate the app, customers can access the new Visual Pipeline Builder in the TDP by doing the following:

For TDP v4.3.0 and higher

  1. Sign in to the TDP.
  2. In the left navigation menu, choose Pipelines. Then, select Visual Pipeline Builder. The Visual Pipeline Builder appears.

For TDP v4.2.x

  1. Sign in to the TDP.
  2. In the left navigation menu, choose Data & AI Workspace.
  3. In the EMBEDDED DATA APPS section, select the Visual Pipeline Builder tile.

Here are the details for what's new in Visual Pipeline Builder v0.5.0.

Prerequisites

Visual Pipeline Builder v0.5.0 requires the following:

  • TDP v4.2.0 or higher (v4.3.1 or higher is recommended)
  • Customers must contact their customer success manager (CSM) or account executive to activate the app in the TDP user interface.
  • App users must have the following TDP permissions:
    • Pipelines: Full Access
    • Artifacts: Protocol Task Script Connectors: Full Access

New Functionality

New functionality includes features not previously available in the Visual Pipeline Builder App.

New Visual Pipeline Builder User Interface

The new, optional Visual Pipeline Builder user interface provides the following capabilities:

  • Create new Tetra Data Pipelines or edit existing pipelines by using a library of validated parsers, data integrations, and other available functions.
  • Edit and modify pipeline steps and configurations without manually manipulating the pipeline's code.
  • Deploy new and updated pipelines to the TDP directly from the app's user interface.
  • Use Artificial Intelligence to build new pipelines from existing TetraScience components.

The Visual Pipeline Builder includes five main components:

  • Builder
  • Step Configuration
  • Pipeline Configuration
  • Launch
  • AI Chat Assistant

Builder Tab

The dashboard's Builder tab provides options to build and modify pipeline steps by dragging-and-dropping preconfigured pipeline templates and specific pipeline components onto the page.

Builder Tab Actions
ActionDescription
Double-click ConfigureOpen node configuration modal
Add Task ScriptAdd new TaskScript nodes from side panel
Edit Template NameModify the pipeline template name
Auto LayoutAutomatically arrange nodes using dagre algorithm

Step Configuration

The Step Configuration modal opens when you double-click any pipeline step in the Builder tab, allowing you to configure individual step properties and parameters.

Step Configuration Actions
ActionDescription
Edit Step NameModify the display name of the pipeline step
Edit Step DescriptionAdd or modify the step description for documentation
Select Function VersionChoose the version of the task script to use
Select FunctionChoose which function to execute from the available task script functions
Configure Step InputsDefine input parameters and their values for the step
Set Continue On ErrorConfigure whether the pipeline should continue if this step fails
Restore DefaultsReset step configuration to default values
View DocumentationAccess task script documentation and usage examples
Copy Step ConfigurationDuplicate the current step configuration (when enabled)

Configuration Tab

The dashboard's Configuration tab provides options to customize pipeline configuration settings.

Configuration Tab Actions
ActionDescription
Edit Mode ToggleSwitch between view-only and edit modes using a toggle switch
Add Configuration ItemAdd new pipeline configuration parameters (only available in edit mode)
Edit Configuration ItemModify existing configuration parameters including name, type, value, and required flag
Remove Configuration ItemDelete configuration parameters from the list
Change Field TypeSelect from available field types: string, text, number, boolean, python script
Set Required FlagMark configuration items as required or optional using checkboxes

Launch Tab

The dashboard's Launch tab provides the ability to deploy new pipelines and pipeline versions to the TDP within the app.

Launch Tab Actions
ActionDescription
Deploy PipelineDeploy the current pipeline template to TDP with automatic version incrementing
Validate ProtocolReal-time validation of the generated protocol YAML with error highlighting
View Protocol YAMLDisplay the auto-generated protocol YAML in a read-only editor with syntax highlighting
Change DetectionVisual indicator showing when changes have been made since last deployment
Deployment Status TrackingReal-time status updates during the deployment process with progress indicators
Version ManagementAutomatic calculation and display of the next protocol version to be deployed

Pipeline Deployment Behavior

The Visual Pipeline Builder applies the following default configurations and naming conventions when deploying pipelines to the TDP:

  • Default Pipeline Triggers: Deployed pipelines are automatically configured with a default trigger condition that filters for files that include the label visual-pipeline-builder='change_me' and FileCateogry=raw. This trigger uses an AND operator to ensure both conditions are met before pipeline execution. Pipelines are deployed in a disabled state by default and must be manually enabled after reviewing and editing the trigger condition, which helps avoid processing unwanted files.

  • Private Protocol Artifacts: All protocols generated by the Visual Pipeline Builder are deployed as private namespace artifacts within your organization's namespace (for example, private-{orgSlug}). This behavior ensures that the protocols are accessible only within your organization.

  • Automatic Naming Convention: The system automatically generates names using the following patterns:

    • Protocol Slug: vpb-{templateId-first8chars} (for example, vpb-a1b2c3d4)
    • Pipeline Name: Uses the template name if available, otherwise it defaults to vpb-{protocolSlug}-{version}
    • Protocol Namespace: private-{organizationSlug}

AI Chat Assistant

The Visual Pipeline Builder includes an integrated AI Chat Assistant that helps users automatically build pipelines from existing TetraScience components using natural language descriptions.

AI Chat Assistant Capabilities

  • Pipeline/Protocol Generation: Generate complete pipelines from natural language descriptions
  • Self-Service Guidance: Get recommendations for task scripts, protocols, and pipeline patterns
  • Instrument Support: Query which laboratory instruments are supported by TetraScience components
  • Template Creation: Generate pipeline templates based on specific requirements
  • Launch Integration: Deploy AI-generated pipelines directly through the Launch tab

Usage Examples

  • Generate a pipeline for processing HPLC data from Agilent instruments.
  • Find out what task scripts are available for parsing chromatography data.
  • Discover which TetraScience components support Thermo Fisher instruments.

Requirements

  • Amazon Bedrock Access: Contact your Customer Success Manager (CSM) to obtain access. For more information about Amazon Bedrock, see the Amazon Bedrock User Guide.

Limitations

The following are known limitations of Visual Pipeline Builder v0.5.0:

  • The app uses task script README files to determine input configurations. This parsing might be inconsistent, because README file formats vary greatly between task scripts.
  • The AI Chat Assistant information cannot be guaranteed to be accurate. Agent may hallucinate or give incorrect information.
  • The AI Chat Assistant is limited to publicly available TetraScience components and cannot incorporate organization-specific components.
  • AI-generated pipelines with complex logic may require manual implementation and refinement.
  • The AI Chat Assistant currently supports English language input only.
  • AI Chat Assistant response times can be slow, taking up to 60 seconds for complex queries.

Known and Possible Issues

The following are known issues in Visual Pipeline Builder v0.5.0:

  • Customers can't load existing TDP pipelines into Visual Pipeline Builder.
  • Many pipeline configuration options are not directly editable. These must be edited after deployment on the TDP Pipeline Edit page. These configurations include the following:
    • Pipeline triggers
    • Configuration secret and shared settings
  • Templates are user-specific and cannot be shared. Once deployed, however, users may share TDP pipelines.
  • No keyboard shortcuts for common operations.
  • No bulk deletions of templates.
  • No copy/paste functionality for nodes.
  • No undo/redo functionality. Users cannot revert changes.
  • Loading steps from older versions of protocols is not supported.
  • No validation of step dependencies or connections.

Upgrade Considerations

To activate the Visual Pipeline Builder, please contact your customer account leader.

After coordinating with TetraScience to activate the app, customers can access the new Visual Pipeline Builder in the TDP by doing the following:

  1. Sign in to the TDP.
  2. In the left navigation menu, choose Pipelines. Then, select Visual Pipeline Builder. The Visual Pipeline Builder appears.

🚧

IMPORTANT

Updating the application currently will delete all user templates. Contact your customer account leader if you need to save your templates before upgrading app version

Other Release Notes

To view other release notes for Tetra Data Apps, see Tetra Data Apps Release Notes.