# Version 2.3.4 | June 26, 2025

## **Overview** <a href="#overview" id="overview"></a>

ZBrain Builder 2.3.4 delivers faster flow building, streamlined operational oversight, safer and more expansive automation, refined monitoring, and greater agent transparency. Together, these upgrades help teams develop, operate, and monitor enterprise-grade AI solutions more responsively, efficiently, and intuitively. The release packs several new features and targeted improvements that further elevate user experience and productivity.

### ZBrain 2.3.4 release overview <a href="#zbrain-2.3.4-release-overview" id="zbrain-2.3.4-release-overview"></a>

| Component            | Capability                                                            | What it delivers                                                                                 |
| -------------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
| Flows & pieces       | Auto-scrolling Flow interface                                         | Automatically scrolls the interface during component dragging for a smoother workflow editing.   |
| Integrations         | Standalone executable of Resume Screening Agent                       | Downloadable .exe file for Resume Screening Agent with complete resume review functionality.     |
|                      | Expanded file type support, file type validation and preview of file. | Adds support and validation for new file types (PNG, JPG, JPEG).                                 |
| Evaluation framework | Real-time processing status                                           | Shows live status updates for triggered events, reducing workflow uncertainty.                   |
|                      | Bulk log deletion                                                     | Deletes multiple event logs to improve productivity.                                             |
|                      | Health check metric                                                   | Validates app/agent uptime through HTTP checks for easy monitoring.                              |
| Guardrails           | Parameter-specific configurations                                     | Generates an individual `.yml` file per parameter, simplifying configuration updates and audits. |
|                      | Dynamic query processing                                              | Context-aware validation dynamically applies relevant Guardrail rules.                           |
|                      | Enhanced debugging & observability                                    | Detailed logs for easier debugging of rule execution and response filtering.                     |
| RAG                  | Locked RAG definition                                                 | Locks the RAG definition at initial KB creation to prevent misconfigurations.                    |
| Agents               | Google search integration                                             | Adds real-time web search capability to agents.                                                  |
|                      | ZBrain Flow integration                                               | Embeds custom ZBrain Flows within agents to streamline automation.                               |
|                      | External package support                                              | Enables integration of external packages directly within agents.                                 |
|                      | Agent type visibility                                                 | Clearly displays agent types for easier identification and management.                           |
|                      | Usability enhancements                                                | Adds message sending shortcuts and safer instruction editing for Test Crew.                      |
| SaaS                 | Seamless scrolling for Knowledge Storage                              | Enables continuous scroll for smoother browsing of extensive records.                            |

These enhancements collectively streamline workflow creation, boost operational efficiency, and deliver greater transparency for enterprise-grade AI deployments.

## New features

### **Flows & Pieces** <a href="#flows-and-pieces" id="flows-and-pieces"></a>

#### **Auto-scrolling on the Flow interface during component dragging** <a href="#auto-scrolling-on-the-flow-interface-during-component-dragging" id="auto-scrolling-on-the-flow-interface-during-component-dragging"></a>

The Flow interface now automatically scrolls whenever a component is dragged toward any edge, allowing it to move in all directions. Precise snap-to-grid placement is preserved, and the feature works seamlessly with existing zoom and pan capabilities, eliminating the need for manual scrolling on large or complex flows.

#### **Key outcomes:** <a href="#key-outcomes" id="key-outcomes"></a>

* Auto-scroll activates when dragging within the interface edges.
* Speeds up flow editing and provides a smoother design experience, especially when working on flows that extend beyond the visible screen area.
* Maintains precise positioning and snapping of components.
* More intuitive, efficient, and seamless experience for users building complex workflows.

### **Integrations** <a href="#integrations" id="integrations"></a>

#### Standalone executable of Resume Screening Agent  <a href="#standalone-executable-of-resume-screening-agent" id="standalone-executable-of-resume-screening-agent"></a>

Users can now export the Resume Screening agent as a single, self-contained **.exe** (no installer, no extra folders).\
\&#xNAN;*Navigation: Resume Screening Agent › ⋮ (More) › Download Agent*

<figure><img src="https://3781630280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbuSicczDKTyHzwzicar%2Fuploads%2FGvttj8bVkvCZzJtoWOMx%2Fimage.png?alt=media&#x26;token=c11e4784-6aea-4a5a-8213-32454102a20b" alt=""><figcaption></figcaption></figure>

#### **Key outcomes** <a href="#key-outcomes" id="key-outcomes"></a>

* Delivers complete resume screening functionality without internet access, preserving full feature set.

### **Evaluation framework** <a href="#evaluation-framework" id="evaluation-framework"></a>

#### **Monitor** <a href="#monitor" id="monitor"></a>

#### [**Real-time status for agent events**](https://docs.zbrain.ai/zbrain-documentation/zbrain-builder/monitor/event-dashboard-monitor-logs-and-user-management) <a href="#real-time-status-for-agent-events" id="real-time-status-for-agent-events"></a>

This feature adds a “Processing” status to the monitor dashboard for agent events that have been triggered (e.g., by a cron job) but have not yet posted logs. This provides real-time visibility into execution progress before results are finalized. Once logs are posted, the status should automatically update to “Success” or “Failed.”

* **Navigation path:** *Monitor → Events → Last Status(Column)*

<figure><img src="https://3781630280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbuSicczDKTyHzwzicar%2Fuploads%2FS2Beiv6Aa9GSYsVuqvxg%2Fimage.png?alt=media&#x26;token=20fd984d-8549-47cf-9db7-4abfc167776f" alt=""><figcaption></figcaption></figure>

#### **Key outcome:** <a href="#key-outcome" id="key-outcome"></a>

* The processing status confirms an event is in progress, removing guesswork when monitoring large or scheduled workflows.

#### [**Bulk delete for monitor logs**](https://docs.zbrain.ai/zbrain-documentation/zbrain-builder/monitor/event-dashboard-monitor-logs-and-user-management) <a href="#bulk-delete-for-monitor-logs" id="bulk-delete-for-monitor-logs"></a>

Users can now select and delete multiple event logs at once from the Monitor Events screen. This replaces the previous one-at-a-time deletion model with a faster, more scalable option.

* **Navigation Path:** *Login → Monitor → Events → (Event Checkboxes)*

<figure><img src="https://3781630280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbuSicczDKTyHzwzicar%2Fuploads%2FAPscdwdZcciDhMh3mZPe%2Fimage.png?alt=media&#x26;token=c0210170-20d8-44e9-ac43-46f7a35354f3" alt=""><figcaption></figcaption></figure>

#### **Key outcome:**  <a href="#key-outcome-.1" id="key-outcome-.1"></a>

* Improves productivity and log hygiene for users managing high volumes of events.

#### [**New evaluation metric – "Health Check"**](https://docs.zbrain.ai/zbrain-documentation/zbrain-builder/monitor/how-to-configure-a-monitoring-event-for-apps) <a href="#new-evaluation-metric-health-check" id="new-evaluation-metric-health-check"></a>

Users can now include the **Health Check** metric in evaluation from the Non-LLM Metrics suite. It verifies that an agent or app is reachable by checking the HTTP response status and can trigger notifications when they are configured. &#x20;

* **Navigation Path:** *Monitor → Events → (Click on any ‘Event’) → Event Settings → Add Metric → Non-LLM Metrics → Health Check*

<figure><img src="https://3781630280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbuSicczDKTyHzwzicar%2Fuploads%2F7JTFjOnOrhEJmKWGJd3V%2Fimage.png?alt=media&#x26;token=98bac2cb-d9d0-43a9-949f-b680eaefce28" alt=""><figcaption></figcaption></figure>

#### **Key outcome:** <a href="#key-outcome-.2" id="key-outcome-.2"></a>

* Offers a simple yet powerful monitoring metric to validate system uptime and API responsiveness, without requiring LLM-based evaluation or complex configuration.

### **Guardrails** <a href="#guardrail" id="guardrail"></a>

#### [**Parameter-specific configuration files**](https://docs.zbrain.ai/zbrain-documentation/zbrain-builder/app/how-to-create-a-new-app/how-to-leverage-knowledge-base-s-for-app-creation) <a href="#parameter-specific-configuration-files" id="parameter-specific-configuration-files"></a>

Each monitored parameter (such as input and jailbreak) now has its dedicated `.yml` file (e.g., `input.yml`, `jailbreak.yml`). These files are generated and versioned independently and stored in a private S3 bucket. Only users with required credentials can access those files.

* **Navigation:** *App → Create App → Add guardrail parameter → Select Guardrails → Enable as per requirement → Complete App Creation → Test Bot Performance*

<figure><img src="https://3781630280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbuSicczDKTyHzwzicar%2Fuploads%2FoNUb1r3jpLKhlKYFNjVC%2Fimage.png?alt=media&#x26;token=f12ddae0-0a5e-4887-b42c-8a4757ce272d" alt=""><figcaption></figcaption></figure>

**Key outcome:** &#x20;

* Improves maintainability and makes it easier to audit or update specific evaluation rules without impacting the entire configuration.
* Filters data based on context-specific rails through the Guardrails service.

#### **Dynamic query processing via Guardrail service** <a href="#dynamic-query-processing-via-guardrail-service" id="dynamic-query-processing-via-guardrail-service"></a>

The query engine detects the context (e.g., input vs. output) and sends the relevant `.yml` reference to the Guardrails service. The Guardrails service will then process and filter responses accordingly.

#### **Key outcome:** <a href="#key-outcome-.3" id="key-outcome-.3"></a>

* Enables context-aware response filtering that returns a validated response to the main flow.

### **RAG** <a href="#rag" id="rag"></a>

#### [**RAG definition locking based on the initial KB definition**](https://docs.zbrain.ai/zbrain-documentation/zbrain-builder/knowledge-base/how-to-create-a-knowledge-base/data-refinement-tuning/how-to-create-a-knowledge-base-using-vector-store) <a href="#rag-definition-locking-based-on-the-initial-kb-definition" id="rag-definition-locking-based-on-the-initial-kb-definition"></a>

The Data Refinement Tuning page now shows only the RAG mode defined when the Knowledge Base was created, providing an intelligent UI behavior on the page. If a KB is initially created using Knowledge Graph, the Vector Store option is hidden for all subsequent document uploads under that KB and vice versa.

<figure><img src="https://3781630280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbuSicczDKTyHzwzicar%2Fuploads%2FbkNq8xnk3PBbm3QK6rlD%2Fimage.png?alt=media&#x26;token=4575adef-af6a-4506-a197-c8b2e2f8fb36" alt=""><figcaption></figcaption></figure>

#### **Key outcome:** <a href="#key-outcome-.4" id="key-outcome-.4"></a>

* &#x20;Enforces consistent RAG architecture within a KB, avoiding misalignment or mixed retrieval strategies.
* Reduces user confusion and prevents configuration errors during document ingestion.

### **Agents** <a href="#agents" id="agents"></a>

#### [**Inclusion of Google Search in Agent default tools**](https://docs.zbrain.ai/zbrain-documentation/zbrain-builder/zbrain-ai-agents/agent-crew/define-crew-structure) <a href="#inclusion-of-google-search-in-agent-default-tools" id="inclusion-of-google-search-in-agent-default-tools"></a>

This feature adds real-time search capability to agents, allowing them to retrieve current information directly from Google.

* **Navigation path:** *Define Crew Structure → Select Agent → Agent Tool → Default Tools-> Google Search*

<figure><img src="https://3781630280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbuSicczDKTyHzwzicar%2Fuploads%2F9jCdxhRAsXzqcBw6fE7H%2Fimage.png?alt=media&#x26;token=d2618528-8c02-48a1-86bf-957e16ca0c2b" alt=""><figcaption></figcaption></figure>

#### **Key outcome:** <a href="#key-outcome-.5" id="key-outcome-.5"></a>

* Agents gain real-time web access, enhancing their ability to deliver timely and relevant responses.

#### [**ZBrain Flow integration with Crew Agent**](https://docs.zbrain.ai/zbrain-documentation/zbrain-builder/zbrain-ai-agents/agent-crew/define-crew-structure) <a href="#zbrain-flow-integration-with-crew-agent" id="zbrain-flow-integration-with-crew-agent"></a>

ZBrain Builder now integrates ZBrain Flows into Crew Agent, enabling users to add flow-based agents. Agents can trigger a ZBrain Flow and use its response to guide their next actions.

* **Navigation path:** *Define Crew Structure → Add Agent → Add from Library → ZBrain Flow*

<figure><img src="https://3781630280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbuSicczDKTyHzwzicar%2Fuploads%2FFZVvsiTq6jGxZi5Ylnv2%2Fimage.png?alt=media&#x26;token=334ea5e5-19d4-455a-88e5-d71485f6ab62" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3781630280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbuSicczDKTyHzwzicar%2Fuploads%2FWYPbgxK1XYeWkBcnZJ25%2Fimage.png?alt=media&#x26;token=c4276ae9-1ea4-4f36-a575-d35b2dc7b50d" alt=""><figcaption></figcaption></figure>

#### **Key outcome:** <a href="#key-outcome-.6" id="key-outcome-.6"></a>

* Seamlessly integrates advanced internal workflows into agent logic, enhancing automation and flow-based decisioning.

#### [**Addition of packages in the Crew Agent Tools**](https://docs.zbrain.ai/zbrain-documentation/zbrain-builder/zbrain-ai-agents/agent-crew/define-crew-structure) <a href="#addition-of-packages-in-the-crew-agent-tools" id="addition-of-packages-in-the-crew-agent-tools"></a>

Users can now add external dependencies (e.g., npm packages) directly to an agent’s tool. On clicking ‘Add’, the latest version of the package will be automatically added to the tool's list of dependencies. This supports automatic version resolution and easy rollback.

* **Navigation path:** *Define Crew Structure → Select/Add Agent → Agent Tool → New Tool / Select from My Tools → Add Package*

<figure><img src="https://3781630280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbuSicczDKTyHzwzicar%2Fuploads%2FrcbIRuFDnPA19SAEmdjP%2Fimage.png?alt=media&#x26;token=a28be213-df0b-4292-96fb-0de7d9cc5ec4" alt=""><figcaption></figcaption></figure>

#### **Key outcome:**  <a href="#key-outcome-.7" id="key-outcome-.7"></a>

* Improves tool extensibility and supports custom agent logic through external libraries.

#### [**Visibility of Agent Type in the interface**](https://docs.zbrain.ai/zbrain-documentation/zbrain-builder/zbrain-ai-agents/agent-crew/define-crew-structure) <a href="#visibility-of-agent-type-in-the-interface" id="visibility-of-agent-type-in-the-interface"></a>

The agent type (Supervisor, Autonomous, or ZBrain Flow) is now clearly displayed in the agent interface in an agent crew structure.

<figure><img src="https://3781630280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbuSicczDKTyHzwzicar%2Fuploads%2F2c39RP2UvAyzmllq54SX%2Fimage.png?alt=media&#x26;token=f4c9ed65-14a2-4aef-994d-bd076a0a99c6" alt=""><figcaption></figcaption></figure>

#### **Key outcome:** <a href="#key-outcome-.8" id="key-outcome-.8"></a>

* &#x20;Enhances crew transparency and helps users quickly identify the role and behavior of each agent.

## Improvements <a href="#improvements" id="improvements"></a>

### **Integrations** <a href="#integrations.1" id="integrations.1"></a>

#### Expanded upload file type support in the agent dashboard <a href="#expanded-upload-file-type-support-in-the-agent-dashboard" id="expanded-upload-file-type-support-in-the-agent-dashboard"></a>

ZBrain now supports image formats (PNG, JPG, JPEG), in addition to the existing formats: PDF, TXT, CSV, JSON, DOCX, PPTX, and XLSX.

<figure><img src="https://3781630280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbuSicczDKTyHzwzicar%2Fuploads%2FyVNKuKieue6KTRjQjvYf%2Fimage.png?alt=media&#x26;token=9db054b9-9c6e-451b-b326-fbda98e5d473" alt=""><figcaption></figcaption></figure>

#### **Key outcome:** <a href="#key-outcome-.9" id="key-outcome-.9"></a>

* Supports a wider variety of input data without requiring pre-processing or format conversion.

#### **Smart validation and feedback** <a href="#smart-validation-and-feedback" id="smart-validation-and-feedback"></a>

Each uploaded file is validated for integrity and supported file type.

* Invalid or corrupt files are blocked with clear error messages.
* Unsupported formats (e.g., .exe, .zip) are automatically rejected with "Unsupported Format" warnings.

<figure><img src="https://3781630280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbuSicczDKTyHzwzicar%2Fuploads%2FRma16fA4Y42st3eJyHAU%2Fimage.png?alt=media&#x26;token=a6e4e91f-2f7c-4a0e-916b-b560424ab79d" alt=""><figcaption></figcaption></figure>

#### **Key outcome:** <a href="#key-outcome-.10" id="key-outcome-.10"></a>

* Reduces user errors and ensures a smooth file submission experience.

#### **Enhanced UI experience with file previews** <a href="#enhanced-ui-experience-with-file-previews" id="enhanced-ui-experience-with-file-previews"></a>

Image files show a thumbnail preview or filename confirmation after upload. Other files (e.g., DOCX, PDF, CSV) display their filename for quick verification.

#### **Key outcome:** <a href="#key-outcome-.11" id="key-outcome-.11"></a>

* Provides visual confirmation that the correct files were uploaded, improving confidence and efficiency.

#### **Reliable task execution across all supported formats** <a href="#reliable-task-execution-across-all-supported-formats" id="reliable-task-execution-across-all-supported-formats"></a>

Uploaded files (across supported types) are correctly processed during task submission. The pipeline handles input ingestion based on file type, ensuring seamless execution of the agent.

#### **Key outcome:** <a href="#key-outcome-.12" id="key-outcome-.12"></a>

* Guarantees consistency in agent behavior regardless of input format.

### **SaaS** <a href="#saas" id="saas"></a>

#### **Seamless scrolling for knowledge storage** <a href="#seamless-scrolling-for-knowledge-storage" id="seamless-scrolling-for-knowledge-storage"></a>

Automatically loads more storage items as the user scrolls toward the bottom of the list. Seamless scroll experience with no page reloads or buttons.

* **Navigation path:** *Settings → Billing → Knowledge Storage*

<figure><img src="https://3781630280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbuSicczDKTyHzwzicar%2Fuploads%2FyiGMI8128F3S2WTbwC6z%2Fimage.png?alt=media&#x26;token=f0f8b8b6-9348-40ca-a73c-d403a16ffe16" alt=""><figcaption></figcaption></figure>

#### **Key outcome:** <a href="#key-outcome-.13" id="key-outcome-.13"></a>

* Provides a faster and smoother browsing experience for users managing extensive knowledge storage records, thereby enhancing data accessibility and overall user efficiency.

### **Guardrails** <a href="#guardrails" id="guardrails"></a>

#### **Enhanced observability and debugging** <a href="#enhanced-observability-and-debugging" id="enhanced-observability-and-debugging"></a>

System logs now include configuration details, the response before and after filtering, and any errors encountered during rule parsing or execution.

#### **Key outcome:** <a href="#key-outcome-.18" id="key-outcome-.18"></a>

* Provides full transparency for auditing and debugging, making it easier to trace filtering outcomes and diagnose misconfigurations.

### **Agents** <a href="#agents.1" id="agents.1"></a>

#### **Usability enhancements** <a href="#usability-enhancements" id="usability-enhancements"></a>

* **Quick message shortcut:** Users can use **Ctrl+Enter** to send a quick message in Test Crew.
* **Instruction editing:** Deleting an instruction now clears only the text, not the entire agent from the Crew.

#### **Key outcome:** <a href="#key-outcome-.19" id="key-outcome-.19"></a>

* Improves testing efficiency and reduces accidental agent deletions during edits.