Documentation
HomeAPISign In
  • Getting Started
    • Overview
      • Core Concepts
      • Building your First Workflow
    • API Reference
  • Your Data
    • Brand Kits
    • Knowledge Bases
      • Add Data
        • Upload Files
        • Web Scrape
        • Import from Google Drive
        • Import from SQL Database
        • Import from Shopify
      • Knowledge Base Search
      • Knowledge Base Metadata
      • Knowledge Base API
  • Building Workflows
    • Workflow Concepts
      • Workflow Inputs
        • Input Types
      • Workflow Outputs
      • Variable Referencing
      • Liquid Templating
    • Workflow Steps
      • AI
        • Prompt LLM
          • Model Selection Guide
          • Prompting Guide
        • Transcribe Audio File
      • Web Research
        • Google Search
        • Web Page Scrape
      • Code
        • Run Code
        • Call API
        • Format JSON
        • Run SQL Query
        • Write Liquid Text
      • Flow
        • Condition
        • Iteration
        • Human Review
        • Content Comparison
        • Error
      • Data
        • Read from Grid
        • Write to Grid
        • Search Knowledge Base
        • Write to Knowledge Base
        • Get Knowledge Base File
      • AirOps
        • Workflow
        • Agent
      • Image & Video
        • Generate Image with API
        • Search Stock Images
        • Fetch Stock Image with ID
        • Resize Image
        • Screenshot from URL
        • Create OpenGraph Image
        • Create Video Avatar
      • SEO Research
        • Semrush
        • Data4SEO
      • Content Quality
        • Detect AI Content
        • Scan Content for Plagiarism
      • Content Processing
        • Convert Markdown to HTML
        • Convert PDF URL to Text
        • Group Keywords into Clusters
      • B2B Enrichment
        • Hunter.io
        • People Data Labs
      • CMS Integrations
        • Webflow
        • WordPress
        • Shopify
        • Contentful
        • Sanity
        • Strapi
      • Analytics Integrations
        • Google Search Console
      • Collaboration Integrations
        • Gmail
        • Google Docs
        • Google Sheets
        • Notion
        • Slack
    • Testing and Iteration
    • Publishing and Versioning
  • Running Workflows
    • Run Once
    • Run in Bulk (Grid)
    • Run via API
    • Run via Trigger
      • Incoming Webhook Trigger
      • Zapier
    • Run on a Schedule
    • Error Handling
  • Grids
    • Create a Grid
      • Import from Webflow
      • Import from Wordpress
      • Import from Semrush
      • Import from Google Search Console
    • Add Columns in the Grid
    • Run Workflows in the Grid
      • Add Workflow Column
      • Run Workflow Column
      • Map Workflow Outputs
      • Review Workflow Run Metadata
    • Review Content in the Grid
      • Review Markdown Content
      • Review HTML Content
      • Compare Content Difference
    • Publish to CMS from Grid
    • Pull Analytics in the Grid
    • Export as CSV
  • Copilot
    • Chat with Copilot
    • Edit Workflows with Copilot
    • Fix Errors with Copilot
  • Monitoring
    • Task Usage
    • Analytics
    • Alerts
    • Execution History
  • Your Workspace
    • Create a Workspace
    • Folders
    • Settings
    • Billing
    • Use your own LLM API Keys
    • Secrets
    • Team and Permissions
  • Chat Agents (Legacy)
    • Agent Quick Start
    • Chat Agents
    • Integrate Agents
      • Widget
      • Client Web SDK
  • About
    • Ethical AI and IP Production
    • Principles
    • Security and Compliance
Powered by GitBook
On this page
  • Review a Single Item
  • What is a Single Item?
  • How to Configure a Single Item
  • Review Multiple Values
  • What is are Multiple Values?
  • How to Configure Multiple Values
  • Referencing the Human Review Step
  • How to Reference a Single Item
  • How to Reference Multiple Values
  • Review Session
  • How to Review Output
  • Review in the Test Panel
  • Review in Real-Time when Running Once
  • Review Asynchronously in the History

Was this helpful?

  1. Building Workflows
  2. Workflow Steps
  3. Flow

Human Review

Require Human Review of outputs before continuing a workflow

Last updated 3 months ago

Was this helpful?

With the Human Review step, the user can be prompted to review, validate, and edit a text value (Single Item) or select and edit multiple values (Multiple Values) before continuing a workflow.

For example, you could create a list of 5 blog titles for a user to select from, ask the user to review and select the titles to publish with a review step, and finally publish the selected content to your blog.

Review a Single Item

What is a Single Item?

The single item allows the user to edit the text from a single-line text box:

How to Configure a Single Item

  1. Label the item: the label will automatically create the variable name associated with your label. In the example below, we label our item "Blog Title", which also created the variable blog_title

  2. Assign the value of the item: use Liquid syntax to pass the value that you want the user to edit and review. In the example below, this is {{step_2.output}}

  3. (Optional) Notify a Slack channel: choose a Slack channel which will notify users to review the output

Review Multiple Values

What is are Multiple Values?

Multiple values allow the user to select and edit multiple values at once:

How to Configure Multiple Values

  1. Set up a list of options:

    1. Generate a list: use an LLM step to generate a list of items, it must be an Array

    2. Label the item: the label will automatically create the variable name associated with your label. In the example below, we label our item "Blog Titles", which also created the variable blog_titles

    3. Assign the value of the item: use Liquid syntax to pass the list you generated in Step 1. In the example below, this is {{step_2.output}}

    4. (Optional) Notify a Slack channel: choose a Slack channel which will notify users to review the output

Referencing the Human Review Step

How to Reference a Single Item

To reference a single item from the Human Review step, use the variable corresponding to the label you provided.

In this example, we named the item "Blog Title" which created the variable {{step_3.output.blog_title}} :

How to Reference Multiple Values

To reference multiple values from the Human Review step, use the variable corresponding to the label you provided.

However, unlike referencing a single item, the output of a multiple value review is a list:

In other words, {{step_3.output.blog_titles}} from the example above gives the user a list of blog titles. If you want to reference only the first blog title, you would need to modify your syntax to {{step_3.output.blog_titles[0]}}.

Review Session

When a workflow reaches the review step, it pauses the execution, leaves the workflow in a pending state for review, and creates a review session where the user can review the content.

How to Review Output

  • For single items, you can edit the content using markdown syntax.

  • For multiple values, you can edit the values and select/unselect them.

  • After editing you can either choose to accept the reviewed content, or cancel the execution.

Review in the Test Panel

As you test your workflow, you can access the review session by clicking on "Review":

Review in Real-Time when Running Once

When you Run Once, the review session will automatically appear, and your user can review the outputs in real-time:

Review Asynchronously in the History

To review executions asynchronously, you can review them in the History tab:

  1. Click on History to view all executions

  2. Filter the Status to Review needed

  3. Click on View in the Actions column

  4. Click on Review to review the output and continue the execution

Single Item Review
Single Item Configuration
Multiple Values Review
A list of 5 blog titles
Multiple Values Configuration
Referencing a Single Item
Referencing Multiple Values
Review in the test panel
Review when running once
Review from the history tab