feat: add swagger (#438)

* fix: add swagger

* fix: ci

Author: mengnankkkk

data-agent-management/pom.xml

@@ -106,6 +106,16 @@
             <artifactId>h2</artifactId>
             <scope>runtime</scope>
         </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-web</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springdoc</groupId>
+            <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
+            <version>${springdoc-openapi.version}</version>
+        </dependency>
+
         <dependency>
             <groupId>org.springframework.boot</groupId>
             <artifactId>spring-boot-testcontainers</artifactId>

data-agent-management/src/main/java/com/alibaba/cloud/ai/dataagent/config/OpenApiConfig.java

@@ -0,0 +1,45 @@
+/*
+ * Copyright 2024-2026 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.alibaba.cloud.ai.dataagent.config;
+
+import io.swagger.v3.oas.models.OpenAPI;
+import io.swagger.v3.oas.models.info.Info;
+import org.springdoc.core.models.GroupedOpenApi;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+
+/**
+ * OpenAPI/Swagger 配置。
+ */
+@Configuration
+public class OpenApiConfig {
+
+	@Bean
+	public OpenAPI dataAgentOpenApi() {
+		return new OpenAPI()
+			.info(new Info().title("DataAgent Backend API").description("DataAgent 后端接口文档").version("v1"));
+	}
+
+	@Bean
+	public GroupedOpenApi dataAgentApiGroup() {
+		return GroupedOpenApi.builder()
+			.group("data-agent")
+			.packagesToScan("com.alibaba.cloud.ai.dataagent.controller")
+			.pathsToMatch("/api/**")
+			.build();
+	}
+
+}

data-agent-management/src/main/resources/application.yml

@@ -1,6 +1,12 @@
 server:
   port: 8065
 
+springdoc:
+  api-docs:
+    path: /v3/api-docs
+  swagger-ui:
+    path: /swagger-ui.html
+
 # 存储 DataAgent 业务数据的数据库，并非Agent分析数据的来源
 spring:
   datasource: