@cloudbase/manager-node 5.2.0 → 5.3.0

package/cloudbase-manager-node/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@cloudbase/manager-node",
-    "version": "5.2.0",
+    "version": "5.3.0",
     "description": "The node manage service api for cloudbase.",
     "main": "lib/index.js",
     "scripts": {

package/lib/aiModel/index.js

@@ -0,0 +1,101 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AiModelService = void 0;
+const utils_1 = require("../utils");
+class AiModelService {
+    constructor(environment) {
+        this.environment = environment;
+        this.tcbService = new utils_1.CloudService(environment.cloudBaseContext, 'tcb', '2018-06-08');
+    }
+    /**
+     * 创建 AI 模型配置分组
+     */
+    async createAIModel(options) {
+        const { EnvId } = this.environment.lazyEnvironmentConfig;
+        const { envId, groupName, baseUrl, models, remark, status, secret } = options;
+        if (!groupName || groupName.trim().length === 0) {
+            throw new Error('groupName is required');
+        }
+        if (groupName.toLowerCase().startsWith('cloudbase')) {
+            throw new Error('groupName cannot start with cloudbase');
+        }
+        if (status !== undefined && status !== 1 && status !== 2) {
+            throw new Error('status must be 1 or 2');
+        }
+        return this.tcbService.request('CreateAIModel', Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ EnvId: envId || EnvId, GroupName: groupName }, (baseUrl !== undefined ? { BaseUrl: baseUrl } : {})), (models !== undefined ? { Models: models } : {})), (remark !== undefined ? { Remark: remark } : {})), (status !== undefined ? { Status: status } : {})), (secret !== undefined ? { Secret: secret } : {})));
+    }
+    /**
+     * 更新 AI 模型配置分组
+     */
+    async updateAIModel(options) {
+        const { EnvId } = this.environment.lazyEnvironmentConfig;
+        const { envId, groupName, baseUrl, models, remark, status, secret } = options;
+        if (!groupName || groupName.trim().length === 0) {
+            throw new Error('groupName is required');
+        }
+        if (status !== undefined && status !== 1 && status !== 2) {
+            throw new Error('status must be 1 or 2');
+        }
+        return this.tcbService.request('UpdateAIModel', Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ EnvId: envId || EnvId, GroupName: groupName }, (baseUrl !== undefined ? { BaseUrl: baseUrl } : {})), (models !== undefined ? { Models: models } : {})), (remark !== undefined ? { Remark: remark } : {})), (status !== undefined ? { Status: status } : {})), (secret !== undefined ? { Secret: secret } : {})));
+    }
+    /**
+     * 删除 AI 模型配置分组，支持批量删除
+     */
+    async deleteAIModel(options) {
+        const { EnvId } = this.environment.lazyEnvironmentConfig;
+        const { envId, groupNames } = options;
+        if (!Array.isArray(groupNames) || groupNames.length === 0) {
+            throw new Error('groupNames is required');
+        }
+        const invalidGroupName = groupNames.find(item => typeof item !== 'string' || item.trim().length === 0);
+        if (invalidGroupName !== undefined) {
+            throw new Error('groupNames contains invalid item');
+        }
+        return this.tcbService.request('DeleteAIModel', {
+            EnvId: envId || EnvId,
+            GroupNames: groupNames
+        });
+    }
+    /**
+     * 查询指定云开发环境下已配置的 AI 模型分组列表
+     */
+    async describeAIModels(options = {}) {
+        const { EnvId } = this.environment.lazyEnvironmentConfig;
+        const { envId } = options;
+        return this.tcbService.request('DescribeAIModels', {
+            EnvId: envId || EnvId
+        });
+    }
+    /**
+     * 查询云开发平台支持的托管类型 AI 模型列表
+     */
+    async describeManagedAIModelList(options = {}) {
+        const { EnvId } = this.environment.lazyEnvironmentConfig;
+        const { envId } = options;
+        return this.tcbService.request('DescribeManagedAIModelList', {
+            EnvId: envId || EnvId
+        });
+    }
+}
+exports.AiModelService = AiModelService;
+__decorate([
+    (0, utils_1.preLazy)()
+], AiModelService.prototype, "createAIModel", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], AiModelService.prototype, "updateAIModel", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], AiModelService.prototype, "deleteAIModel", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], AiModelService.prototype, "describeAIModels", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], AiModelService.prototype, "describeManagedAIModelList", null);

package/lib/aiModel/type.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/environment.js

@@ -21,6 +21,7 @@ const mysql_1 = require("./mysql");
 const cloudApp_1 = require("./cloudApp");
 const permission_1 = require("./permission");
 const sandbox_1 = require("./sandbox");
+const aiModel_1 = require("./aiModel");
 class Environment {
     constructor(context, envId) {
         this.inited = false;
@@ -45,6 +46,7 @@ class Environment {
         this.permissionService = new permission_1.PermissionService(this);
         this.cloudAppService = new cloudApp_1.CloudAppService(this);
         this.sandboxService = new sandbox_1.SandboxService(this);
+        this.aiModelService = new aiModel_1.AiModelService(this);
     }
     async lazyInit() {
         if (!this.inited) {
@@ -116,6 +118,9 @@ class Environment {
     getSandboxService() {
         return this.sandboxService;
     }
+    getAiModelService() {
+        return this.aiModelService;
+    }
     getCommonService(serviceType = 'tcb', serviceVersion) {
         return new common_1.CommonService(this, serviceType, serviceVersion);
     }

package/lib/index.js

@@ -119,6 +119,9 @@ class CloudBase {
     get sandbox() {
         return this.currentEnvironment().getSandboxService();
     }
+    get aiModel() {
+        return this.currentEnvironment().getAiModelService();
+    }
     get docs() {
         if (!this.docsService) {
             this.docsService = new docs_1.DocsService();

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@cloudbase/manager-node",
-    "version": "5.2.0",
+    "version": "5.3.0",
     "description": "The node manage service api for cloudbase.",
     "main": "lib/index.js",
     "scripts": {

package/types/aiModel/index.d.ts

@@ -0,0 +1,27 @@
+import { Environment } from '../environment';
+import { CreateAIModelOptions, CreateAIModelResp, UpdateAIModelOptions, UpdateAIModelResp, DeleteAIModelOptions, DeleteAIModelResp, DescribeAIModelsOptions, DescribeAIModelsResp, DescribeManagedAIModelListOptions, DescribeManagedAIModelListResp } from './type';
+export declare class AiModelService {
+    private environment;
+    private tcbService;
+    constructor(environment: Environment);
+    /**
+     * 创建 AI 模型配置分组
+     */
+    createAIModel(options: CreateAIModelOptions): Promise<CreateAIModelResp>;
+    /**
+     * 更新 AI 模型配置分组
+     */
+    updateAIModel(options: UpdateAIModelOptions): Promise<UpdateAIModelResp>;
+    /**
+     * 删除 AI 模型配置分组，支持批量删除
+     */
+    deleteAIModel(options: DeleteAIModelOptions): Promise<DeleteAIModelResp>;
+    /**
+     * 查询指定云开发环境下已配置的 AI 模型分组列表
+     */
+    describeAIModels(options?: DescribeAIModelsOptions): Promise<DescribeAIModelsResp>;
+    /**
+     * 查询云开发平台支持的托管类型 AI 模型列表
+     */
+    describeManagedAIModelList(options?: DescribeManagedAIModelListOptions): Promise<DescribeManagedAIModelListResp>;
+}

package/types/aiModel/type.d.ts

@@ -0,0 +1,205 @@
+import { IResponseInfo } from '../interfaces';
+/** 模型状态，1：开启，2：关闭 */
+export type AIModelStatus = 1 | 2;
+/** AI 模型信息 */
+export interface AIModel {
+    /** 模型名，示例值：huanyuan-v1 */
+    Model?: string;
+    /** 是否开启 MCP，示例值：false */
+    EnableMCP?: boolean;
+    /** 标签 */
+    Tags?: string[];
+}
+/** AI 模型密钥信息 */
+export interface AIModelSecret {
+    /** 密钥来源，示例值：custom */
+    SecretSource?: string;
+    /** 密钥 ID，和 SecretKey 一一对应 */
+    SecretId?: string;
+    /** 密钥 Key，和 SecretId 一一对应 */
+    SecretKey?: string;
+    /** ApiKey，SecretKey 和 ApiKey 二选一 */
+    ApiKey?: string;
+}
+/** AI 模型分组类型 */
+export type AIModelGroupType = 'builtin' | 'custom';
+/** AI 模型分组信息 */
+export interface AIModelGroup {
+    /**
+     * 模型分组
+     * 枚举值：
+     * - hunyuan-exp
+     * - hunyuan-image
+     * - deepseek
+     * - cloudbase
+     * - custom-xxxx
+     */
+    GroupName?: string;
+    /**
+     * 模型列表
+     * 注意：此字段可能返回 null，表示取不到有效值
+     */
+    Models?: AIModel[] | null;
+    /** 模型类型：builtin 内置模型分组类别，custom 用户自定义模型分组类别 */
+    Type?: AIModelGroupType;
+    /** 原始模型类型：builtin 内置模型类型，custom 用户自定义模型类型 */
+    OriginType?: AIModelGroupType;
+    /** 备注 */
+    Remark?: string;
+    /** 模型地址 */
+    BaseUrl?: string;
+    /** 模型状态，1：开启，2：关闭 */
+    Status?: AIModelStatus;
+    /**
+     * 模型密钥
+     * 注意：此字段可能返回 null，表示取不到有效值
+     */
+    Secret?: AIModelSecret | null;
+    /** 创建时间，ISO8601 格式 */
+    CreateTime?: string;
+    /** 更新时间，ISO8601 格式 */
+    UpdateTime?: string;
+}
+/** 托管 AI 模型计费类型 */
+export type ManagedAIModelChargingType = 'Uniform' | 'Tiered';
+/** 托管 AI 模型参数规格 */
+export interface ManagedAIModelSpec {
+    /** 最大输入 Token，示例值：192k */
+    MaxInputToken?: string;
+    /** 最大输出 Token，示例值：32k */
+    MaxOutputToken?: string;
+    /** 上下文长度，示例值：128k */
+    ContextLength?: string;
+}
+/** 托管 AI 模型计费信息 */
+export interface ManagedAIModelChargingInfo {
+    /** 计费类型：Uniform 固定计费，Tiered 分段计费 */
+    Type?: ManagedAIModelChargingType;
+    /** 分组名称，示例值：0-16k */
+    Name?: string;
+    /** 输入 Token 价格，示例值：1.2 */
+    InputPrice?: string;
+    /** 输出 Token 价格，示例值：4 */
+    OutputPrice?: string;
+    /** 命中缓存价格，示例值：0.4 */
+    CachePrice?: string;
+    /** 计费单位，示例值：千tokens */
+    InputOutputUnit?: string;
+}
+/** 托管型 AI 模型信息 */
+export interface ManagedAIModel {
+    /** 模型名，示例值：hy3-preview */
+    Model?: string;
+    /** 是否开启 MCP，示例值：true */
+    EnableMCP?: boolean;
+    /** 模型规格 */
+    ModelSpec?: ManagedAIModelSpec;
+    /** 模型计费信息 */
+    ModelChargingInfo?: ManagedAIModelChargingInfo[];
+}
+/** 云开发内置 AI 模型分组信息 */
+export interface ManagedAIModelGroup {
+    /** 模型分组，示例值：cloudbase */
+    GroupName?: string;
+    /**
+     * 模型列表
+     * 注意：此字段可能返回 null，表示取不到有效值
+     */
+    Models?: ManagedAIModel[] | null;
+    /** 备注，示例值：腾讯云开发 */
+    Remark?: string;
+}
+/**
+ * CreateAIModel 用户入参
+ */
+export interface CreateAIModelOptions {
+    /** 环境 ID。不传则使用当前环境 ID */
+    envId?: string;
+    /**
+     * 分组名
+     * 入参限制：不允许以 cloudbase 为前缀
+     */
+    groupName: string;
+    /** 模型服务地址，示例值：http://xxx */
+    baseUrl?: string;
+    /** 模型名列表 */
+    models?: AIModel[];
+    /** 分组备注 */
+    remark?: string;
+    /** 模型状态，1：开启，2：关闭 */
+    status?: AIModelStatus;
+    /** 模型密钥 */
+    secret?: AIModelSecret;
+}
+/** CreateAIModel 返回结果 */
+export interface CreateAIModelResp extends IResponseInfo {
+    /** 创建数量 */
+    Count: number;
+}
+/**
+ * UpdateAIModel 用户入参
+ */
+export interface UpdateAIModelOptions {
+    /** 环境 ID。不传则使用当前环境 ID */
+    envId?: string;
+    /** 分组名 */
+    groupName: string;
+    /** 模型地址，示例值：http://xxx */
+    baseUrl?: string;
+    /**
+     * 模型名列表
+     * 注意：Models 列表更新采用全量替换
+     */
+    models?: AIModel[];
+    /** 备注 */
+    remark?: string;
+    /** 模型状态，1：开启，2：关闭 */
+    status?: AIModelStatus;
+    /** 模型密钥 */
+    secret?: AIModelSecret;
+}
+/** UpdateAIModel 返回结果 */
+export interface UpdateAIModelResp extends IResponseInfo {
+    /** 更新数量 */
+    Count: number;
+}
+/**
+ * DeleteAIModel 用户入参
+ */
+export interface DeleteAIModelOptions {
+    /** 环境 ID。不传则使用当前环境 ID */
+    envId?: string;
+    /** 分组名列表 */
+    groupNames: string[];
+}
+/** DeleteAIModel 返回结果 */
+export interface DeleteAIModelResp extends IResponseInfo {
+    /** 成功删除数量 */
+    Count: number;
+}
+/** DescribeAIModels 用户入参 */
+export interface DescribeAIModelsOptions {
+    /** 环境 ID。不传则使用当前环境 ID */
+    envId?: string;
+}
+/** DescribeAIModels 返回结果 */
+export interface DescribeAIModelsResp extends IResponseInfo {
+    /**
+     * 模型列表
+     * 注意：此字段可能返回 null，表示取不到有效值
+     */
+    AIModels: AIModelGroup[] | null;
+}
+/** DescribeManagedAIModelList 用户入参 */
+export interface DescribeManagedAIModelListOptions {
+    /** 环境 ID。不传则使用当前环境 ID */
+    envId?: string;
+}
+/** DescribeManagedAIModelList 返回结果 */
+export interface DescribeManagedAIModelListResp extends IResponseInfo {
+    /**
+     * 托管模型列表
+     * 注意：此字段可能返回 null，表示取不到有效值
+     */
+    ManagedAIModelList: ManagedAIModelGroup[] | null;
+}

package/types/environment.d.ts

@@ -17,6 +17,7 @@ import { CloudAppService } from './cloudApp';
 import { EnvInfo } from './interfaces';
 import { PermissionService } from './permission';
 import { SandboxService } from './sandbox';
+import { AiModelService } from './aiModel';
 export declare class Environment {
     inited: boolean;
     cloudBaseContext: CloudBaseContext;
@@ -39,6 +40,7 @@ export declare class Environment {
     private permissionService;
     private cloudAppService;
     private sandboxService;
+    private aiModelService;
     constructor(context: CloudBaseContext, envId: string);
     lazyInit(): Promise<any>;
     getEnvId(): string;
@@ -59,6 +61,7 @@ export declare class Environment {
     getCloudAppService(): CloudAppService;
     getPermissionService(): PermissionService;
     getSandboxService(): SandboxService;
+    getAiModelService(): AiModelService;
     getCommonService(serviceType: string, serviceVersion: any): CommonService;
     getServicesEnvInfo(): Promise<any>;
     getAuthConfig(): {

package/types/index.d.ts

@@ -18,6 +18,7 @@ import { DocsService } from './docs';
 import { PermissionService } from './permission';
 import { SandboxService } from './sandbox';
 import { CloudAppService } from './cloudApp';
+import { AiModelService } from './aiModel';
 interface CloudBaseConfig {
     secretId?: string;
     secretKey?: string;
@@ -82,6 +83,7 @@ declare class CloudBase {
     get user(): UserService;
     get permission(): PermissionService;
     get sandbox(): SandboxService;
+    get aiModel(): AiModelService;
     get docs(): DocsService;
     getEnvironmentManager(): EnvironmentManager;
     getManagerConfig(): CloudBaseConfig;