한국어 Korean

AI AI AI - Spring SpringBoot 4.1 + 봄 AI 2.0 + DDD D的 AI 에이전트

(ZhuLing)) Java **一 Agent **。一一一 YAML 炉端串文件,::

多

• ✅ 一一目一
• ✅ S S
• 多
• ✅ MCP 三用(Local / SSE / Stdio 三三式) 脚 脚 脚
• ✅ 上的比(토큰 、T、T、上、上下文占)
• ✅ 版本 SSE 外件信息表(turn / message / reasoning / tool 生 件)
• ✅ ** 개인 정보 취급 방침
• ✅ (安、一一化、安安展)
• ✅ 台 UI

️

###

目

台

₢ 킹

| 件 | 일본 | ド明 | |—||||| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 스프링버튼 | 4.1.0 | | | 스프링 AI | 2.0.1-SNAPSHOT | LLM 過去用一一理 | | 스프링 AI Alibaba | 1.1.2.0 | 에이전트 展 | | WebFlux | | | 利用流 | 마이바티스플러스 | 3.5.17 | ( My) | 인포메이션 주식회사 | MCP SDK | 2.0.0-M2 | 모델 콘텍스트 프로토콜 | | 잭슨 | 2.17.2 | JSON |

T:Trigger → API → Case → Domain ← Infrastructure,번역 도메인。

🚀

# # # # # # # # # # #

• JDK 21+(주)
• 평균 3.8+
• MySQL 8.0+(보통 PostgreSQL 15+)

##1 目

##2. #

,执行下 SQL:

₢ 킹

铸灵 ZhuLing

🌐 English | 中文

铸造 AI 灵魂 —— 基于 SpringBoot 4.1 + Spring AI 2.0 + DDD 六边形架构的 AI Agent 开发脚手架

📖 项目简介

铸灵（ZhuLing）帮助 Java 开发者零代码启动 Agent 应用。只需编写一份 YAML 配置文件，即可获得：

• ✅ 多 Agent 独立注册与运行时隔离
• ✅ 统一对话目标选择（Agent / Workflow）
• ✅ 同步 & SSE 流式对话接口
• ✅ 多轮会话记忆与历史消息持久化
• ✅ MCP 工具调用（Local / SSE / Stdio 三种模式）
• ✅ Skills 脚本包加载与执行
• ✅ 完整的可观测性（Token 统计、工具遥测、Trace ID、上下文占用比）
• ✅ 版本化 SSE 事件信封（turn / message / reasoning / tool 生命周期事件）
• ✅ 单 Agent ReAct 执行内核（多步 thought → act → observe、过程级观测、实时步骤轨迹）
• ✅ 节点生命周期拦截器（观测、错误归一化、安全策略扩展点）
• ✅ 内置可观测对话工作台 UI

🖼️ 界面预览

登录

对话目标选择

可观测对话工作台

🏗️ 技术栈

📁 工程结构

zhuling/
├── zhuling-types/            # 公共类型（枚举、异常、通用常量）
├── zhuling-api/              # 接口 DTO / VO 定义
├── zhuling-domain/           # 领域层（核心业务、Port/Repository 接口）
├── zhuling-case/             # 编排层（用例编排、聊天流程）
├── zhuling-infrastructure/   # 基础设施层（DAO、Gateway、Redis、可观测性实现）
├── zhuling-trigger/          # 触发层（HTTP Controller）
├── zhuling-app/              # 启动模块（配置文件、Agent YAML、Skills）
├── zhuling-ui/                    # 可观测对话工作台（纯静态前端）
└── docs/                         # 设计文档、SQL 脚本

依赖规则：Trigger → API → Case → Domain ← Infrastructure，所有依赖向内指向 Domain。

🚀 快速开始

环境要求

• JDK 21+
• Maven 3.8+
• MySQL 8.0+（或 PostgreSQL 15+）

1. 克隆项目

git clone https://github.com/vinist123/zhuling.git
cd zhuling

2. 初始化数据库

创建数据库后，执行以下建表 SQL：

-- Agent 会话表
CREATE TABLE agent_session (
    id VARCHAR(36) PRIMARY KEY,
    target_id VARCHAR(128) NOT NULL,
    target_type VARCHAR(20) NOT NULL DEFAULT 'AGENT',
    user_id VARCHAR(64),
    title VARCHAR(256),
    status VARCHAR(20) DEFAULT 'active',
    message_count INT DEFAULT 0,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

-- Agent 消息表
CREATE TABLE agent_message (
    id VARCHAR(36) PRIMARY KEY,
    session_id VARCHAR(36) NOT NULL,
    role VARCHAR(20) NOT NULL,
    content TEXT,
    metadata JSON,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    FOREIGN KEY (session_id) REFERENCES agent_session(id)
);

3. 修改配置

编辑 zhuling-app/src/main/resources/application-dev.yml：

spring:
  datasource: