Azure Blob Storage (Beta)

Estimated reading: 11 minutes

The Azure Blob Storage component manages Azure Blob Storage containers, blobs, and virtual folders through a single component. It supports listing containers, listing blobs, uploading, downloading, checking whether a blob or folder exists, moving, copying, and deleting blobs, creating folders, retrieving metadata, and generating temporary SAS URLs. The available input fields change based on the selected operation.

The component connects to your Azure Storage account using the Account URL, Account Name, and Account Key to execute the selected operation, and it supports azure:// path syntax.

Prerequisites

Before configuring the Azure Blob Storage component, ensure you have the following:

a. An active Microsoft Azure Storage account.
b. A valid Account URL (for example, https://<storage-account-name>.blob.core.windows.net), Account Name, and Account Key (or SAS/connection credentials).
c. The necessary permissions (Read, Write, List, Delete) for the configured storage account key to perform the intended operation.
d. Target containers and blob paths that exist or are accessible to the configured account.

Note: Handle credentials securely. Do not expose Account Keys, Account URLs, or SAS tokens through Agent tool inputs, outputs, or logs.

Parameters

Parameter Description
Operation* Specifies the Azure Blob Storage operation to perform. Available operations include List Containers, List Blobs, Upload, Download, Exists, Move, Copy, Delete, Create Folder, and Get Metadata.
Account URL* Specifies the primary Blob service endpoint URL for your Azure Storage account, such as https://<account-name>.blob.core.windows.net. Required for all operations.
Account Name* Specifies the name of the Azure Storage account. Required for all operations.
Account Key* Specifies the access key used to authenticate requests to the Azure Storage account. Required for all operations. Keep this value secure.
Container Name Specifies the target Azure Blob Storage container. Displayed when List Blobs, Upload, Download, Exists, Delete, Create Folder, or Get Metadata is selected.
Prefix Filters results to return only blobs whose names begin with the specified prefix string, such as folder/ or folder/file. Displayed only when List Blobs is selected.
Blob Folder Path Specifies the destination virtual folder path inside the container where files are uploaded, such as invoices/2026/. Displayed only when Upload is selected.
Blob Path Specifies the full path of the target blob within the container, such as folder/subfolder/file.pdf or azure://container/folder/file.pdf. Displayed when Download, Exists, Delete, or Get Metadata is selected.
Folder Path Specifies the virtual folder path to create inside the target container. Displayed only when Create Folder is selected.
Source Container Name Specifies the container where the original blob is located. Displayed when Move or Copy is selected.
Source Blob Path Specifies the path of the original blob to be moved or copied. Displayed when Move or Copy is selected.
Destination Container Name Specifies the target container for the Move or Copy operation. Displayed when Move or Copy is selected.
Destination Blob Path Specifies the target blob path or new name for the Move or Copy operation. Displayed when Move or Copy is selected.
File Path(s) Specifies one or more server-side file paths of the files to upload. Enter each path on a separate line. Displayed only when Upload is selected.
Select File(s) Specifies the files selected for upload. Displayed only when Upload is selected.
Strategy for File Upload Specifies how files are uploaded. Store Data uploads parsed file content, while Store Original File uploads the original file without modifying its contents. Displayed only when Upload is selected.
Content Specifies text to save as file content, or connects a Message, Data, JSON, or DataFrame input when no file is provided. Displayed only when Upload is selected.
Content File Name Specifies the file name (without extension) used when saving Content as a file. Displayed only when Upload is selected.
Content File Extension Specifies the file extension to use when saving Content, such as csv, docx, html, json, pdf, txt, xlsx, or xml. Displayed only when Upload is selected.
File Type Specifies the file type associated with the download (default or kb). Displayed only when Download is selected.
List Max Results Specifies the maximum number of items to return when listing containers or blobs. The default value is 0, which returns all available results through continuation-token pagination.
List Include Folders Determines whether virtual folders/directories are included when listing blobs. Default: Disabled.

Disabled - Only individual blobs are returned; virtual folders/directories are omitted.
Enabled - Virtual folders/directories are included alongside blobs in the output.
Upload Overwrite Determines whether an existing blob is overwritten during Upload. Default: Enabled.

Disabled - Upload fails if the destination blob already exists.
Enabled - Existing blobs at the destination are overwritten.
Move Overwrite Determines whether an existing blob is overwritten during Move. Default: Enabled.

Disabled - Move fails if the destination blob already exists.
Enabled - Existing blobs are replaced and the source blob is removed after verification.
Move Recursive Determines whether all blobs within a virtual folder hierarchy are moved recursively. Default: Enabled.

Disabled - Only the specified blob is moved.
Enabled - All blobs within the specified folder hierarchy are moved.
Copy Overwrite Determines whether an existing blob is overwritten during Copy. Default: Enabled.

Disabled - Copy fails if the destination blob already exists.
Enabled - Existing blobs at the destination are overwritten.
Copy Recursive Determines whether all blobs within a virtual folder hierarchy are copied recursively. Default: Enabled.

Disabled - Only the specified blob is copied.
Enabled - All blobs within the specified folder hierarchy are copied.
Delete Recursive Determines whether all blobs under a virtual folder prefix are deleted recursively. Default: Disabled.

Disabled - Only the exact target blob is deleted.
Enabled - All blobs under the specified folder prefix are deleted recursively.

Note: Upload, Move, Copy, and Delete include optional overwrite and recursive parameters in the component’s Parameters panel to control how existing blobs and nested folders are handled.

Data Input Format and Upload Priority

When multiple upload inputs are provided, the component resolves the upload source in the following priority order:

Data / DataFrame / JSON → Input File Path → Select File

Supported Operations

Operation Description
List Containers Retrieves a list of all blob containers within the specified Azure Storage account.
List Blobs Lists blobs (and optionally virtual folders) inside a specified container, with support for prefix filtering, result limits, and automatic continuation-token pagination.
Upload Uploads data or files from Data/DataFrame/JSON, a local file path, or selected files to a specified container and blob folder path.
Download Downloads a specified blob from a container using its blob path and returns the local output file reference/path.
Exists Checks whether the specified path exists and identifies whether it represents a blob, container, or virtual directory.
Move Moves a blob from a source container and path to a destination container and path. The operation copies the blob to the destination and removes the source once the copy is verified.
Copy Copies a blob from a source container and path to a destination container and path while preserving the original blob.
Delete Deletes a specified blob, or recursively deletes blobs under a virtual directory, from a container.
Create Folder Creates a virtual folder path within a specified Azure Blob Storage container.
Get Metadata Retrieves normalized metadata for a specified blob, such as its name, size, content type, last-modified time, ETag, and custom metadata where available.

Outputs

The component provides outputs according to the selected operation and the result returned by Azure Blob Storage.

Output Description
Result Returns a standardized JSON envelope containing success, operation, path (where applicable), data, and message.
DataFrame Returns structured tabular results for operations that support this output, such as containers or blobs returned by List Containers and List Blobs.
Message Returns a formatted text message indicating the operation status, path, or error details.

The available output content depends on the selected operation. Use the relevant output when configuring subsequent workflow steps.

Configuration Notes

Using azure:// Paths

You can enter a blob location as separate Container Name and Blob Path fields, or as a single path in the format azure://<container>/<blob-path>.

Example: azure://claims/documents/2026/october/report.pdf resolves to Container claims and Blob Name documents/2026/october/report.pdf, using the configured Account URL.

Recursive Settings

Move Recursive and Copy Recursive are Enabled by default, so all blobs under a folder path are moved or copied. Delete Recursive is Disabled by default to prevent accidental bulk deletion. Enable it in the Parameters panel only when you want to delete an entire virtual folder.

Tool Mode

Tool Mode enables the Azure Blob Storage component to expose its supported container and blob operations as dedicated tools for an AI Agent. When enabled, the Agent sees only the operational inputs required for each action. Storage Account URLs, Access Keys, and other credentials are never exposed as tool parameters or returned in responses.

Available Actions

Action Description
azure_blob_upload Uploads data or a file (priority: Data/DataFrame/JSON → Input File Path → Select File) to a specified Azure Blob Storage location.
azure_blob_download Downloads a blob from a specified Azure Blob path and returns the local file reference/path.
azure_blob_delete Deletes a specified blob (supports optional recursive deletion, which defaults to false).
azure_blob_exists Checks whether a specified path exists and identifies whether it represents a blob, container, or virtual directory.
azure_blob_list Lists matching blobs and names within a container or prefix, handling continuation-token pagination automatically.
azure_blob_copy Copies a source blob to a destination path while respecting overwrite settings and verifying completion.
azure_blob_move Moves a blob from a source path to a destination path safely via verified copy-then-delete.
azure_blob_create_folder Creates a virtual folder representation at the specified Azure Blob Storage path.
azure_blob_get_metadata Retrieves normalized metadata (name, size, content type, last-modified time, ETag, and custom metadata) for a blob.

How Tool Mode Helps

When Tool Mode is enabled, the Agent can choose the appropriate Azure Blob Storage action or combine multiple actions to complete a task, without handling authentication parameters.

For example, it can check whether a path exists (azure_blob_exists) or inspect its metadata (azure_blob_get_metadata) before downloading or overwriting data, generate short-lived, permission-scoped SAS URLs for secure upload or download access, or move processed files to an archive folder (azure_blob_move) and chain multiple storage actions sequentially within a single agentic task.

Note: Toggle Tool Mode on in the component toolbar and configure valid Account URL, Account Name, and Account Key credentials so the Agent can authenticate with Azure Blob Storage.

Example: Upload a File to a Container

1. Select Upload as the Operation.
2. Enter your Account URL, Account Name, and Account Key.
3. Specify the target Container Name.
4. Enter the target directory in Blob Folder Path (for example, invoices/2026/) and provide the source file using Data / DataFrame / JSON, Input File Path, or Select File.
5. Configure Upload Overwrite (Enabled or Disabled) as needed.
6. Run the component and verify the standardized Result output.

Troubleshooting

Issue What to Check
Authentication / Authorization Failure Verify that the Account URL, Account Name, and Account Key match the same Azure Storage account and that the key has not been regenerated or expired.
Container or Blob Not Found Confirm that the Container Name and Blob Path (or azure:// URI) are spelled accurately, as paths are case-sensitive in Azure Blob Storage, and that the item exists.
Invalid Account URL Format Ensure the Account URL uses the Blob service endpoint format (https://<account-name>.blob.core.windows.net) without trailing container names or SAS query strings.
Upload / Move / Copy Blocked by Existing Blob Check the Upload Overwrite, Move Overwrite, or Copy Overwrite parameters. If disabled, enable them to allow overwriting existing blobs.
SAS URL Generation Fails Verify that the requested expiry duration does not exceed the platform-defined maximum limit and that the configured Account Key has permissions to sign SAS tokens.
Folder Delete Leaves Files Behind Azure virtual folders disappear only when all blobs inside them are removed. Enable Delete Recursive in the Parameters panel to delete all blobs under the specified path.
Incomplete Blob Listing Check whether List Max Results is capping the returned items or whether Prefix is filtering out expected blobs. Set List Max Results to 0 to return all matching blobs.
Share this Doc

Azure Blob Storage (Beta)

Or copy link

CONTENTS
Robility Chatbot
Robility Assistant
Online