Zing Forum

Reading

Embabel Workflow Visualizer: Real-Time Workflow Visualization Tool for Embabel Agents

A Spring Boot Starter project that provides real-time workflow visualization capabilities for Embabel agents, including Actuator endpoints, REST APIs, and an interactive pan-and-zoom UI to help developers intuitively understand and debug agent execution processes.

Embabel智能体工作流可视化Spring BootAI可观测性实时监控调试工具企业级
Published 2026-05-12 00:43Recent activity 2026-05-12 00:54Estimated read 8 min
Embabel Workflow Visualizer: Real-Time Workflow Visualization Tool for Embabel Agents
1

Section 01

Introduction / Main Floor: Embabel Workflow Visualizer: Real-Time Workflow Visualization Tool for Embabel Agents

A Spring Boot Starter project that provides real-time workflow visualization capabilities for Embabel agents, including Actuator endpoints, REST APIs, and an interactive pan-and-zoom UI to help developers intuitively understand and debug agent execution processes.

2

Section 02

Challenges in AI Agent Observability

With the rapid development of AI Agent technology, more and more applications are adopting agent architectures to perform complex tasks. Agents can autonomously complete work that traditional programs find difficult through multi-step reasoning, tool calls, and state management. However, this autonomy also brings observability challenges—when an agent encounters execution issues, developers often struggle to track and understand its decision-making process.

Traditional logging and debugging tools fall short when dealing with the dynamic execution flow of agents. The execution path of an agent may change based on different inputs, with complex intermediate states and long tool call chains, all of which increase debugging difficulty. Visualization becomes a key solution to this problem; by graphically displaying the agent's execution flow, developers can intuitively understand its behavioral logic.

3

Section 03

Project Overview: Embabel Agent Visualization Solution

Embabel Workflow Visualizer is a Spring Boot Starter project designed specifically for the Embabel agent framework. Embabel is an enterprise-level AI agent platform that supports building complex agent workflows. This project provides real-time visualization capabilities to help developers monitor and debug agent execution processes.

The core components of the project include:

  • Spring Boot Starter: Easy integration into existing Spring applications
  • Actuator endpoints: Provide health checks and metric exposure
  • REST API: Programmatic access to workflow data
  • Interactive UI: Real-time visualization interface supporting pan, zoom, and other interactions
4

Section 04

Introduction to the Embabel Agent Framework

Embabel is an enterprise-oriented AI agent framework that supports building, deploying, and managing agent workflows. Its design features include:

  • Workflow orchestration: Supports defining complex multi-step agent workflows
  • Tool integration: Can integrate external APIs, databases, search engines, and other tools
  • State management: Maintains context states during agent execution
  • Enterprise-level features: Supports security, auditing, monitoring, and other enterprise requirements

Embabel workflows usually consist of multiple nodes, including LLM call nodes, tool call nodes, conditional branch nodes, parallel execution nodes, etc. These nodes execute in a defined order or dynamically determined flow, forming the complete agent behavior.

5

Section 05

Technical Architecture: Three-Tier Visualization System

Embabel Workflow Visualizer adopts a three-tier architecture to provide comprehensive visualization capabilities:

6

Section 06

Data Collection Layer: Actuator Endpoints

The project exposes workflow-related runtime metrics and status information through Spring Boot Actuator. Actuator is Spring Boot's monitoring and management framework, providing standardized endpoints for health checks, metric collection, environment information, etc.

The project extends Actuator by adding dedicated workflow endpoints that expose the following information:

  • List of currently executing workflows
  • Execution status of workflows (running, completed, failed, etc.)
  • Execution time and results of each node
  • Detailed records of tool calls
  • Input/output summaries of LLM calls
7

Section 07

Data Access Layer: REST API

In addition to Actuator endpoints, the project also provides dedicated REST APIs to support more flexible data queries:

  • Query the complete execution history of a specific workflow
  • Obtain the graphical structure definition of a workflow
  • Filter workflows by time range, status, and other conditions
  • Export workflow data for offline analysis

REST APIs use standard HTTP methods and JSON format, making them easy to integrate with other tools.

8

Section 08

Presentation Layer: Interactive Visualization UI

The project's highlight is its interactive visualization interface. Built on modern front-end technologies, this UI offers the following features:

  • Real-time updates: Workflow execution status is synchronized to the interface in real time
  • Graphical display: Nodes and connections are presented graphically to intuitively show the workflow structure
  • Pan and zoom: Supports canvas panning and zooming for easy viewing of large workflows
  • Node details: Click on a node to view detailed execution information
  • Status coloring: Different states are marked with different colors (running, success, failed, etc.)
  • Execution replay: Supports replaying historical workflow execution processes