Skip to main content
The Builder is Opus’s visual workflow editor and preview environment. It provides a visual interface to drag-and-drop tasks, wire variable mappings, configure task parameters, and test execution with real-time feedback before activating workflows for production use.

​
Overview

The Builder is where you design, configure, and test workflows before deploying them to production. Here you:
  • Create workflows by adding and connecting tasks in the visual builder
  • Configure tasks with inputs, outputs, and task-specific parameters
  • Test with previews that simulate real execution with live state feedback
  • Set up integrations with external systems through Opus’s Integration Marketplace, or connect with any external API using the External Service task
    Opus’s Integration Marketplace supports 3,500+ integrations with over 36,000 different actions.
  • Validate before activation to catch errors early and reduce production issues
Think of the Builder as both your design tool and your testing environment. Investing time in thorough previews here pays dividends in fewer job failures later.

​
Builder Fundamentals

​
Tasks And Connections

Workflows are built from two simple elements:
ElementDescription
TasksIndividual steps that perform specific actions (AI processing, data import, human review, etc.)
ConnectionsLines between tasks that define how data flows and the order steps run
Each task has inputs (data it receives) and outputs (data it produces). When you connect two tasks, you’re passing data from one step to the next and telling the workflow which steps must finish before others can begin.

​
Adding Tasks

Click the + button in the builder or drag from the task palette to add tasks. Available task types include:
  • Opus Agent: Maximum capability agent that takes a natural language task description and intelligently figures out how to accomplish it
  • Custom Agent: Simple one-shot LLM interaction from popular providers (OpenAI, Anthropic, DeepSeek, etc.)
  • Opus Human Task: Assign tasks requiring human input
  • Decision Agent: Automated routing based on conditions defined via natural language or logical expressions
  • Human Decision Agent: Same as Decision Agent, but a human evaluates the conditions and makes the routing decision
  • Opus Code Expert: Execute custom Python code within your workflow
Quality assurance through human oversight or AI-powered validation.
  • Human Review: Pauses workflows for accept/reject decisions with optional editing—ideal for compliance checks and quality gates requiring human judgment.
  • Agentic Review: Uses AI to validate outputs against defined criteria, with optional auto-correction for scalable quality assurance without human bottlenecks.
Run another workflow as a sub-workflow, enabling modular workflow composition and reuse across your organization.
Connect to external services through Opus’s Integration Marketplace, which provides 3,500+ pre-built connectors with over 36,000 different actions for cloud storage, productivity tools, databases, CRMs, and more.
  • Import Data: Pull data from connected services (Google Drive, S3, etc.)
  • Export Data: Send results to external systems (Sheets, Slack, etc.)
  • Opus Text Extraction: Extract text from documents and images using OCR
  • External Service Intermediate: Connect to any external REST API via a variety of authentication options including Basic Auth, Bearer Auth, Header Auth, JWT, or No Auth.

​
Connecting Tasks

To connect tasks:
  1. Click on an output port of the source task
  2. Drag to an input port of the destination task
  3. Release to create the edge
The builder enforces valid connections—you cannot create circular dependencies or connect incompatible variable types.

​
Task Configuration

​
Variables

Each task defines typed input and output variables. For example: 
Input Variables:
  - document_text (Text): The content to process
  - max_length (Number): Maximum output length

Output Variables:
  - summary (Text): Generated summary
  - confidence (Number): Confidence score
When configuring a task, you can:
  • Link variables to upstream outputs (auto-populated from connected tasks)
  • Set static values for configuration parameters
  • Define new variables that downstream tasks can consume

​
Preview Mode

The Builder includes a dedicated preview mode for testing workflows with real-time feedback before activation.

​
Running A Preview

1

Resolve action items

All action items must be fixed before preview runs. Use Auto-fix to let Opus resolve them with AI, or fix them manually.
2

Provide test inputs

Enter values for all variables in the Workflow Input task. Use realistic data that represents expected production inputs.
3

Enter preview mode

Click Run Preview. The engine traverses your graph, executing tasks as their dependencies complete.
4

Observe execution

Watch as tasks transition through states:
  • Running: Currently executing (blue, animated)
  • Completed: Successfully finished (green)
  • Failed: Error occurred (red with message)
5

Review results

Click any task to inspect its outputs. Failed tasks show error details to help you debug.

​
Preview Features

FeatureDescription
State animationsVisual feedback shows which tasks are active, waiting, or complete
Stop controlAbort long-running previews without getting stuck
Error surfacingTasks with errors are surfaced directly in the graph
Success bannerClear confirmation when preview completes without errors

Workflows

Understand workflow lifecycle, states, and best practices.

Jobs

Learn how workflows execute as auditable jobs.

Integrations

Explore all available integrations and setup guides.

Task Reference

Detailed documentation for each task type.