99 lines
3.7 KiB
Go
99 lines
3.7 KiB
Go
package httpapi
|
|
|
|
import (
|
|
"net/http"
|
|
|
|
gatewaydocs "github.com/easyai/easyai-ai-gateway/apps/api/docs"
|
|
"github.com/easyai/easyai-ai-gateway/apps/api/internal/skillbundle"
|
|
)
|
|
|
|
const (
|
|
opsManagementSkillDownloadPath = "/api/v1/public/skills/ai-gateway-ops-management/download"
|
|
apiDocsJSONPath = "/api-docs-json"
|
|
apiDocsYAMLPath = "/api-docs-yaml"
|
|
)
|
|
|
|
// getOpsManagementSkillMetadata godoc
|
|
// @Summary 获取 AI Gateway 运维管理 SKILL 元数据
|
|
// @Description 返回公开运维管理 SKILL 的名称、版本、模块、下载文件名和机器可读接口文档路径。
|
|
// @Tags agent-resources
|
|
// @Produce json
|
|
// @Success 200 {object} SkillBundleMetadataResponse
|
|
// @Failure 500 {object} ErrorEnvelope
|
|
// @Router /api/v1/public/skills/ai-gateway-ops-management/metadata [get]
|
|
func (s *Server) getOpsManagementSkillMetadata(w http.ResponseWriter, _ *http.Request) {
|
|
metadata, err := skillbundle.LoadMetadata()
|
|
if err != nil {
|
|
s.logger.Error("load operations skill metadata failed", "error", err)
|
|
writeError(w, http.StatusInternalServerError, "operations skill metadata unavailable")
|
|
return
|
|
}
|
|
writeJSON(w, http.StatusOK, opsManagementSkillMetadataResponse(metadata))
|
|
}
|
|
|
|
// downloadOpsManagementSkill godoc
|
|
// @Summary 下载 AI Gateway 运维管理 SKILL
|
|
// @Description 下载可交给 Agent 使用的 ai-gateway-ops-management ZIP 包。
|
|
// @Tags agent-resources
|
|
// @Produce application/zip
|
|
// @Success 200 {file} binary
|
|
// @Failure 500 {object} ErrorEnvelope
|
|
// @Router /api/v1/public/skills/ai-gateway-ops-management/download [get]
|
|
func (s *Server) downloadOpsManagementSkill(w http.ResponseWriter, _ *http.Request) {
|
|
metadata, err := skillbundle.LoadMetadata()
|
|
if err != nil {
|
|
s.logger.Error("load operations skill metadata failed", "error", err)
|
|
writeError(w, http.StatusInternalServerError, "operations skill metadata unavailable")
|
|
return
|
|
}
|
|
archive, err := skillbundle.BuildArchive()
|
|
if err != nil {
|
|
s.logger.Error("build operations skill archive failed", "error", err)
|
|
writeError(w, http.StatusInternalServerError, "operations skill download unavailable")
|
|
return
|
|
}
|
|
w.Header().Set("Content-Type", "application/zip")
|
|
w.Header().Set("Content-Disposition", `attachment; filename="`+skillbundle.FileName(metadata)+`"`)
|
|
w.WriteHeader(http.StatusOK)
|
|
_, _ = w.Write(archive)
|
|
}
|
|
|
|
// apiDocsJSON godoc
|
|
// @Summary 获取 AI Gateway Swagger JSON
|
|
// @Description 返回当前构建内嵌的完整机器可读 Swagger JSON，供 Agent 在 SKILL references 未覆盖接口时查询。
|
|
// @Tags agent-resources
|
|
// @Produce json
|
|
// @Success 200 {object} map[string]interface{}
|
|
// @Router /api-docs-json [get]
|
|
func (s *Server) apiDocsJSON(w http.ResponseWriter, _ *http.Request) {
|
|
w.Header().Set("Content-Type", "application/json; charset=utf-8")
|
|
w.WriteHeader(http.StatusOK)
|
|
_, _ = w.Write(gatewaydocs.SwaggerJSON)
|
|
}
|
|
|
|
// apiDocsYAML godoc
|
|
// @Summary 获取 AI Gateway Swagger YAML
|
|
// @Description 返回当前构建内嵌的完整机器可读 Swagger YAML。
|
|
// @Tags agent-resources
|
|
// @Produce application/yaml
|
|
// @Success 200 {string} string
|
|
// @Router /api-docs-yaml [get]
|
|
func (s *Server) apiDocsYAML(w http.ResponseWriter, _ *http.Request) {
|
|
w.Header().Set("Content-Type", "application/yaml; charset=utf-8")
|
|
w.WriteHeader(http.StatusOK)
|
|
_, _ = w.Write(gatewaydocs.SwaggerYAML)
|
|
}
|
|
|
|
func opsManagementSkillMetadataResponse(metadata skillbundle.Metadata) SkillBundleMetadataResponse {
|
|
return SkillBundleMetadataResponse{
|
|
Name: metadata.Name,
|
|
Version: metadata.Version,
|
|
DisplayName: skillbundle.DisplayName,
|
|
Modules: metadata.Modules,
|
|
FileName: skillbundle.FileName(metadata),
|
|
DownloadPath: opsManagementSkillDownloadPath,
|
|
APIDocsJSONPath: apiDocsJSONPath,
|
|
APIDocsYAMLPath: apiDocsYAMLPath,
|
|
}
|
|
}
|