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
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 Search
Searches a knowledge base by meaning and returns the most relevant passages. It is standalone retrieval (RAG).
Configuration
- Knowledge Base
- The knowledge base to search. Select an existing knowledge base, or create a new one, then select Use this knowledge base.
- Query
- What to search the knowledge base for.
{{message}} inserts the incoming text, usually the user's chat message, as the search query. Use {{field}} tokens to add other values from earlier blocks. - Results
- How many passages to return.
- Search mode
- Vector (semantic) or Hybrid (semantic + keyword). Hybrid blends semantic similarity with BM25 keyword matching, which is better for exact terms, names and codes.
- Rerank results
- Enabled by default. Re-scores the top candidates with the LLM for higher precision. It is slower.
- Metadata filters (JSON)
- Search only chunks that match these tags, for example
{"dept":"hr"} or {"tier":{"$in":["gold","plat"]}}.
Use cases
- Retrieve policy passages and pass them to an AI Agent.
- Find exact product codes or names using Hybrid mode.
- Search only one department's documents with a metadata filter.
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
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
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
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
Web Search
Searches the live web and returns ranked results (title, URL and snippet). The provider is Tavily or Serper.
Configuration
- Query
- What to search the web for.
{{message}} inserts the incoming text, usually the user's chat message, as the search query. Use {{field}} tokens to add other values from earlier blocks. - Provider
- Tavily or Serper (Google).
- Results
- How many results to return.
- API Key
- The API key for the provider you selected.
Use cases
- Give an AI Agent up-to-date information.
- Research a topic before writing a summary.
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.