Agent Studio / Guides / Blocks
← Home
Studio Guide

Workflow building blocks

Blocks

A workflow is a collection of blocks connected together to automate a process. This page describes every block in the block library: what it does, how to configure it, and when to use it.

1.Overview

Where to find blocks and how every block's settings panel is laid out.

Open the Blocks panel to see the blocks grouped by category. Search by name to find a block quickly. To add, move, rename, duplicate, test or delete a block, see Understand workflows.

Select a block on the canvas to open its configuration panel. Every block's panel has the same layout:

Parameters
The block's settings. Each block's parameters are described on this page.
Output
The data the block produced the last time it ran.
Describe what this block should do
Describe the block's behavior in plain language, then select Configure. Studio fills in the block's parameters for you to review.
Notes
Notes about the block for you and your team. They are not used when the workflow runs.
Test Block and Run Workflow
Run only this block, or run the whole workflow.

2.Block Categories

53 blocks in 9 categories. Select a block to jump to it.

3.Flow

Flow blocks control how a workflow starts, how it receives files, and what it returns.

Block Flow

Trigger

The entry point of the workflow. It receives input from a chat message, a manual run, or a schedule and passes it to the next block.

Configuration

Trigger Type
Select how the workflow starts: Chat Message, Manual or Scheduled.
Schedule
Used only when the Trigger Type is Scheduled. Select Every N minutes, Daily at a time or Custom (cron).
Run every (minutes)
Used with the Every N minutes schedule. The minimum is 1.
Daily run time (UTC, HH:MM)
Used with the Daily at a time schedule. Enter the time in 24-hour format, in UTC, for example 09:00.
Cron expression
Used with the Custom (cron) schedule. Enter a standard 5-field cron expression in UTC, in this order: minute, hour, day-of-month, month, day-of-week. For example, 0 8 * * 1 runs every Monday at 08:00 UTC.

Note

All schedule times use UTC, not your local time. Convert your local time to UTC before you enter it. Scheduled runs start only after the workflow is deployed and active.

Use cases

  • Start an assistant whenever a user sends a chat message.
  • Run the workflow by hand while you build and test it.
  • Send a daily report at a fixed time, such as 09:00 UTC.
  • Check a service every few minutes, such as every 5 minutes.
  • Run a weekly task with a cron expression, such as every Monday morning.

Block Flow

Output

The final output of the workflow. It returns the response to the user.

Configuration

Output Type
Select the kind of response the workflow returns: Message, JSON, Template or File Download.
Filename
Used with File Download. The default file name for the download, for example result.csv. An upstream block can override it.
MIME Type
Used with File Download. The type of the file, for example text/csv, application/json or text/plain.
Place the Output block at the end of the workflow, after the block that produces the final result.

Output types

Message
Returns a text response to the user.
JSON
Returns the result as structured data.
Template
Returns text built from a template, filled in with values from earlier blocks.
File Download
Returns a file the user can download.

Use cases

  • Return an AI Agent answer to the user in chat.
  • Return structured data for another system to read.
  • Let the user download a file that the workflow created.

Block Flow

File Upload

Receives a file attached in the chat. It supports PDF, DOCX, PPTX, CSV, JSON, plain text and more, and passes the extracted text to the next block.

Configuration

Required
If enabled, execution fails when no file is attached. Disable it to make the file optional.
File Slot Label
The human-readable name shown in the chat input, for example 'Job Description', 'Resume' or 'Sales CSV'.
Parse As
How to interpret the uploaded file content: Auto-detect, Plain text / Document (PDF, DOCX, …), PDF, CSV, JSON or Image / Scan (OCR via vision).
File limits
One file can be attached, up to 50 MB.

Use cases

  • Let users attach a contract or report and ask the AI Agent questions about it.
  • Collect a resume for screening.
  • Read text from a scanned page or image using Image / Scan (OCR via vision).
  • Upload a CSV and pass its contents on for analysis.

4.AI & LLMs

AI & LLMs blocks add AI reasoning, language and media generation to a workflow. Several of them share the same Provider and Model settings.

Shared settings AI & LLMs

Provider and Model settings

The Text Classifier, Summarizer, Parameter Extractor and Evaluator blocks use the same two settings to choose the AI model for that step.

Provider
Which model provider the step uses: Default model, Azure OpenAI, OpenAI, Anthropic, Google Gemini, OpenRouter, Groq, DeepSeek, Mistral, Ollama (local) or Custom (OpenAI-compatible). 'Default model' is the platform's Azure model. To use any other provider, first add it with its connection on the Model providers page. Its models then become available to select.
Model
Which chat model the step uses. With the default Azure model, choose Provider default, gpt-4o or gpt-4o-mini. For Azure, the model is a deployment. If you leave it as Provider default, the step uses the model saved with the provider.

Block AI & LLMs

AI Agent

Your AI step. In Simple mode it answers a prompt. In Agent mode it reasons, uses tools and searches a knowledge base. Model credentials are managed centrally, so you don't enter them in the block.

Configuration

Behavior (Role, Goal, Instructions)
Describe who the agent is (Role), what it should achieve (Goal) and how it should behave (Instructions). Select Generate to have these written for you from a short description. The incoming message is the task the agent works on.
Model
The model the agent uses. The default is the platform's Azure model. You can also choose gpt-4o or gpt-4o-mini. To use models from other providers, first add the provider with its connection on the Model providers page.
Mode
Simple gives one prompt and one answer; tools and knowledge stay switched off. Agent reasons over several steps and can call tools, connectors and a knowledge base.
Response format
In the Output Format section. How the agent's final answer is shaped: Text, JSON or HTML.
Example outputs
Sample questions and answers that steer the agent's tone and format, for example "Q: What's your return policy? A: 30 days, no questions asked."
File as output
Also offer the answer as a downloadable file.
Knowledge
Select an existing knowledge base, or create a new one, then select Use this knowledge base. Choose None to answer without retrieval. Knowledge is used only in Agent mode.
Reference textOptional
Paste reference text as a quick, keyword-only alternative. It is ignored when a knowledge base is selected. Semantic search with citations comes from a knowledge base.
Tools
Add the tools the agent can use, such as searching for information. Tools are used only in Agent mode.
Use Scratchpad
Lets the agent save values to the workflow's scratchpad so later blocks can use them. Turn it on, then tell the agent in its Instructions what to save, for example "Store the customer ID under the key customer_id." The IF/ELSE block's Scratchpad Value mode reads these keys.
Skills
Reusable know-how, such as a house style, a scoring rubric or a code snippet, that you write once and attach to any agent. Create a skill in Build → Skills, or select Add skill in the agent's Skills section to create one and attach it straight away. A new skill has these fields:
  • Name: A name for the skill.
  • Description (optional): A short summary of what the skill is for.
  • Kind: Prompt for plain instructions or knowledge, which are folded directly into the agent's system prompt. Code snippet for reference code the agent reads as an example; the code is not run.
  • Language (optional): The programming language of a Code snippet.
  • Content: The instructions or code.
  • Select Save skill to create the skill. You can then attach it to any agent.
Automation
Run the agent on a schedule, or start it with a trigger.
Features
Optional capabilities you can turn on, listed below. Select View All to see the full list. PII masking and Groundedness are Responsible AI safety checks that make the agent safer and more accurate.

Features you can add

Memory
Remembers context across turns.
PII masking
Redacts emails, phones and SSNs.
Groundedness
Checks answers against sources.
Reflection
One self-review pass before replying.
Clarify first
Asks questions before answering.
Data Query
Answers from your knowledge bases.
Voice
Human-like voice responses. Coming soon.
Global Context
Workspace-wide shared context. Coming soon.

Use cases

  • Answer a question or draft text from a single prompt in Simple mode.
  • Build an assistant that looks things up, calls tools and searches a knowledge base before it answers in Agent mode.
  • Summarize or classify text that comes from File Upload, PDF Extractor or Web Search.

Block AI & LLMs

Text Classifier

Sorts a piece of text into one or more categories that you define.

Configuration

CategoriesRequired
A JSON array of category names or objects, for example [{"name":"urgent","description":"..."}].
Input Text Field
The field that contains the text to classify.
Allow Multiple Categories
Enabled by default. Allows more than one category to be selected.
Custom Instructions
Additional instructions added to the classification prompt.
Provider and Model
See Provider and Model settings.

Use cases

  • Sort support requests by topic before routing them.
  • Tag customer feedback as praise, complaint or question.
  • Mark messages as urgent or not urgent, then use an IF/ELSE block to send each category down a different path.

Block AI & LLMs

Summarizer

Condenses text into a summary in the style you choose.

Configuration

Style
Concise (2-3 sentences), Detailed (full paragraph), Bullets (key points), Executive (findings + actions), Headline (1 line) or Custom prompt.
Input Text Field
The field that contains the text to summarize.
Focus Instruction
Optional. Tell the summary what to focus on, for example 'focus on financial risks' or 'highlight action items'.
Max Words
An approximate word limit for the summary. 0 uses the style default.
Output Language
The language of the summary.
Custom System Prompt
Used when the style is Custom prompt.
Provider and Model
See Provider and Model settings.

Use cases

  • Summarize a long report that a user uploads.
  • Write a one-line headline for each article in a list.
  • Create an executive summary with findings and actions for a meeting.

Block AI & LLMs

Parameter Extractor

Extracts specific values from text and returns them as named parameters.

Configuration

ParametersRequired
A JSON array where each item has name, type, required and description. The type can be string, number, boolean, array or object.
Input Text Field
The field that contains the text to extract from.
Extra Instructions
Optional guidance added to the extraction prompt.
Provider and Model
See Provider and Model settings.

Use cases

  • Pull a name, date and amount out of an email.
  • Read key fields from a message so a later block can use them.
  • Collect details a user mentions in chat, such as an order number.

Block AI & LLMs

Evaluator

Uses an LLM as a judge to evaluate an output against defined criteria. It returns a score, a pass or fail result, and feedback. The evaluation result can be used with workflow logic to decide whether the output should be accepted or regenerated.

Configuration

CriteriaRequired
Defines what a good output looks like. This is the rubric used to grade the output.
Pass Threshold
The minimum score, from 0 to 100, required for the evaluation to pass. There is no default, so enter the threshold your use case needs.
Field to Evaluate
The input field that contains the text to evaluate.
Provider and Model
See Provider and Model settings.

Use cases

  • Check an AI Agent's response against defined criteria before it is sent to the user.
  • Connect the Evaluator's result to an IF/ELSE block. If the evaluation fails, route the workflow back to the AI Agent to create a new response, then send the new response through the Evaluator again.
  • Evaluate responses against specific requirements, such as accuracy, tone, completeness or relevance.

Block AI & LLMs

Image Generation

Creates an image from a text description using Azure OpenAI (DALL-E). The generated image can then be used in your workflow or shown to the user through a supported output.

Configuration

PromptRequired
A description of the image to create. {{message}} inserts the incoming text as the prompt. This is the user's chat message, or a description written by an earlier block such as an AI Agent. Use {{field}} tokens to add other values from earlier blocks.
Size
Square 1024×1024, Landscape 1792×1024 or Portrait 1024×1792.
Quality
Standard or HD. HD is slower and costs more.
Image deployment
The Azure image deployment name. It defaults to dall-e-3 and must exist on the resource.

Use cases

  • Create an illustration from a description a user types in chat.
  • Generate a visual for a post or a report.

Block AI & LLMs

Text to Speech

Turns text into spoken audio, such as narration or voice messages.

Configuration

Text to speakRequired
The words to turn into speech. {{message}} inserts the text produced by the previous block, such as a summary written by an AI Agent. Use {{field}} tokens to add other values from earlier blocks.
Voice
Alloy, Echo, Fable, Onyx, Nova or Shimmer.
Audio format
MP3, WAV, OPUS, AAC or FLAC. MP3 suits most uses; use WAV for telephony.
Speed
From 0.25 to 4.0. 1.0 is normal.
Speech deployment
The Azure deployment name for the speech model. It defaults to tts and must exist on the resource.

Use cases

  • Read an AI-written summary aloud as narration.
  • Create a voice message from a text reply.
  • Produce WAV audio for a phone system.

Block AI & LLMs

Knowledge Write

Stores text in a knowledge base so later runs and other agents can search it.

Configuration

Knowledge Base
The knowledge base to write into. Pick an existing one, or use Manage to manage your knowledge bases.
Text to store
The text to save in the knowledge base. {{message}} inserts the text produced by the previous block, such as a summary or a report. Use {{field}} tokens to add other values from earlier blocks.
Source name
A label for where the text came from, for example a filename or URL. It is shown with search results and used by Replace existing.
Replace existing
Disabled by default. When enabled, it removes anything previously stored under the same source name before writing, so a re-run updates the entry instead of duplicating it.

Use cases

  • Save a generated summary so other agents can search it later.
  • Keep a document up to date by re-running the workflow with Replace existing enabled.
  • Build up a knowledge base from the results of a workflow.

5.Logic

Logic blocks control the path a workflow takes, pause it, reuse it, or protect the data in it.

Block Logic

IF/ELSE

Routes the workflow based on conditions. It supports field comparison, a scratchpad value from an LLM block, Python expressions, and a multi-branch switch mode.

Configuration

Mode
Choose how the condition is checked: Field Comparison (IF/ELSE), Scratchpad Value (LLM output), Python Expression (IF/ELSE) or Switch / Multi-branch. The other settings change with the mode.

Field Comparison mode

Field
The dot-notation path to the value to check, for example data.status.
Operator
Equals, Not Equals, Greater Than, Less Than, Contains, Not Contains, Is Empty, Is Not Empty, Starts With or Ends With.
Value
The value to compare against.

Scratchpad Value mode

Scratchpad Key
The key an upstream AI Agent saved to the scratchpad, for example ats_analysis. The AI Agent must have Use Scratchpad turned on and be told in its Instructions to save this key.
Field in JSON
The dot-path to the field inside the JSON object, for example score. Leave it blank to compare the whole value.
Operator
>= (greater or equal), > (greater than), <= (less or equal), < (less than), = (equals), ≠ (not equals) or contains.
Threshold / Value
The value to compare against, for example 70.

Python Expression mode

Python Condition
A Python expression or multi-line code. Set result=True or result=False. input_data is the upstream output.

Switch / Multi-branch mode

Field to Match
The dot-notation field path whose value is matched against the cases.
Cases (JSON)
A JSON array of {value, handle} pairs, for example [{"value":"billing","handle":"billing"},{"value":"tech","handle":"tech"}]. Each case creates an output handle with that name.
Default handle
Always available on the block; you don't declare it in Cases. Values that match no case go here. Drag a connection from the default handle to the block that should handle them. With the example above, "billing" goes to the billing handle, "tech" to the tech handle, and "sales" to default.

Use cases

  • Send a request to a different AI Agent depending on its category.
  • Stop early when a required value is missing.
  • Take one path for approved requests and another for rejected ones.

Block Logic

Loop

Iterates over an array. Downstream blocks process each item. The loop_results field in the output collects the results of every iteration.

Configuration

Array Field
The dot-notation path to the array in the upstream output, for example items or data.rows.
Max Iterations
A safety cap. The default is 50 and the maximum is 500.
Items at a time
How many items to process at the same time, from 1 to 20. The default is 4. Items are independent, so a higher number finishes a large batch faster. Set it to 1 to process strictly one at a time. Lower it if the model provider starts rate-limiting.

Use cases

  • Send a personalized email for every row in a list.
  • Run an AI Agent on each document in a set.
  • Call an API once for each record.

Block Logic

Merge

Combines the outputs of several upstream blocks into one result, so the next block works with a single combined output. Use it after parallel branches or several searches or queries. The Merge block waits until every upstream branch that ran has finished, then passes on the combined result. If a branch doesn't run because an IF/ELSE or Switch sent the workflow down another path, Merge does not wait for it. Text messages from all branches are always joined together, so the next AI block sees everything.

Configuration

Merge Strategy
Controls how the other fields from each branch are combined.
Connect the outputs of the parallel branches to the Merge block, then connect the Merge block to the block that should receive the combined result.

Merge strategies

Merge (last-writer wins)
Combines everything into one object. For example, {"name": "A"} and {"score": 10} give {"name": "A", "score": 10}. If two branches return the same field, such as status, the value from the branch that finished last is kept.
Prefix keys with source ID
Keeps both values by adding the source block's internal ID to each field name, for example {"agent_1791202143546.message": "...", "formula_1791202867316.result": "..."}. The prefix is the block's ID, not its display name. Useful when you want to compare branch results.
Collect as array
Keeps each branch's result as a separate item in a list, for example [{"status": "pending"}, {"status": "complete"}]. Best when later blocks should process every result.

Use cases

  • Run a web search and a knowledge base search in parallel, then pass both results to one AI Agent.
  • Combine the results of several branches into a single report.

Block Logic

Delay

Pauses workflow execution for a set amount of time. It is useful for rate limiting and backoff.

Configuration

Seconds
Seconds to wait. This is added to any minutes, hours or days you set.
Minutes, Hours, Days
Each is added to the wait.
Log MessageOptional
An optional message to include in the block output.

Note

Waits over 5 minutes suspend the run and resume it later, so a 30-day wait costs nothing while it waits.

Use cases

  • Stay under an API rate limit when calling a service inside a Loop.
  • Wait before retrying a request that failed.
  • Wait several days before sending a follow-up message.

Block Logic

Set Variables

Stores named values in the workflow context. Use {{field}} to capture upstream outputs.

Configuration

Variables (JSON object, required)
A JSON object of variable names and values. Values support {{field}} interpolation.
Mode
Set replaces all existing variables with these ones. Merge adds these variables and keeps the existing ones. Clear wipes all variables, then sets these ones.

Use cases

  • Save a value once and reuse it in later blocks.
  • Capture a user's name from the start of the workflow to use in a message at the end.

Block Logic

Sub-Workflow

Executes another workflow as a reusable component. Use it to build modular agent pipelines.

Configuration

Workflow IDRequired
The ID of the workflow to call. Open that workflow in the editor and copy the ID from the address bar. For example, in https://<your-studio>/workflows/550e8400-e29b-41d4-a716-446655440000 the ID is 550e8400-e29b-41d4-a716-446655440000. Copy only the ID, not the full URL.
Input MappingOptional
A JSON object that maps the sub-workflow's inputs from the parent output, for example {"text": "{{message}}"}. Leave it blank to pass all output as-is.
Timeout (seconds)
The maximum time to wait for the sub-workflow to complete, from 5 to 600.
On Error
What to do if the sub-workflow fails: Fail (stop execution) or Continue (return error in output).

Use cases

  • Reuse a "clean and validate data" workflow in several workflows.
  • Split a long pipeline into smaller workflows that are easier to maintain.

Block Logic

Human Approval

Pauses the workflow so a person can approve, edit or reject before it continues. It is a human-in-the-loop gate.

Configuration

Title
A short label for the reviewer.
What to review
Tell the reviewer what to check before approving.
The approval request goes to the admin who built the workflow. Pending requests appear under Approvals in the Builder toolbar. The reviewer can approve, edit or reject.
After approval, the workflow continues. If the reviewer edits the content, the edited content continues through the workflow. Until the request is approved, the workflow does not move forward. Requests do not time out.

Use cases

  • Review an AI-written email before Send Email sends it.
  • Approve a data change before it runs.

Block Logic

PII Redact

Masks personal data in text, such as emails, phone numbers, SSNs, credit cards and IP addresses. It is a safety guardrail: place it before an AI block or an output to keep sensitive data out of prompts and logs.

Configuration

Field to scrub
Which field of the upstream output to redact. The default is message.
PII types
A comma-separated list of the kinds to redact: EMAIL, PHONE, SSN, CREDIT_CARD and IP_ADDRESS. All five are redacted by default.

Use cases

  • Remove personal details from a customer message before an AI Agent reads it.
  • Mask sensitive values before a response is shown or logged.

Block Logic

Validator

Checks input fields against rules such as required fields, minimum or maximum length or value, patterns, allowed values, email addresses, URLs and numeric values.

Configuration

Validation Rules (JSON)
A JSON array of rule objects. Each rule has type, field, label and value.
Rule types
required, min_length, max_length, min_value, max_value, regex, one_of, not_contains, is_email, is_url and is_numeric.
Failure Message
A custom message shown when validation fails. If you leave it blank, the message is generated from the errors.
is_valid
true when the input passes every rule, false when it fails. Use it when another block needs to check the result as a field, for example in an IF/ELSE block.
Routing
Connect the block's True Branch Output to the path for valid input and its False Branch Output to the path for invalid input. To make a field-based decision instead, check is_valid in an IF/ELSE block.

Use cases

  • Check that a form has a valid email address before saving it.
  • Reject empty or malformed input before it reaches an AI Agent.
  • Check a user's email address, send valid input on to the next step, and send invalid input to a step that asks the user to correct it.

6.Data

Data blocks clean, reshape, calculate and convert data as it moves between blocks.

Block Data

Data Transform

Transforms, filters, sorts, groups, reshapes and maps data between blocks.

Configuration

Operation
Passthrough, Extract Field, Map Fields (rename), Template ({{field}} substitution), Merge (add extra fields), Filter Rows, Sort Rows or Group By + Aggregate.
Field Path / Template
For Extract Field, a dot-notation path such as data.items. For Template, a string with {{field}} placeholders.
Mapping / Filter Config (JSON)
The settings for the operation you chose:
  • Map fields: {"newName": "source.path"}
  • Filter rows: {"field": "status", "op": "eq", "value": "active"}. Operators: eq, ne, gt, gte, lt, lte, contains, not_contains, startswith and regex.
  • Sort rows: {"field": "revenue", "order": "desc"}
  • Group by: {"field": "category", "agg_field": "revenue", "agg": "sum"}
  • Merge: {"newField": "value"}, the extra fields to add to the data.

Use cases

  • Keep only the rows that meet a condition.
  • Sort a list by date or value.
  • Rename fields so the next block receives the format it expects.

Block Data

JSON Extractor

Extracts, reshapes, filters or flattens JSON data. It is well suited to parsing API responses before passing them to an LLM or Output block.

Configuration

Operation
Extract fields (multi-field, with rename), Pick keys (keep only listed top-level keys), Single field (extract one value), Flatten nested object or Filter array items. The other settings change with the operation.

Extract fields

Fields to Extract (JSON)
A JSON array of {path, as, default} items. The path uses dot-notation, and as is the name of the output key.

Pick keys

Keys to Keep
A comma-separated list of top-level keys to keep, for example title, author, date.

Single field

Field Path
The dot-notation path to the single value to extract, for example response.data.items.0.title.
Default Value
The value to use if the field is not found.

Flatten nested object

Key Separator
The character that joins nested key names. For example, _ turns response.data.title into response_data_title.

Filter array items

Array Field Path
The dot-notation path to the array to filter, for example data.results or rows.
Filter Field
The field name inside each array item to filter by, for example status or category.
Filter Value
Keep only items where the filter field equals this value.
Max Items
Limit results to this many items. 0 means no limit.

Use cases

  • Pull a few fields out of a large HTTP Request response.
  • Flatten nested JSON before writing it to a spreadsheet.

Block Data

Formula

Evaluates math expressions or string templates using input field values. In a math expression, write field names from the upstream block directly, without braces, for example (revenue - cost) / revenue * 100. In a string template, insert values with {{field}}, for example Order {{order_id}} is {{status}}. It supports +, -, *, /, round(), sqrt(), min(), max() and conditional expressions such as "A" if margin_pct > 30 else "B".

Configuration

Expression
A single math expression or string template. Use field names from the upstream block, for example (revenue - cost) / revenue * 100.
Output Field Name
The name of the field in the output for the single expression result.
Multiple Calculations (JSON)
A JSON array for several outputs, for example [{"name": "margin_pct", "expression": "(revenue-cost)/revenue*100"}, {"name": "grade", "expression": "\"A\" if margin_pct > 30 else \"B\""}]. Later entries can use the results of earlier ones.

Use cases

  • Calculate a total, tax or discount.
  • Work out a margin percentage and grade it.
  • Build a text string from several fields.

Block Data

Aggregate

Computes sum, average, minimum, maximum, count, stats, group-by, or plucks values from arrays.

Configuration

OperationRequired
Sum, Average, Minimum, Maximum, Count, Full Stats, Group By, Count By, Flatten, Unique Values or Pluck Field.
  • Count: Counts the items in the input array.
  • Flatten: Combines nested lists into a single list.
  • Group By: Groups items by the value of the Group-By Field.
  • Count By: Counts the items for each value of the Group-By Field.
Field
The dot-notation field to aggregate, for example order.total. Required for Sum, Average, Minimum, Maximum, Unique Values and Pluck Field. Count and Flatten do not need a Field.
Input Array Field
The field that contains the array to aggregate. If not set, the block looks for rows, items or data automatically.
Group-By Field
The field to group items by, for the Group By and Count By operations.

Use cases

  • Total the amounts in a list of invoices.
  • Count records per category.
  • Pull one field from every item in an array.

Block Data

Deduplicate

Removes duplicate items from an array by a key field or by deep equality.

Configuration

Key Field
The dot-notation field used to decide whether items are the same, for example id or email. Leave it blank to compare whole items (deep equality).
Input Array Field
The field that contains the array to deduplicate. If not set, the block looks for rows, items or data automatically.
Keep
Which item to keep when duplicates are found: Keep first occurrence or Keep last occurrence.

Use cases

  • Remove repeated email addresses before sending a message.
  • Clean a list that came from several sources.

Block Data

Batch Processor

Splits a large array into fixed-size chunks. Connect a Loop block after it to process each batch.

Configuration

Batch SizeRequired
The number of items per batch, from 1 to 1000.
Input Array Field
The field that contains the array to split. If not set, the block looks for rows, items or data automatically.
Include Batch Metadata
Enabled by default. Wraps each batch with batch_index, batch_total and batch_size.

Use cases

  • Send 1,000 records to an API in groups of 50.
  • Keep each AI request small by splitting long lists.

Block Data

CSV

Parses CSV text into structured rows, or generates CSV from an array of objects.

Configuration

OperationRequired
Parse (text → rows) or Generate (rows → text).
CSV Text Field (parse)
The field that contains the CSV text to parse.
Data Array Field (generate)
The field that contains the array of objects to convert to CSV.
Delimiter
The column separator. Use \t for tab-separated data.
Has Header Row
Enabled by default. Whether the first row of the CSV is a header (parse mode).
Column Names (no header)
Comma-separated column names to use when the CSV has no header row.
Include Header (generate)
Enabled by default. Includes column headers in the generated CSV.
Max Rows
The maximum number of rows to parse. 0 means no limit.

Use cases

  • Read an uploaded CSV as rows.
  • Export a list of records as CSV text.

Block Data

Regex Extractor

Extracts, matches, splits or replaces text using regular expressions.

Configuration

Regex PatternRequired
A Python regular expression, for example \b[\w.-]+@[\w.-]+\.\w+\b for email addresses.
Input Field
The dot-notation path of the field to extract from. The default is message.
Mode
First match, All matches, Capture groups, Split on pattern or Replace.
Flags
A comma-separated list: ignorecase, multiline, dotall.
Replacement (replace mode)
The replacement string. Use \1 or \g<name> for group references.
No-Match Value
The value to output when no match is found.

Use cases

  • Find order numbers or dates in free text.
  • Split text on a pattern.
  • Replace unwanted characters.

Block Data

Date & Time

Performs date and time operations: get the current time, format, parse, add or subtract durations, find a difference, and compare.

Configuration

OperationRequired
Now, Format date, Parse date, Add duration, Subtract duration, Difference, Compare, To Unix timestamp or From Unix timestamp.
Input Date Field
The field path that contains the date string. Used for every operation except Now.
Second Date Field
The field path of the second date, for Difference and Compare.
Input Format
A strptime format string, for example %d/%m/%Y. Leave it blank to auto-parse ISO 8601.
Output Format
A strftime format string. Leave it blank for ISO 8601 output.
Amount (add/subtract)
The number of units to add or subtract.
Unit (add/subtract)
Seconds, Minutes, Hours, Days, Weeks, Months or Years.
Diff Unit
The unit for the difference result: Seconds, Minutes, Hours or Days.
Timezone
The time zone the block uses when it processes dates and times, as an IANA name such as Asia/Kolkata or America/New_York. If you leave it blank, the block uses UTC. Set it when the workflow depends on a particular location.

Use cases

  • Add the current date to a report.
  • Calculate a due date 14 days from now.
  • Compare two dates.

Block Data

Text Template

Renders dynamic text with Jinja2. Use {{ field }}, filters, loops and conditionals.

Configuration

TemplateRequired
A Jinja2 template. All input fields and workflow variables are available.
Output Field Name
The name of the field in the output that holds the rendered text.
Strip Whitespace
Enabled by default. Trims leading and trailing whitespace from the rendered result.

Use cases

  • Build a personalized email body.
  • Format a list of items into a readable message.

Block Data

PDF Extractor

Extracts text from PDF files. It accepts file paths or base64-encoded content.

Configuration

File PathOptional
The location of the PDF file you want the block to read. If provided, this file is used instead of the PDF supplied through the input field.
Input FieldOptional
The field that contains a file path or base64 PDF data. It is detected automatically if left blank.
Pages
The pages to extract: all, 1, 1-5 or 1,3,5 (1-indexed).
Clean Text
Enabled by default. Normalizes whitespace and removes excessive line breaks.
Max Characters
Truncates the output text to this many characters. 0 means no limit.
This block extracts text from PDFs that contain selectable text. Scanned, image-only PDFs may return little or no text.

Use cases

  • Read a PDF from storage and pass its text to an AI Agent.
  • Extract only the first few pages of a long document.

Block Data

Write Document

Turns text into a real Word, PDF or Excel file that people can open.

Configuration

Format
Word (.docx), PDF (.pdf) or Excel (.xlsx). Use Word when the document will be edited further, PDF when it is final and going to someone, and Excel for tabular data.
Content
What goes in the file. For Word and PDF, # Heading and - bullet become real headings and bullets. For Excel, use CSV or JSON rows.
Filename
For example board-pack.docx. The extension is corrected to match the format.
Document title
For Word and PDF. Becomes the title at the top of the document.
Sheet name
For Excel only. The name of the worksheet tab.
The block creates the file but does not show it to the user. To let the user download it, connect the block to an Output block with Output Type set to File Download. You can also send the file elsewhere, for example as an email attachment or a Google Drive upload.

Use cases

  • Turn an AI Agent report into a Word file.
  • Create a PDF summary to send to someone.
  • Export results as an Excel file.

Block Data

Database Query

Runs SQL queries against a SQLite database.

Configuration

SQL QueryRequired
The query to run. Use named placeholders such as :customer_id for values that change.
Database Path
The path to the SQLite .db file. Required when there is no default shared database connection.
Parameters (JSON)
The value for each placeholder in the query, for example {"customer_id": "{{customer_id}}"}, so you do not write values directly into the SQL. Values can come from earlier blocks. Required when the query contains placeholders; leave it empty when it has none.

Use cases

  • Look up a customer record.
  • Fetch rows to pass to an AI Agent.

7.Integration

Integration blocks connect a workflow to outside services, websites and messaging channels.

Block Integration

HTTP Request

Makes HTTP requests to external APIs and services.

Configuration

Method
GET, POST, PUT, PATCH or DELETE.
URLRequired
The address to call. Use {{variable}} for template variables from the input.
Headers (JSON)
The request headers.
Body (JSON)
The request body.
Fail on 4xx/5xx
Enabled by default. Treats HTTP error responses as a block failure instead of passing the error body downstream. This is recommended.
Verify TLS certificate
Enabled by default. Validates the server's HTTPS certificate. Turn it off only for trusted internal endpoints with self-signed certificates.

Use cases

  • Fetch data from a REST API.
  • Send a record to another system.

Block Integration

Send Email

Sends an email through SMTP. It supports Gmail, Outlook, Yahoo or a custom SMTP server.

Configuration

Email Provider
Gmail (App Password), Outlook / Office 365, Yahoo Mail or Custom SMTP. Choose Custom SMTP to enter your own server details.
SMTP Host
The SMTP server, for example smtp.gmail.com. Leave it blank if you chose a preset provider.
SMTP Port
Usually 587 (TLS) or 465 (SSL).
Use TLS (STARTTLS)
Enabled by default. Encrypts the connection with STARTTLS. This is recommended.
Email UsernameRequired
Your email address, for example you@gmail.com.
Password / App PasswordRequired
Stored in the workflow. For Gmail, generate an App Password at myaccount.google.com/apppasswords.
From Address
The sender address shown to the recipient. It defaults to the username if left blank.
To (Recipients)Required
The recipient email addresses. Separate several with commas.
Subject
The email subject. Use {{field}} to insert values from previous blocks.
Body
The email body. Use {{field}} placeholders. If left blank, the block uses the message field from upstream.
Body Format
Plain text or HTML.

Use cases

  • Email a generated report to a team.
  • Send a confirmation after a form is processed.
  • Send an AI-written reply after a person approves it.

Block Integration

Send SMS

Sends the result as a text message to a mobile number through Twilio.

Configuration

To (mobile number)Required
The recipient in international format, for example +447700900123. Leave it blank if the number is not known yet.
Message
The text message to send. {{message}} inserts the text produced by the previous block, such as an alert or a short status update. Keep it short, because long messages are split into several texts.
From (your number)
The Twilio number to send from.
Provider
Twilio.
Account SID
Stored in the workflow.
Auth Token
Stored in the workflow.
Test connection
Checks that the connection is correct and working.

Use cases

  • Text an alert when a workflow finds a problem.
  • Send a short status update.

Block Integration

Place Voice Call

Rings a phone number and speaks a message aloud. The call is one-way and uses Twilio.

Configuration

To (phone number)Required
The number to call, in international format, for example +447700900123. Leave it blank if it is not known yet.
What to say
The words spoken aloud to whoever answers. {{message}} inserts the text produced by the previous block. Keep it short, because people hang up.
From (your number)
The Twilio number to call from.
Voice
Alice, Man or Woman.
Provider
Twilio.
Account SID and Auth Token
Stored in the workflow.
Test connection
Checks that the connection is correct and working.

Use cases

  • Call an on-call person about an urgent alert.
  • Read out a short notification.

Block Integration

Read Web Page

Signs in to a website that has no API and reads pages out of it. It only reads: it does not click buttons or run JavaScript, so it works on traditional server-rendered portals, not on single-page apps such as Salesforce.

Configuration

Page addressesRequired
One address per line. They can also come from the previous step.
Sign-in page
The login page you would open in a browser to sign in. The block loads this page, fills in the sign-in form and submits it. Leave it blank for pages that need no sign-in.
Username and Password
The sign-in details, stored in the workflow. Enter the account's password. If the site's login form accepts an API key in place of a password, you can enter the key here instead.
Username field name
The form input's own name attribute. View the sign-in page's source to check it. Wrong names are the usual reason sign-in appears to work but returns nothing.
Password field name
The name attribute of the password input on the sign-in form. Check the sign-in page's source, as you do for the username field name.
Other form fields
JSON, for forms that need more than a username and password, for example {"clinic_id": "42"}.
Maximum pages
A safety cap of up to 25 pages.
Test connection
Checks that the connection is correct and working.

Use cases

  • Read a status table from an older supplier portal.
  • Collect information from a site that offers no API.

Block Integration

Browser Steps

Drives a real browser through a site that has no API: click, fill and submit, then read the result. You write the steps; it does not improvise, so it needs selectors and breaks if the site's markup changes.

Configuration

Start at
The address that is opened before the steps run.
StepsRequired
A JSON list of steps, run in order. Supported steps:
  • {"goto":"https://…"} opens a page.
  • {"fill":"#user","value":"…"} fills in a field.
  • {"click":"text=Send"} clicks an element.
  • {"select":"#stage","value":"Won"} chooses an option.
  • {"wait_for":"#done"} waits for an element, and {"wait_ms":500} waits for a set time.
  • {"extract":"#total","as":"total"} reads a value, and {"screenshot":true} takes a screenshot.
Timeout (seconds)
A limit for the whole run, from 5 to 300. A hung page fails the step rather than holding the worker.

Use cases

  • Fill in and submit a form on a site with no API.
  • Click through a portal and read the result.

Block Integration

Send to Slack

Posts the result into a Slack channel, through an Incoming Webhook or a bot token.

Configuration

Message
The text to post in the channel. {{message}} inserts the text produced by the previous block, such as a daily summary.
Incoming Webhook URL
Stored in the workflow. The simplest option: messages go to the channel the webhook was created for.
Channel
For example #ops. Required when you use a bot token. With a webhook, messages always go to the webhook's channel, so this field usually has no effect.
Bot token
Stored in the workflow. An alternative to a webhook. It needs the chat:write permission.
Post as
Overrides the display name. Webhooks only.
Test connection
Checks that the connection is correct and working.

Use cases

  • Post a daily summary to a team channel.
  • Notify a channel when an approval is needed.

8.Code

The Code block lets you run your own logic when no other block fits.

Block Code

Python Code

Runs custom Python code. Read the input through input_data and set the output variable for results.

Configuration

Python CodeRequired
The code to run. Use input_data for the input and set output for the result.

Use cases

  • Run a calculation that the Formula block cannot do.
  • Reformat data in a way the Data blocks do not support.

9.Output

The Output category contains blocks that display results.

Block Output

HTML Renderer

Displays HTML output (from an LLM block) as a live visual inside its block on the canvas. It is well suited to KPI dashboards, charts and reports. The rendered view appears on the canvas and in the run preview. Users see it only if the workflow sends the HTML to them, for example through an Output block.

Configuration

This block has no parameters.
Connect it after an AI block that produces HTML.

Use cases

  • Show a KPI dashboard created by an AI Agent.
  • Preview a chart or report layout directly on the canvas.

10.Microsoft

Microsoft blocks work with Microsoft 365 services through the Microsoft Graph API.

Shared settings Microsoft

Connect your Microsoft account

All five Microsoft blocks connect through an Azure app registration (app-only authentication) and use the same connection fields. They are stored in the workflow.

Tenant IDRequired
The Microsoft Entra ID directory (tenant) ID. Find it in the Azure Portal under Microsoft Entra ID → Overview.
Client IDRequired
The application (client) ID from your App Registration.
Client SecretRequired
The client secret value from your App Registration, under Certificates & secrets.
Test connection
Checks that the connection is correct and working.

Block Microsoft

Excel Online

Reads or writes data in Microsoft Excel workbooks through the Microsoft Graph API.

Configuration

Workbook Drive Item IDRequired
The DriveItem ID of the Excel file, from OneDrive or SharePoint.
User ID / UPN
The owner of the file, for example user@contoso.com. Required for app-only authentication. It addresses /users/{id}/drive.
Drive IDOptional
The target drive ID, such as a SharePoint document library. It takes precedence over the User ID.
Table Name
The Excel table to append to. Required for Append Rows.
Action
Read Range, Write Range, Append Rows or List Sheets.
Sheet Name
The worksheet tab name, for example Sheet1. Not required for List Sheets.
Range (A1 Notation)
For example A1:D100. Required for Read Range and Write Range.
Values (2-D Array)
A JSON 2-D array of values to write, for example [["Name","Sales"],["Alice",100]]. Required for Write Range and Append Rows. For Append Rows, include at least one row.

Use cases

  • Add a new row to a workbook for every completed request.
  • Read a table from a workbook for analysis.

Block Microsoft

SharePoint

Lists sites, reads and uploads files in document libraries, and reads, creates and updates SharePoint list items.

Configuration

Action
List Sites, List Drive Items, Get / Download File, Upload File, List List Items, Create List Item or Update List Item.
Site ID
The SharePoint site ID from the Graph API. Required for all actions except List Sites.
Drive ID
The drive ID within the site. Required for file actions.
File Path (relative)
For example Documents/report.xlsx. Required to get a file.
List ID (GUID)
The SharePoint list GUID. Required for list item actions.
List Item ID
The integer ID of the list item. Required to update an item.
Fields (JSON object)
Key-value pairs for the list item, for example {"Title":"Q1 Report","Status":"Active"}.
Upload File Name
The destination file name on SharePoint. Required to upload a file.
File Content (base64)
The base64-encoded file bytes. The maximum is 4 MB. Required to upload a file.

Use cases

  • Fetch a policy document from a library for an AI Agent to read.
  • Add an item to a SharePoint list when a request is submitted.

Block Microsoft

OneDrive

Lists, downloads, uploads and manages files in Microsoft OneDrive.

Configuration

User ID / UPN
The drive owner, for example user@contoso.com. Required for app-only authentication. It uses /users/{id}/drive.
Drive IDOptional
The target drive ID. It takes precedence over the User ID.
Action
List Items, Get / Download File, Upload File, Delete File or Create Folder.
Folder Path
A relative path, for example Documents/Reports. Leave it empty for the root.
File Path
The full relative path of the file. Required for Get and Delete.
File Name
The destination file name. Required for Upload.
File Content (base64)
The base64-encoded file bytes. The maximum is 4 MB. Required for Upload.
New Folder Name
The name of the folder to create. Required for Create Folder.

Use cases

  • Save a generated Word or PDF report to OneDrive.
  • Download a file for processing.

Block Microsoft

Outlook Mail

Sends, reads and manages Outlook and Microsoft 365 emails through the Graph API.

Configuration

Mailbox User (UPN or ID)
The mailbox to act on, for example user@contoso.com. Required. You can enter any mailbox the app registration has permission to access.
Action
Send Email, List Messages, Get Message, Move Message or Delete Message.
To (recipients)
Comma-separated email addresses. Required for Send Email.
Subject
The subject line. Required for Send Email.
Body
The email body, as HTML or plain text. Required for Send Email.
Body Type
HTML or Plain Text.
CC and BCC
Comma-separated addresses.
Mailbox Folder
The folder name for List Messages, for example inbox or sentitems.
Message ID
The Graph message ID. Required for Get, Move and Delete.
Destination Folder ID
A folder ID or well-known name. Required for Move Message.

Use cases

  • Read incoming messages and sort them with an AI Agent.
  • Send a summary email from a Microsoft 365 account.

Block Microsoft

Microsoft Teams

Posts messages to channels and chats in Microsoft Teams through the Graph API.

Configuration

Action
Send Channel Message, Send Chat Message, List Teams or List Channels.
User ID / UPN
Required for List Teams under app-only authentication. It lists that user's joined teams.
Team ID
The Microsoft Teams team ID. Required for channel actions.
Channel ID
The channel ID within the team. Required for Send Channel Message.
Chat ID
The chat thread ID. Required for Send Chat Message.
Message
The message body, as HTML or Markdown. The maximum is 28 KB.
Importance
Normal, Important or Urgent.

Use cases

  • Post a workflow result to a team channel.
  • Send an alert to a chat.

11.Google

Google blocks work with Google Workspace services through Google APIs.

Block Google

Google Sheets

Reads, writes and appends data in Google Spreadsheets through the Sheets API v4.

Configuration

Access Token
Stored in the workflow. An OAuth 2.0 bearer token with the spreadsheets scope. It expires after about an hour, so you can use a Service Account JSON instead. Enter either an Access Token or a Service Account JSON; one of the two is required.
Service Account JSON
Stored in the workflow. Paste a Google service-account key and share the sheet with its client_email. It creates tokens automatically, so there is no manual refresh.
Spreadsheet ID
The long ID from the Google Sheets URL. Not required for Create Spreadsheet.
Action
Read Range, Write Range, Append Rows, Clear Range, List Sheets, Create Spreadsheet or Add Sheet Tab.
Spreadsheet Title
Required for Create Spreadsheet.
Sheet Name
The tab name, for example Sheet1. For Create Spreadsheet it is the first tab's name (default Sheet1). For Add Sheet Tab it is the new tab's name. Not required for List Sheets.
Range (A1 Notation)
For example A1:D100. Required for Read, Write and Clear.
Values (2-D Array)
For example [["Name","Sales"],["Alice",100]]. Required for Write and Append.
Value Input Option
User Entered (parse formulas) or Raw (exact values).
Test connection
Checks that the connection is correct and working.

Use cases

  • Append a row each time a form is processed.
  • Read a list of customers from a sheet.

Block Google

Google Drive

Lists, downloads, uploads, shares and manages files in Google Drive.

Configuration

Access TokenRequired
Stored in the workflow. An OAuth 2.0 bearer token with the drive or drive.file scope. It expires after about an hour and must then be replaced. The drive.file scope only reaches files the app created or was given access to, so List, Get and Share won't see your other files; use the drive scope for those.
Action
List Files, Get / Download File, Upload File, Delete File, Create Folder, Move File or Share File.
File ID
The Google Drive file ID. Required for Get, Delete, Move and Share.
Folder ID
The parent folder ID. Leave it empty for the My Drive root.
File Name
The destination file name. Required for Upload.
File Content (base64)
The base64-encoded file bytes. The maximum is 5 MB. Required for Upload.
MIME Type
The MIME type of the uploaded file.
New Folder Name
Required for Create Folder.
New Parent Folder ID
The target folder ID. Required for Move File.
Share With (email)
The email address of the person to share with.
Share Role
Viewer, Commenter or Editor.
Search QueryOptional
A Drive query string, for example name contains 'report'.
Test connection
Checks that the connection is correct and working.

Use cases

  • Save a generated report to a shared folder.
  • Download a file for an AI Agent to read.

Block Google

Google Calendar

Lists, creates, updates and deletes events, and checks availability through the Google Calendar API v3.

Configuration

Access Token
Stored in the workflow. An OAuth 2.0 bearer token with the calendar scope. It expires after about an hour, so use a Service Account JSON for workflows that run unattended. Enter either an Access Token or a Service Account JSON; one of the two is required.
Service Account JSON
Stored in the workflow. Paste a service-account key and share the calendar with its client_email.
Action
List Events, Create Event, Update Event, Delete Event or Check Availability.
Calendar ID
Defaults to primary, the connected account's own calendar.
Event ID
Required for Update and Delete.
Title
The event title. Required for Create.
Description and Location
Optional event details.
Start (ISO 8601) and End (ISO 8601)
For example 2026-03-05T14:00:00. Required for Create.
Timezone
An IANA time zone, for example America/Los_Angeles.
Attendees
Comma-separated email addresses.
Window Start (ISO 8601) and Window End (ISO 8601)
Required for List Events and Check Availability.
Search QueryOptional
Filters events by text.
Max Results
The maximum number of events to return. The maximum is 250.
Calendar IDs (for availability check)
Comma-separated. Defaults to the Calendar ID above.
Test connection
Checks that the connection is correct and working.

Use cases

  • Create a meeting after a request is approved.
  • Check availability before suggesting a time.

Block Google

Gmail

Sends, reads, searches and manages Gmail messages through the Gmail API v1.

Configuration

Access TokenRequired
Stored in the workflow. An OAuth 2.0 bearer token. It expires after about an hour and must then be replaced. The scope depends on the action: gmail.send for Send Email; gmail.readonly for List, Get, Search and Get Attachment; and gmail.modify for Trash Message and Label / Unlabel Message.
Action
Send Email, List Messages, Get Message, Search Messages, Trash Message, Label / Unlabel Message or Get Attachment.
To (recipients)
Comma-separated email addresses. Required for Send.
Subject
The email subject. Required for Send.
Body (HTML)
The email body as HTML. Required for Send.
From Alias
An optional display name for the From field.
CC and BCC
Optional recipients.
Attachments (JSON)
Optional, for Send. A JSON array, for example [{"filename":"report.pdf","content_base64":"...","mime_type":"application/pdf"}]. The maximum is 20 MB combined.
Message ID
The Gmail message ID. Required for Get, Trash, Label and Get Attachment.
Attachment ID
From a previous Get Message call's attachments list. Required for Get Attachment.
Search Query
Gmail search syntax, for example from:boss@corp.com is:unread. Required for Search.
Label IDs
Comma-separated Gmail label IDs. Required for the Label action.
Label Action
Add Labels or Remove Labels.
Max Results
The maximum number of messages to return. The maximum is 500.
Test connection
Checks that the connection is correct and working.

Use cases

  • Search a mailbox for a customer message.
  • Send a reply written by an AI Agent.