Components in an Agent Builder

Components, also referred to as nodes, are the building blocks in an Agent Builder flow.

This section explains when to use each node, their inputs and outputs, and how to configure them to reliably build your flows.

Common data types across nodes include:

• Message: A string, typically human-readable
• JSON: A Python dict or list used for structured data
• DataFrame: A list[dict] suitable for table-like flows

Core Orchestration

LLM

The LLM node executes prompts using a Large Language Model configured in LLM Management. This node serves as the primary reasoning and completion engine for many flows.

When to use?

• To generate, summarize, or transform text
• To perform reasoning on inputs based on provided instructions
• As a foundational component for Agent nodes

How to add and configure?

1. Drag the LLM node onto the canvas.
2. Choose a configured model from LLM Management.
3. Supply prompts or instructions via an upstream Prompt or Message node.
4. Set the temperature to a low value for more predictable and deterministic responses from the LLM, or to a high value for more varied and creative output.
5. Connect the output Message as input to Agent, Output, or Processing components per the flow logic.

Inputs:

• Message (prompt)
• Optional JSON or context as a Message

Outputs:

• Message: The model’s response text
• JSON: If the model response is valid JSON, it can be parsed downstream by the Type Convert node

Agent

An Agent node uses an LLM configured in LLM Management to carry out instructions, answer questions, and orchestrate complex multi-step tasks using hierarchical manager/worker orchestration and sub-agents.

When to use?

• For multi-step tasks that require tool calls, planning, or delegation
• In manager/worker scenarios where a coordinator Agent assigns tasks to sub-agents
• When tool-enabled reasoning is needed such as search, APIs, or debugging tools

How to add and configure?

1. Drag the Agent node onto the canvas.
2. Select a base LLM from LLM Management.
3. Optionally, attach relevant Tools.
4. Optionally, connect other Agent nodes to the Sub-agents connector to set up manager/worker orchestration.
5. Provide instructions through a Prompt or Message input.
6. Optionally, set the temperature to a low value for more predictable and deterministic responses from the LLM, or to a high value for more varied and creative output.
7. Connect the output Message as input to Agent, Output, or Processing components per the flow logic.

Inputs:

• Message (instructions)
• Optional JSON or tool configurations as needed

Outputs:

• Message: Agent result or summary
• JSON: Tool results or any structured output produced by the agent

Select AI

Use these nodes to design Select AI flows with components created in Utilities. See Configure Select AI Utilities for Your Database to learn how to set up your database with Select AI utilities, such as Profiles with RAG or NL2SQL.
Refer to Select AI Workflows for sample workflows created using Select AI nodes.

In-Database Agent

Use this node to choose an existing in-database agent or to create a new agent using a selected database and profile.

• Choose Existing Agent

  

  When to use?
  Use this mode when you need to select an existing AI Agent that has already been defined. This is helpful when you want to reuse an Agent with pre-configured database and profile settings in your Select AI flows.

  How to add and configure?

  1. Drag the In-Database Agent node onto the canvas.
  2. Select the Choose Existing mode.
  3. Select a database from the dropdown to filter the available agents.
  4. Pick an already defined Agent from the Select Agent dropdown.
  5. Click the View or Delete icons to view the Agent configuration or remove the Agent.

  Inputs: Task (Optional)

  Outputs: DB name, Agent name

• Create New Agent

  

  When to use?
  Use this mode when you need to create a new AI Agent to represent logic powered by a specific database context, profile (e.g., LLM, SQL), and task (optional) in your Select AI flows. Create a customized Agent for your database profile with a unique name, instructions, defined role, and other agent-specific settings.

  How to add and configure?

  1. Drag the In-Database Agent node onto the canvas.
  2. Choose the Create New mode.
  3. Enter a unique name for your new Agent.
  4. Select a database from the dropdown to provide the context for the Agent.
  5. Select an AI profile (such as LLM or SQL) to define the Agent’s capabilities.
  6. Optionally, attach an existing Task to associate with the Agent.
  7. Define the Agent Role to specify metadata or role context.
  8. Optionally, add a description to provide additional notes about the Agent.

  Inputs: Task (Optional)

  Outputs: DB name, Agent name

Select AI

When to use?
Use the Select AI node when you need to perform an AI-driven action, such as chat, run SQL, or other supported interactions, within a specific database and profile context. This node is ideal for executing discrete AI actions and retrieving results as part of your Select AI workflow. See Select AI Demos for sample workflows created for each action.

How to add and configure?

1. Drag the Select AI node onto the canvas.
2. Select the database to provide context for the action.
3. Select a profile from the dropdown to link the node to the desired profile, or click the Create Profile icon at the bottom of the node to create a new profile.
4. Choose the specific AI Action you want to perform (e.g., Chat, Run SQL, ShowSQL, ExplainSQL, Narrate, Show Prompt).
5. Enter the prompt or message to be sent to the AI model for processing. You can supply prompts or instructions via an upstream Prompt or Message node.
6. Click the View or Delete icons to view the profile or delete the profile.

Inputs: Message (prompt)

Outputs: LLM/Action Result

In-Database Task

Use this node to choose or define a in-database task. You can create new tasks using one or more connected tools or select from available ones.

• Choose Existing Task

  

  When to use?
  Use this mode when you need to select an existing Task that has already been defined. This is helpful when you want to reuse a Task with pre-configured tools, database connections, and logic in your Select AI flows.

  How to add and configure?

  1. Drag the In-Database Task node onto the canvas.
  2. Choose the Choose Existing mode.
  3. Select a database from the dropdown to filter available tasks and tools.
  4. Pick an already defined Task from the Choose Task dropdown.
  5. Click the View or Delete icons to view the Task configuration or remove the Task from your flow.

  Inputs: None

  Outputs: DB Name, Task name

• Create New Task

  

  When to use?
  Use this mode when you need to create a new task to define and orchestrate logic using specific tools and database connections within your Select AI flows. This option is suitable when you want a customized Task with a unique name and chosen tool set.

  How to add and configure?

  1. Drag the In-Database Task node onto the canvas.
  2. Choose the Create New mode.
  3. Enter a unique name for your new task.
  4. Provide a prompt with the instructions for your task.
  5. Optionally, add a description to provide additional information about the task.

  Inputs: None

  Outputs: Task

In-Database Team

Use the In-Database Team node when you need to orchestrate multiple AI agents to work together as a team within a defined database context. This is useful for workflows that require collaborative or sequential agent actions, either by selecting an existing team or creating a new one with custom settings.

• Choose Existing Team

  

  When to use?
  Use the Choose Existing mode to select an existing team in your workflow.

  How to add and configure?

  1. Drag the In-Database Team node onto the canvas.
  2. Select the Choose Existing mode.
  3. Select the database to provide the context for the team’s operations.
  4. Pick from a list of predefined teams.
  5. Enter the prompt or message to be sent to the AI model for processing. You can supply prompts or instructions via an upstream Prompt or Message node.
  6. Click the View or Delete icons to view the team or delete the team.

  Inputs: Message (prompt)

  Outputs: Team LLM output result

• Create New Team

  

  When to use?
  Use the Create New mode to create a new in-database team.

  How to add and configure?

  1. Enter a unique team name.
  2. Choose a process type—either Sequential or Parallel, for agent execution.
  3. Attach available agents to the team.
  4. Configure a team-level prompt if required. You can supply prompts or instructions via an upstream Prompt or Message node.
  5. Optionally, add a description to provide additional notes about the Agent.

  Inputs:

  • Agent
  • Message (prompt)

  Outputs: Team LLM output result

In-Database Tool

Use this node to define or select a tool—such as RAG, SQL, or database functions—bound to a specific database, profile, or function. You can create new tools by type or select from available ones.

• Choose Existing Tool

  

  When to use?

  Use this mode when you need to select an existing tool—such as RAG, SQL, or database functions—that is already bound to a specific database, profile, or function.

  How to add and configure?

  1. Drag the In-Database Tool node onto the canvas.
  2. Select the Choose Existing mode.
  3. Select a database from the dropdown to fetch the available tools.
  4. Pick an already defined tool from the Choose Tool dropdown.
  5. Click the View or Delete icons to view or delete the selected tool.

  Inputs: None

  Outputs: DB name, Tool name

• Create New RAG Tool

  

  When to use?
  Use this mode when you need to create a new RAG tool for your existing profile. See Create Profile to create one.

  How to add and configure?

  1. Drag the In-Database Tool node onto the canvas.
  2. Choose the Create New mode and select RAG as the tool type.
  3. Enter a unique name for your RAG tool.
  4. Select a database from the dropdown to connect the tool to the desired DB context.
  5. Choose an existing RAG profile to define how the tool retrieves and augments content.
  6. Optionally, add a description to provide additional information about the tool.

  Inputs: None

  Outputs: DB name, Tool name

• Create New SQL Tool

  

  When to use?
  Use this mode when you need to create a new SQL tool for your existing profile. See Create Profile to create one.

  How to add and configure?

  1. Drag the In-Database Tool node onto the canvas.
  2. Choose the Create New mode and select SQL as the tool type.
  3. Enter a unique name for your SQL tool.
  4. Select a database from the dropdown to connect the tool to the desired database context.
  5. Choose an existing SQL profile to define the tool’s execution behavior.
  6. Optionally, add a description to provide additional information about the tool.

  Inputs: None

  Outputs: DB name, Tool name

• Create New DB Functions Tool

  

  When to use?
  Use this mode when you need to create a new database function (DB Function) tool.

  How to add and configure?

  1. Drag the In-Database Tool node onto the canvas.
  2. Choose the Create New mode and select DB Functions as the tool type.
  3. Enter a unique name for your DB Function tool.
  4. Select a database from the dropdown to connect the tool to the desired database context.
  5. Choose the required database function from the available list.
  6. Optionally, add a description to provide additional information about the tool.

  Inputs: None

  Outputs: DB name, Tool name

Tools

Bug Tools

The Bug Tools node is a specialized component for interacting with your organization’s bug or issue trackers.

When to use?

• To query bugs, create updates or comments, or retrieve triage information
• To automate bug lifecycle processes within an Agent flow

How to add and configure?

1. Drag the Agent node (or another compatible node that supports tool calls) onto the canvas.
2. Attach Bug Tools in the Agent’s Tools configuration.
3. Provide the required credentials or configuration for your bug tracking system.
4. Use prompts or instructions within your Agent to invoke Bug Tools.

Inputs: Tool parameters supplied by Agent prompts or upstream data

Outputs: Message summaries or structured JSON results returned by the tool

• Be explicit in your prompts by specifying which bug ID(s) to query or update.
• Use the Parser or Type Convert node to format tool JSON output for display.

Calculator

Calculator tool evaluates mathematical expressions safely and returns the computed result. The node supports arithmetic operations, parentheses, and standard numeric functions.

When to use?

• To perform calculations within workflows.
• To compute totals, percentages, or derived values.
• To transform numeric data before sending it to an LLM.
• To evaluate formulas from user input or previous nodes.
• Common uses include:
  • totals and subtotals
  • tax or discount calculations
  • unit conversions
  • averages and ratios
  • dynamic formula evaluation

How to add and configure?

1. Drag the Calculator node into the workflow.
2. Enter a mathematical expression in the Expression field.
3. You can include:
   • numbers
   • operators
   • parentheses
   • values from previous nodes
4. Verify the expression syntax.

Inputs:

• Mathematical expressions
• Numeric values
• Variables from connected nodes

Outputs:

• Calculated result
• Evaluated numeric value

MCP Server

The MCP Server node integrates an MCP server to expose external capabilities as tools to Agents. It is a specialized component for interfacing with AI models using the Model Context Protocol (MCP) with Server-Sent Events (SSE) transport.

When to use?

• When you need to access custom tools or endpoints provided by your MCP server
• To extend Agent capabilities with organization-specific functions

How to add and configure?

1. Configure your MCP Server and build the server URL. See Build Your Own MCP Server.

2. Drag and drop an MCP Server node from the Tools category.

3. Select the MCP Server from the dropdown. See Add MCP Server to add and configure your MCP server.

4. Specify an optional timeout value, in seconds, after which the MCP Tool call will time out. This is applicable if the MCP Server tool call takes some time to receive a response. By default, the value is 45 seconds.

5. Connect the MCP Server node’s Tools output to downstream Agent nodes that consume the discovered MCP tools. Trigger tool usage through Agent prompts or tool-calling logic.

Inputs: Agent instructions and any necessary tool arguments

Outputs: JSON responses from MCP tools and message summaries generated by the Agent

• Validate the schemas and output structure of your tools.
• Use deterministic tool outputs to make downstream parsing easier.

See FAQs and Troubleshooting for MCP server related questions.

REST API Tools

The REST API node allows you to call REST APIs directly from your flows, often through an Agent.

When to use?

• To integrate with external services or internal microservices
• To retrieve or send data as part of your workflow

How to add and configure?

1. Configure REST API connection. See Add REST API Data Source.
2. Drag the REST API node onto the canvas and connect it to an Agent or any other compatible tool-enabled node.
3. Specify the endpoints, headers, authentication, and HTTP method (GET, POST, PUT, or DELETE).
4. Use Agent prompts to determine which endpoint and parameters to use.

Inputs: URL/endpoint and parameters or body data, often passed from previous node outputs

Outputs: JSON responses from the API and message summaries created by the Agent

• Use Type Convert to ensure the JSON response is in the expected format.
• Combine JSON outputs to merge multiple API responses for downstream use.

Select AI Bridge

Use the Select AI Bridge node to configure Select AI in either Profile mode or Team mode. The node outputs a Server tool with prompt-only input, and the tool name and description are personalized based on the selected profile or team information.

• Profile Mode

  

  When to use?
  Use the Select AI Bridge node in Profile Mode when you need to perform a specific AI-driven action—such as sending a prompt or running a database operation—within a defined workflow. This mode is ideal for executing discrete actions using a selected database and profile, and for obtaining an immediate result to advance your workflow.

  How to add and configure?

  1. Drag the Select AI Bridge node onto the canvas.
  2. Select Profile Mode.
  3. Choose the database to set the context for the action.
  4. Select a profile to specify the flow or agent context.
  5. Choose the desired AI Action you want the node to execute such as Run SQL, Show SQL, Explain SQL, Narrate, Chat, Show Prompt.
  6. Enter your prompt or query to send to the AI model.
  7. Click the View or Delete icon to manage the workflow node.

  Inputs: None

  Outputs: LLM/Action Result

• Team Mode

  

  When to use?
  Use the Select AI Bridge node in Team Mode when you want to coordinate and run workflows involving a team of agents. This mode is ideal for scenarios where team-based collaboration or multi-agent orchestration is needed, leveraging existing teams defined by name within a specific database context.

  How to add and configure?

  1. Drag the Select AI Bridge node onto the canvas.
  2. Choose Team Mode.
  3. Select the database to provide context for team operations.
  4. Select a team from the dropdown list by name.
  5. Enter a prompt or message to send to the team of agents for processing.
  6. Click the View or Delete icons to manage the workflow node as needed.

  Inputs: None

  Outputs: Team LLM output result

Text Combiner

The Text Combiner node combines two text inputs into a single output, optionally separated by a delimiter and is useful for merging strings, building prompts, or formatting content by joining values, adding labels or separators, and creating structured text (e.g., full names, sentences, headings, or CSV lines).

When to use?

• Merge text from multiple nodes into one message.
• Build prompts by joining dynamic values.
• Format outputs with separators, labels, or spacing.
• Create structured text like full names from first and last name, sentences from fragments, prompt context + user input, headings + content, or CSV-style lines.

How to add and configure?

1. Drag the Text Combiner node into your workflow.
2. Enter a delimiter (optional) such as a space, comma, newline, dash, or pipe.
3. Add text to Text 1 and Text 2, or connect outputs from previous nodes.
4. Leave the delimiter blank to join text directly.
5. Connect the combined output to the next node.

Inputs:

• Text strings
• Dynamic values from other nodes
• Multiline content

Outputs:

• Combined text string
• Formatted text with delimiter applied

Wikipedia Search

The Wikipedia search node searches Wikipedia and returns both structured JSON results and a human-readable text summary.

When to use?

• Retrieve reliable background information for prompts.
• Enrich LLM responses with factual summaries.
• Provide structured data for downstream parsing or RAG workflows.
• Search Wikipedia dynamically based on user input.

How to add and configure?

1. Drag Wikipedia Search from the Tools category into your flow.
2. Configure the fields:
   • Search Query (required): Text to search on Wikipedia
   • Language (optional, default: en): e.g., en, de, fr
   • Number of Results (optional, default: 4, range: 1–10)
3. You can enter a query directly or connect a Message output from an upstream node.
4. Connect outputs as needed:
   • JSON → parsing, filtering, RAG, or structured processing
   • Message → chat response, preview, logging, or LLM input

Inputs:

• Search Query (string, required)
• Language (string, default: en)
• Number of Results (integer, default: 4, range: 1–10)

Outputs:

• JSON Output:
  Returns a dictionary containing:

  {
    "results": [
      {
        "title": "...",
        "summary": "...",
        "url": "...",
        "snippet": "...",
        "language": "..."
      }
    ]
  }
  

  If an error occurs, JSON returns an error payload.

• Message Output: Formatted human-readable text including:

  • Title
  • Summary or snippet
  • Canonical URL

  If an error occurs, returns: Error: <description>

Inputs

Chat Input

Chat Input node captures conversational user input in a chat interface.

Note: A custom flow can contain a maximum of one Chat Input component.

When to use:

• For interactive flows where the user submits messages or questions
• To supply prompts or context to an LLM or Agent

How to add and configure:

1. Drag the Chat Input node onto the canvas.
2. Connect its Message output to downstream nodes such as Prompt, Agent, or LLM.

Inputs: None, as the user provides input at runtime

Outputs: Message containing the user’s text

• Use with the Agent node to pass instructions from Chat Input node as a Prompt.
• Use the Condition node to enable keyword-based branching in your flow.

Text Input

The Text Input node captures plain text input to pass to the next node.

When to use?

• For one-off values, such as IDs, categories, or thresholds
• To capture simple user parameters that influence the flow

How to add and configure?

1. Drag the Text Input node onto the canvas.
2. Optionally, set a label or placeholder for the input field.
3. Connect its Message output to downstream nodes.

Inputs: None, as input is provided by the user

Outputs: Message containing the entered text

Prompt

The Prompt node creates and formats textual instructions for an LLM or Agent, often combining fixed instructions with dynamic values from upstream nodes.

When to use?

• To centralize system instructions and role-based prompts
• To create templates that incorporate values from upstream nodes

How to add and configure?

1. Drag the Prompt node onto the canvas.
2. Write your instructions, optionally using placeholders to reference outputs from upstream nodes.
3. Connect the Prompt node to an LLM or Agent node.

Inputs: Message or JSON data for variable interpolation

Outputs: Message containing the final prompt text

Outputs

Chat Output

The Chat Output node renders or returns model/agent responses in a chat interface.

When to use?

• For chat interfaces intended for end users
• To display conversational responses in the user interface

How to add and configure?

1. Drag the Chat Output node onto the canvas.
2. Connect Message output from the LLM or Agent (or a formatted message from a Parser node) to the Chat Output node.

Inputs: Message

Outputs: None, as the response is rendered directly in the UI

Email Output

The Email Output node sends generated content via email. Accepts comma-separated email addresses and sends the generated content by email to multiple recipients.

When to use?

• To notify stakeholders by sending artifacts such as summaries, alerts, or reports
• To automate email communications within your workflows

How to add and configure?

1. Make sure SMTP is configured. See SMTP Configuration
2. Drag the Email Output node onto the canvas.
3. Provide a subject, specify recipients as comma-separated email addresses to send to multiple people, and connect the Message output from an upstream node to serve as the email body.
4. Optionally, attach any supported files using upstream file or data nodes.

Inputs:

• Recipient email(s)
• Email subject,
• Email body,
• Attachment content(optional),
• Attachment name (optional, default name: attachment.txt)

Outputs: None (the node sends the email)

Data

Read CSV File

The Read CSV node imports and parses CSV files for batch or tabular data processing.

When to Use?

• To import tabular data for analysis or reporting.
• To feed a DataFrame into a Parser or LLM node for summarization.

How to Add and Configure?

1. Drag the Read CSV node into your workflow.
2. Select or upload a CSV file.
3. Adjust delimiter and encoding settings if necessary.
4. Connect the node’s outputs to subsequent steps in your workflow.

Inputs: File path or uploaded CSV file

Outputs:

• DataFrame: A list of dictionaries list[dict], each representing a row
• JSON: An array of objects, if this format is provided

File Upload

The File Upload node allows users to upload files for processing or analysis.

When to Use?

• To import external documents or data into a workflow
• To use alongside parsing or data extraction steps

How to Add and Configure?

1. Drag the File Upload component into your flow
2. Select the file to upload
3. Connect the node to parsers, LLMs, or data converters

Inputs: None

Outputs: File handles/paths and/or Message/JSON, depending on integration

SQL Query

The SQL Query node executes SQL statements against configured databases and returns the results for use in workflows.

Note: Only SELECT-like queries are supported for security and governance.

When to use?

• To retrieve data for enriching prompts
• To enable further processing or visualization downstream

How to add and configure?

1. Ensure the database connection is set up. See Database Data Source.
2. Drag the SQL Query node into your workflow.
3. Enter your SQL query text. This can be static or parameterized using data from upstream nodes.
4. Connect the output to nodes such as Parser, Type Convert, or Combine JSON.

Inputs: Message or JSON containing the query and its parameters

Outputs:

• DataFrame: Tabular data results
• JSON: Array of row objects

URL to Markdown Content

The URL to Markdown Content node fetches data from one or more URLs accessible within the same network, provided they do not require authentication.

When to Use?

• Retrieve data from URLs to enrich prompts
• Summarize content from URLs using an LLM

How to Add and Configure?

1. Ensure the URLs are accessible on the application network.
2. Confirm that the URLs do not require authentication.
3. Drag the URL to Markdown Content node into your flow.
4. Add the URL(s) and connect the node to a Prompt node or LLM node.

Inputs: Single URL, comma-separated URLs, or a paragraph containing URLs

Outputs: Content from the URL page in Markdown format

Processing

Condition

The Condition node enables simple if-else decision logic in agent flows. Use condition node to compare a Text Input against a Match Text using operators. If the condition evaluates to true, it outputs a configurable true message and follows the “true” branch. If false, it outputs a false message and follows the “false” branch. You can use it for basic branching without complex orchestration.

When to use?

• Route flows based on keywords or user roles.
• Validate input values, such as numbers or specific formats.
• Gate actions before invoking tools or services.

How to add and configure?

1. Drag the Condition node onto the canvas.

2. Configure the following settings:
   • Text Input: The value you want to check.
   • Match Text: The value to compare against.
   • Operator: Choose from equals, not equals, contains, not contains, greater than, less than, or regex match.
   • True Message (optional): Message to return if the condition is met.
   • False Message (optional): Message to return if the condition is not met.
3. Connect the True and False outputs to their respective next steps.
4. Test the Condition node using sample inputs.

• equals / not equals: Checks for an exact match (case and spacing matter).
• contains / not contains: Useful for keywords.
• greater than / less than: Only works with numeric values.
• regex match: Matches text patterns using regular expressions (best for simple patterns).

Regex Extractor

The node extracts text from input using regular expressions (regex) to identify and return specific values such as emails, IDs, dates, URLs, or structured data fragments.

When to use?

• Extract structured data from unstructured text.
• Clean and transform text before sending it to an LLM.
• Parse logs, messages, HTML snippets, or API responses.
• Identify patterns such as:
  • Emails
  • Phone numbers
  • Dates
  • Order IDs
  • URLs
  • Key/value pairs

How to add and configure?

1. Ensure the input text contains the data you want to extract.
2. Drag the Regex Extractor node into your workflow.
3. Add the input text directly, or connect a node that outputs text.
4. Enter the desired regex pattern.

Inputs:

• Plain text
• Multiline text
• JSON or HTML as text
• Output from previous nodes

Outputs:

• All matches found
• Capture groups (if defined)
• Structured list of extracted values

Type Convert

The Type Convert node transforms data between message to string, JSON to dictionary or list, and dataframe to list of dictionaries for use by downstream nodes that require a specific structural type. It outputs all three types simultaneously, allowing downstream nodes to use whichever type they require.

Type Convert node supports robust JSON parsing from text:

• Detects and extracts the first valid JSON object or array found within the text (such as from code blocks or mixed content).
• Recursively parses nested JSON strings (for example, JSON fields that contain JSON data) to generate a structured output.

When to use?

• When downstream nodes require a specific data type:
  • Parser: Accepts JSON or DataFrame
  • Combine JSON: Accepts JSON only
  • LLM/Prompt/Chat: Requires Message format
• To standardize mixed input formats received from APIs, tools, or earlier steps

How to add and configure?

1. Drag and drop a Type Convert node from the Processing category.
2. Connect any of Message, JSON, or DataFrame from the upstream node as input.
3. Test the Type Convert node by connecting the output(s) - string, dictionary, or list of dictinories to appropriate downstream node(s). Execute the flow by selecting Playground.

Conversion Examples:

• Input: “Hello” Outputs: Message - “Hello”, JSON - {“value”:”Hello”}, DataFrame - [{“value”:”Hello”}]

• Input: ‘{“id”:1,”text”:”Hi”}’ Outputs: Message - string, JSON - {“id”:1,”text”:”Hi”}, DataFrame - [{“id”:1,”text”:”Hi”}]

• Input: ‘[{“id”:1},{“id”:2}] Outputs: Message - string, JSON - [{“id”:1},{“id”:2}], DataFrame - [{“id”:1},{“id”:2}]

Inputs: Message, JSON, or DataFrame

Outputs (provided simultaneously):

• String for Message. JSON string for JSON objects/arrays
• dict or list (Union[Dict,List]) suitable for Parser or Combine JSON Data
• list[dict] for table‑like flows

For example flows that use the Type Convert node together with the Parser and Combine JSON Data nodes, see Example Flows Using Combine JSON Data and Example Flow Using Parser.

• Use this node before Parser or Combine JSON to ensure the data is correctly formatted as JSON.
• If you expect arrays, check that the DataFrame output is a list of dictionaries (list[dict]).
• Keep the Message output concise if it will be used as input for prompts.

Combine JSON Data

The Combine JSON Data node merges multiple JSON payloads into a single object. It allows you to filter top-level keys and define how to resolve conflicts between keys. The node outputs both a JSON object and a Message containing the stringified JSON.

When to use?

• Combine results from multiple APIs or queries.
• Create a single JSON payload for downstream processing.

How to add and configure?

1. Drag and drop a *Combine JSON Data** node from the Processing category.

2. Connect one or more upstream JSON sources to the JSON inputs inlet.

3. Optionally, connect the output of a previous Combine JSON node to the Initial accumulator field for multi-stage merging. Leave it empty for a filter-only operation.

4. Input the top-level keys to include from input sources in the Keys to include field. Supported formats are a JSON array or a comma-separated list: ["a","b"], a, b, or a b. Leave it empty to include all the top-level keys.

5. Select the Merge mode from Deep or Replace. Use Deep merge to recursively extend lists, replace scalars, and combine keys from all JSONs. Use Replace mode to overwrite keys with values from the JSON of the last connected node to the JSON inputs inlet.

6. Test the Combine JSON node by connecting two or more JSON inputs to the JSON inlet and the stringified JSON or merged dictorionary JSON to a chat output node. Execute the flow by selecting Playground, typing a space in the Chat input, and pressing Enter.

Inputs: Multiple JSON or Message-with-JSON

Outputs:

• JSON: A merged object suitable for downstream nodes.
• Message: A stringified JSON for display or logging purposes.

Example Flows

Example 1: Using the Combine JSON Data Component in Deep Merge Mode:

The output JSON {"Title": "Final Report", "report": {"topics": ["Physics", "Maths", "Chemistry", "Biology"], "Date": "24/11/25", "other_details2": "Rainy weather"}, "other_key1": "Other Report"} includes only the keys specified in the ‘Keys to include’ field (report and other_key1) of the Combine JSON Data node. In Deep Merge mode, list values are combined for matching keys (key=topics), whereas scalar values (key=Date) are replaced.

The Initial Accumulator can be any JSON, with or without keys that overlap with the incoming JSONs and will appear in the final JSON output. Any matching key in the Initial Accumulator will be replaced by the incoming value in the final JSON output. In this example, the Initial Accumulator is {“Title”: “Final Report”}.

Example 2: Using the Combine JSON Data Component in Replace Merge Mode:

Description of the illustration combine-json-data-example-replace.png

The output JSON {"Title": "Final Report", "report": {"topics": ["Chemistry", "Biology"], "Date": "24/11/25", "other_details2": "Rainy weather"}, "other_key1": "Other Report"} includes the keys that were entered in the ‘Keys to include’ field (report and other_key1) of the Combine JSON Data Node. In Replace Merge mode, all the values for the same keys (key=topics) are replaced. The key value from the last input replaces the previous key values, so nodes connected later to Combine JSON Data overwrite those connected earlier.

The Initial Accumulator can be any JSON, with or without keys that overlap with the incoming JSONs and will appear in the final JSON output. Any matching key in the Initial Accumulator will be replaced by the incoming value in the final JSON output. In this example, the Initial Accumulator is {"Title": "Final Report"}.

Parser

The Parser node extracts, formats, and combines text from structured inputs, such as JSON or DataFrame. It transforms these inputs into a clean, readable message output that can be displayed or passed to downstream steps.

When to use?

• Convert SQL or API results into easily readable messages.
• Create lists from arrays, such as orders, tickets, or products.
• Quickly convert JSON to a string format for logging or debugging.

How to add and configure?

1. Drag and drop a Parser node from the Processing category .

2. Connect JSON or Message outputs from upstream nodes to the JSON or DataFrame inlet. Alternatively, input a JSON in the text box.

3. Input an optional dot-path in the Root path field to navigate into the input before applying template. Examples: records, records.0, outer.inner.items.

4. Select Mode from Parser or Stringify. The parser mode applies the template to each of the selected items or objects. The stringify mode ignores template and converts the selection(s) to a raw string.

5. Input Template for parser mode as a format string with placeholders referencing keys or columns from objects, or {text} for entire string inputs.

   Examples:

   • Name: {name}, Age: {age}
   • {PRODUCT_ID}: {PRODUCT_NAME} — stock {STOCK_QUANTITY}
   • Text: {text}

6. Enter a Separator which is a string used to join multiple rendered items when the input is a list. Default is \n.

7. Test the Parser node by connecting a JSON input to its JSON inlet and routing the output message to a chat output node. Execute the flow by selecting Playground.

Inputs: JSON or DataFrame

Outputs: Message containing the final rendered text

Example Flow

Below flow demonstrates grouping the Jira issues into a ‘Primary Group’ and storing the remaining Jira issues as ‘Remaining Jiras Primary’.

Description of the illustration parser-example.png

Using the following prompt, the LLM will generate a JSON with two keys - primary_groups and remaining_jiras_primary.

You are a JIRA analysis expert focusing ONLY on cluster-based grouping.

INPUT DATA: Problem Set:
<problem-set>
{{problem_set_data}}
</problem-set>

TASK: Group JIRAs based ONLY on cluster IDs.
STRICT RULES:
ONLY group by cluster ID matches
MANDATORY : EXACT cluster ID should match
MANDATORY : Each group MUST have minimum 2 JIRAs in the jira_list
If a group has fewer than 2 JIRAs, dissolve that group and ALL JIRAs from that group MUST be moved to remaining_jiras_primary
Order JIRAs chronologically within groups
DO NOT group by any other attributes
NO partial matches allowed
NO inferred relationships
VERIFY all groups meet the minimum 2 JIRAs requirement BEFORE outputting
DO NOT explain your reasoning or corrections
DO NOT output any intermediate results
MANDATORY: Use double quotes for ALL strings in JSON (not single quotes)
MANDATORY: Do NOT add “JIRA” prefix to any ID - use the exact ID format from the input data

OUTPUT FORMAT:
{{
    "primary_groups": [
        {{
            "title": "Cluster - <Full Cluster ID>",
            "summary": "Clear description of cluster impact",
            "jira_list": ["EXACSOPS-1", "EXACSOPS2-2"]
        }}
    ],
    "remaining_jiras_primary": ["EXACSOPS-3", "EXACSOPS-4"]
}}

CRITICAL INSTRUCTION: Return ONLY the final VALID JSON with proper double quotes for all strings. Do not include ANY explanations, reasoning, comments, corrections, or text of any kind outside the JSON structure. The response must begin with {{ and end with }} without any other characters.

Now, if you want to send the data in primary_groups directly for review and route remaining_jiras_primary through another round of analysis, you can use Parser nodes to parse the JSON generated by the LLM and extract data from two keys. This requires two Parser nodes. Select Playground to execute the flow.

Description of the illustration parser-example-output.png

You can use the two outputs from the two Parser nodes for different purposes in a complex workflow.

Utilities

Sticky Notes

The Sticky Notes node keeps track of important information or instructions within your flow.

When to use?

• Explain complex logic
• Give context to collaborators
• Add annotations for future reference

How to add and configure?

1. Drag the Sticky Notes node onto the canvas.
2. Click the note to edit its text.
3. Resize or move the note as needed.
4. Choose your preferred color.

Inputs: Raw text

Outputs: Not applicable