@alicloud/aidge20260428 5.5.0 → 5.7.0

package/src/models/AiTryOnRequest.ts

@@ -0,0 +1,61 @@
+// This file is auto-generated, don't edit it
+import * as $dara from '@darabonba/typescript';
+
+
+export class AiTryOnRequest extends $dara.Model {
+  /**
+   * @remarks
+   * This parameter is required.
+   * 
+   * @example
+   * https://example.com/cloth.png
+   */
+  clothImageUrl?: string;
+  /**
+   * @example
+   * tops
+   */
+  clothType?: string;
+  /**
+   * @remarks
+   * This parameter is required.
+   * 
+   * @example
+   * https://example.com/model.png
+   */
+  modelImageUrl?: string;
+  /**
+   * @remarks
+   * This parameter is required.
+   * 
+   * @example
+   * 1K
+   */
+  resolution?: string;
+  static names(): { [key: string]: string } {
+    return {
+      clothImageUrl: 'ClothImageUrl',
+      clothType: 'ClothType',
+      modelImageUrl: 'ModelImageUrl',
+      resolution: 'Resolution',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      clothImageUrl: 'string',
+      clothType: 'string',
+      modelImageUrl: 'string',
+      resolution: 'string',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+

package/src/models/AiTryOnResponse.ts

@@ -0,0 +1,40 @@
+// This file is auto-generated, don't edit it
+import * as $dara from '@darabonba/typescript';
+import { AiTryOnResponseBody } from "./AiTryOnResponseBody";
+
+
+export class AiTryOnResponse extends $dara.Model {
+  headers?: { [key: string]: string };
+  statusCode?: number;
+  body?: AiTryOnResponseBody;
+  static names(): { [key: string]: string } {
+    return {
+      headers: 'headers',
+      statusCode: 'statusCode',
+      body: 'body',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      headers: { 'type': 'map', 'keyType': 'string', 'valueType': 'string' },
+      statusCode: 'number',
+      body: AiTryOnResponseBody,
+    };
+  }
+
+  validate() {
+    if(this.headers) {
+      $dara.Model.validateMap(this.headers);
+    }
+    if(this.body && typeof (this.body as any).validate === 'function') {
+      (this.body as any).validate();
+    }
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+

package/src/models/AiTryOnResponseBody.ts

@@ -0,0 +1,145 @@
+// This file is auto-generated, don't edit it
+import * as $dara from '@darabonba/typescript';
+
+
+/**
+ */
+export class AiTryOnResponseBodyDataUsageMap extends $dara.Model {
+  /**
+   * @example
+   * 1
+   */
+  processedImageCount?: number;
+  /**
+   * @example
+   * 1K
+   */
+  resolution?: string;
+  static names(): { [key: string]: string } {
+    return {
+      processedImageCount: 'ProcessedImageCount',
+      resolution: 'Resolution',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      processedImageCount: 'number',
+      resolution: 'string',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
+export class AiTryOnResponseBodyData extends $dara.Model {
+  /**
+   * @example
+   * 1360
+   */
+  imageHeight?: string;
+  /**
+   * @example
+   * https://example.com/virtual-try-on-result.png
+   */
+  imageUrl?: string;
+  /**
+   * @example
+   * 768
+   */
+  imageWidth?: string;
+  /**
+   * @example
+   * {"ProcessedImageCount":1,"Resolution":"1K"}
+   */
+  usageMap?: AiTryOnResponseBodyDataUsageMap;
+  static names(): { [key: string]: string } {
+    return {
+      imageHeight: 'ImageHeight',
+      imageUrl: 'ImageUrl',
+      imageWidth: 'ImageWidth',
+      usageMap: 'UsageMap',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      imageHeight: 'string',
+      imageUrl: 'string',
+      imageWidth: 'string',
+      usageMap: AiTryOnResponseBodyDataUsageMap,
+    };
+  }
+
+  validate() {
+    if(this.usageMap && typeof (this.usageMap as any).validate === 'function') {
+      (this.usageMap as any).validate();
+    }
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
+export class AiTryOnResponseBody extends $dara.Model {
+  /**
+   * @example
+   * 200
+   */
+  code?: string;
+  data?: AiTryOnResponseBodyData;
+  /**
+   * @example
+   * OK
+   */
+  message?: string;
+  /**
+   * @example
+   * 2728332e-72c1-9c0d-8869-5781b2cd25d4
+   */
+  requestId?: string;
+  /**
+   * @example
+   * True
+   */
+  success?: boolean;
+  static names(): { [key: string]: string } {
+    return {
+      code: 'Code',
+      data: 'Data',
+      message: 'Message',
+      requestId: 'RequestId',
+      success: 'Success',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      code: 'string',
+      data: AiTryOnResponseBodyData,
+      message: 'string',
+      requestId: 'string',
+      success: 'boolean',
+    };
+  }
+
+  validate() {
+    if(this.data && typeof (this.data as any).validate === 'function') {
+      (this.data as any).validate();
+    }
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+

package/src/models/AssetOptimizeLiteRequest.ts

@@ -8,7 +8,7 @@ export class AssetOptimizeLiteRequest extends $dara.Model {
    * The custom glossary for term intervention.
    * 
    * @example
-   * test
+   * Test
    */
   glossary?: string;
   /**
@@ -21,7 +21,7 @@ export class AssetOptimizeLiteRequest extends $dara.Model {
   includingProductArea?: boolean;
   /**
    * @remarks
-   * Specifies whether translation is needed.
+   * Specifies whether translation is required.
    * 
    * This parameter is required.
    * 

package/src/models/AssetOptimizeLiteResponseBody.ts

@@ -2,12 +2,10 @@
 import * as $dara from '@darabonba/typescript';
 
 
-/**
- */
 export class AssetOptimizeLiteResponseBodyData extends $dara.Model {
   /**
    * @remarks
-   * The asynchronous task ID, used to query results later.
+   * The asynchronous task ID, which is used to query the result later.
    * 
    * @example
    * task-xxxxxx

package/src/models/AssetOptimizeProRequest.ts

@@ -13,7 +13,7 @@ export class AssetOptimizeProRequest extends $dara.Model {
   columnNameList?: string[];
   /**
    * @remarks
-   * The glossary ID. Optional. Create a glossary separately in the console and provide its ID. If empty, translation results are not modified.
+   * The glossary ID. Optional. Create a glossary in the console and provide its ID. If left empty, translation results are not modified by any glossary.
    * 
    * @example
    * glossary_1
@@ -21,7 +21,7 @@ export class AssetOptimizeProRequest extends $dara.Model {
   glossary?: string;
   /**
    * @remarks
-   * Specifies whether to translate text on the product subject area in images. Setting this to false helps protect embedded information such as product names from being translated. Default value: false.
+   * Specifies whether to translate text on the product subject area of images. Setting this to false helps protect embedded information such as product names from being translated. Default value: false.
    * 
    * @example
    * false
@@ -57,7 +57,7 @@ export class AssetOptimizeProRequest extends $dara.Model {
   productUrl?: string;
   /**
    * @remarks
-   * The source language code. Optional. Refer to the supported language pairs list for available language directions. Required if NeedTrans is set to true.
+   * The source language code. Optional. For supported language pairs, refer to the supported translation language list. This parameter is required if NeedTrans is set to true.
    * 
    * @example
    * zh
@@ -75,7 +75,7 @@ export class AssetOptimizeProRequest extends $dara.Model {
   sourcePlatform?: string;
   /**
    * @remarks
-   * The target language code. Optional. Refer to the supported language pairs list for available language directions. Required if NeedTrans is set to true.
+   * The target language code. Optional. For supported language pairs, refer to the supported translation language list. This parameter is required if NeedTrans is set to true.
    * 
    * @example
    * en
@@ -101,7 +101,7 @@ export class AssetOptimizeProRequest extends $dara.Model {
   threshold?: number;
   /**
    * @remarks
-   * Specifies whether to translate brand names in images. Optional. Default value: false. Setting this to false helps protect brand name information from being translated.
+   * Specifies whether to translate brand names on images. Optional. Default value: false. Setting this to false helps protect brand name information from being translated.
    * 
    * @example
    * false

package/src/models/AssetOptimizeProResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class AssetOptimizeProResponseBodyData extends $dara.Model {
   /**
    * @remarks
-   * The asynchronous task ID, used to query processing results through QueryAsyncTaskResult.
+   * The asynchronous task ID. Use this ID to query the processing result by calling QueryAsyncTaskResult.
    * 
    * @example
    * 8080345d-b28a-9e2e-9ad7-370f8e236949
@@ -43,7 +43,7 @@ export class AssetOptimizeProResponseBody extends $dara.Model {
   code?: string;
   /**
    * @remarks
-   * The asynchronous task submission result data, which contains the asynchronous task ID.
+   * The submit result of the asynchronous task, which contains the asynchronous task ID.
    */
   data?: AssetOptimizeProResponseBodyData;
   /**
@@ -56,7 +56,7 @@ export class AssetOptimizeProResponseBody extends $dara.Model {
   message?: string;
   /**
    * @remarks
-   * The request ID, used to uniquely identify a single API call.
+   * The request ID, which uniquely identifies the request.
    * 
    * @example
    * 4FCCA90A-A7A4-1D37-88C3-C17549886E70
@@ -64,7 +64,7 @@ export class AssetOptimizeProResponseBody extends $dara.Model {
   requestId?: string;
   /**
    * @remarks
-   * Indicates whether the call was successful. A value of true indicates success. A value of false indicates failure.
+   * Indicates whether the call is successful. A value of true indicates success. A value of false indicates failure.
    * 
    * @example
    * true

package/src/models/AssetOptimizeProShrinkRequest.ts

@@ -13,7 +13,7 @@ export class AssetOptimizeProShrinkRequest extends $dara.Model {
   columnNameListShrink?: string;
   /**
    * @remarks
-   * The glossary ID. Optional. Create a glossary separately in the console and provide its ID. If empty, translation results are not modified.
+   * The glossary ID. Optional. Create a glossary in the console and provide its ID. If left empty, translation results are not modified by any glossary.
    * 
    * @example
    * glossary_1
@@ -21,7 +21,7 @@ export class AssetOptimizeProShrinkRequest extends $dara.Model {
   glossary?: string;
   /**
    * @remarks
-   * Specifies whether to translate text on the product subject area in images. Setting this to false helps protect embedded information such as product names from being translated. Default value: false.
+   * Specifies whether to translate text on the product subject area of images. Setting this to false helps protect embedded information such as product names from being translated. Default value: false.
    * 
    * @example
    * false
@@ -57,7 +57,7 @@ export class AssetOptimizeProShrinkRequest extends $dara.Model {
   productUrl?: string;
   /**
    * @remarks
-   * The source language code. Optional. Refer to the supported language pairs list for available language directions. Required if NeedTrans is set to true.
+   * The source language code. Optional. For supported language pairs, refer to the supported translation language list. This parameter is required if NeedTrans is set to true.
    * 
    * @example
    * zh
@@ -75,7 +75,7 @@ export class AssetOptimizeProShrinkRequest extends $dara.Model {
   sourcePlatform?: string;
   /**
    * @remarks
-   * The target language code. Optional. Refer to the supported language pairs list for available language directions. Required if NeedTrans is set to true.
+   * The target language code. Optional. For supported language pairs, refer to the supported translation language list. This parameter is required if NeedTrans is set to true.
    * 
    * @example
    * en
@@ -101,7 +101,7 @@ export class AssetOptimizeProShrinkRequest extends $dara.Model {
   threshold?: number;
   /**
    * @remarks
-   * Specifies whether to translate brand names in images. Optional. Default value: false. Setting this to false helps protect brand name information from being translated.
+   * Specifies whether to translate brand names on images. Optional. Default value: false. Setting this to false helps protect brand name information from being translated.
    * 
    * @example
    * false

package/src/models/CategoryAttributeMatchRequest.ts

@@ -13,7 +13,7 @@ export class CategoryAttributeMatchRequest extends $dara.Model {
   description?: string;
   /**
    * @remarks
-   * The product image URLs (up to 10 images are supported).
+   * The product image URLs. A maximum of 10 images are supported.
    * 
    * @example
    * https://frametour-assets.oss-cn-shanghai.aliyuncs.com/user-faces/viid_face/dd0dd06c-9351-4e5f-bc70-24166a754d7f.jpg
@@ -36,7 +36,7 @@ export class CategoryAttributeMatchRequest extends $dara.Model {
    * This parameter is required.
    * 
    * @example
-   * 0:0:颜色:黑(不含定位器);0:1:颜色:智能定位(不含项圈);0:2:颜色:范围定位(不含项圈);0:3:颜色:蓝(不含定位器);0:4:颜色:橙(不含定位器);0:5:颜色:粉(不含定位器);0:6:颜色:红(不含定位器);0:7:颜色:黄(不含定位器);0:8:颜色:紫(不含定位器)
+   * 0:0:Color:Black (without locator);0:1:Color:Smart Locator (without collar);0:2:Color:Range Locator (without collar);0:3:Color:Blue (without locator);0:4:Color:Orange (without locator);0:5:Color:Pink (without locator);0:6:Color:Red (without locator);0:7:Color:Yellow (without locator);0:8:Color:Purple (without locator)
    */
   sku?: string;
   /**
@@ -51,7 +51,7 @@ export class CategoryAttributeMatchRequest extends $dara.Model {
   sourceCategory?: string;
   /**
    * @remarks
-   * The source platform where the product originates.
+   * The source platform from which the product originates.
    * 
    * This parameter is required.
    * 
@@ -61,7 +61,7 @@ export class CategoryAttributeMatchRequest extends $dara.Model {
   sourcePlatform?: string;
   /**
    * @remarks
-   * The target listing platform. Currently only temu is supported.
+   * The target listing platform. Currently, only temu is supported.
    * 
    * This parameter is required.
    * 
@@ -76,7 +76,7 @@ export class CategoryAttributeMatchRequest extends $dara.Model {
    * This parameter is required.
    * 
    * @example
-   * Women\\"s new spring clothing
+   * Women\\"s New Spring Clothing
    */
   title?: string;
   static names(): { [key: string]: string } {

package/src/models/CategoryAttributeMatchResponseBody.ts

@@ -24,7 +24,7 @@ export class CategoryAttributeMatchResponseBodyDataAttributes extends $dara.Mode
    * The attribute input type.
    * 
    * @example
-   * 单选下拉
+   * Single-select dropdown
    */
   inputType?: string;
   /**
@@ -161,7 +161,7 @@ export class CategoryAttributeMatchResponseBodyData extends $dara.Model {
    * The category name.
    * 
    * @example
-   * 猫项圈
+   * Cat Collars
    */
   categoryName?: string;
   /**
@@ -169,7 +169,7 @@ export class CategoryAttributeMatchResponseBodyData extends $dara.Model {
    * The full path of the category, separated by "/".
    * 
    * @example
-   * 宠物用品/猫用品/猫挂饰、项圈、牵引带/猫项圈
+   * Pet Supplies/Cat Supplies/Cat Charms, Collars & Leashes/Cat Collars
    */
   categoryPath?: string;
   /**
@@ -198,7 +198,7 @@ export class CategoryAttributeMatchResponseBodyData extends $dara.Model {
   totalAttributes?: number;
   /**
    * @remarks
-   * The usage information.
+   * The usage fields.
    */
   usageMap?: CategoryAttributeMatchResponseBodyDataUsageMap;
   static names(): { [key: string]: string } {
@@ -253,7 +253,7 @@ export class CategoryAttributeMatchResponseBody extends $dara.Model {
   code?: string;
   /**
    * @remarks
-   * The response data.
+   * The returned result.
    */
   data?: CategoryAttributeMatchResponseBodyData;
   /**

package/src/models/CategoryAttributeMatchShrinkRequest.ts

@@ -13,7 +13,7 @@ export class CategoryAttributeMatchShrinkRequest extends $dara.Model {
   description?: string;
   /**
    * @remarks
-   * The product image URLs (up to 10 images are supported).
+   * The product image URLs. A maximum of 10 images are supported.
    * 
    * @example
    * https://frametour-assets.oss-cn-shanghai.aliyuncs.com/user-faces/viid_face/dd0dd06c-9351-4e5f-bc70-24166a754d7f.jpg
@@ -36,7 +36,7 @@ export class CategoryAttributeMatchShrinkRequest extends $dara.Model {
    * This parameter is required.
    * 
    * @example
-   * 0:0:颜色:黑(不含定位器);0:1:颜色:智能定位(不含项圈);0:2:颜色:范围定位(不含项圈);0:3:颜色:蓝(不含定位器);0:4:颜色:橙(不含定位器);0:5:颜色:粉(不含定位器);0:6:颜色:红(不含定位器);0:7:颜色:黄(不含定位器);0:8:颜色:紫(不含定位器)
+   * 0:0:Color:Black (without locator);0:1:Color:Smart Locator (without collar);0:2:Color:Range Locator (without collar);0:3:Color:Blue (without locator);0:4:Color:Orange (without locator);0:5:Color:Pink (without locator);0:6:Color:Red (without locator);0:7:Color:Yellow (without locator);0:8:Color:Purple (without locator)
    */
   sku?: string;
   /**
@@ -51,7 +51,7 @@ export class CategoryAttributeMatchShrinkRequest extends $dara.Model {
   sourceCategory?: string;
   /**
    * @remarks
-   * The source platform where the product originates.
+   * The source platform from which the product originates.
    * 
    * This parameter is required.
    * 
@@ -61,7 +61,7 @@ export class CategoryAttributeMatchShrinkRequest extends $dara.Model {
   sourcePlatform?: string;
   /**
    * @remarks
-   * The target listing platform. Currently only temu is supported.
+   * The target listing platform. Currently, only temu is supported.
    * 
    * This parameter is required.
    * 
@@ -76,7 +76,7 @@ export class CategoryAttributeMatchShrinkRequest extends $dara.Model {
    * This parameter is required.
    * 
    * @example
-   * Women\\"s new spring clothing
+   * Women\\"s New Spring Clothing
    */
   title?: string;
   static names(): { [key: string]: string } {

package/src/models/CategoryMatchRequest.ts

@@ -10,7 +10,7 @@ export class CategoryMatchRequest extends $dara.Model {
    * This parameter is required.
    * 
    * @example
-   * Silk, new spring style
+   * Silk, Spring New Arrival
    */
   description?: string;
   /**
@@ -18,15 +18,15 @@ export class CategoryMatchRequest extends $dara.Model {
    * The product attributes that describe the characteristics of the product, such as material. Provide the attribute names and values.
    * 
    * @example
-   * 材质:涤纶,适用对象:通用,品牌:艾马逊AMASON PET
+   * Material:Polyester,Target Audience:General,Brand:AMASON PET
    */
   itemSpec?: string;
   /**
    * @remarks
-   * The product SKU title.
+   * The SKU title of the product.
    * 
    * @example
-   * 0:0:颜色:黑(不含定位器);0:1:颜色:智能定位(不含项圈);0:2:颜色:范围定位(不含项圈);0:3:颜色:蓝(不含定位器);0:4:颜色:橙(不含定位器);0:5:颜色:粉(不含定位器);0:6:颜色:红(不含定位器);0:7:颜色:黄(不含定位器);0:8:颜色:紫(不含定位器)
+   * 0:0:Color:Black(without locator);0:1:Color:Smart Locator(without collar);0:2:Color:Range Locator(without collar);0:3:Color:Blue(without locator);0:4:Color:Orange(without locator);0:5:Color:Pink(without locator);0:6:Color:Red(without locator);0:7:Color:Yellow(without locator);0:8:Color:Purple(without locator)
    */
   sku?: string;
   /**
@@ -41,7 +41,7 @@ export class CategoryMatchRequest extends $dara.Model {
   sourceCategory?: string;
   /**
    * @remarks
-   * The source platform where products are sourced from.
+   * The source platform from which products are sourced.
    * 
    * This parameter is required.
    * 
@@ -51,7 +51,7 @@ export class CategoryMatchRequest extends $dara.Model {
   sourcePlatform?: string;
   /**
    * @remarks
-   * The target listing platform. Currently only temu is supported.
+   * The target listing platform. Currently, only temu is supported.
    * 
    * This parameter is required.
    * 
@@ -66,7 +66,7 @@ export class CategoryMatchRequest extends $dara.Model {
    * This parameter is required.
    * 
    * @example
-   * Women\\"s new spring clothing
+   * Women\\"s Spring New Arrival Clothing
    */
   title?: string;
   static names(): { [key: string]: string } {

package/src/models/CategoryMatchResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class CategoryMatchResponseBodyData extends $dara.Model {
   /**
    * @remarks
-   * The matched category ID.
+   * The ID of the matched category.
    * 
    * @example
    * 1522
@@ -13,7 +13,7 @@ export class CategoryMatchResponseBodyData extends $dara.Model {
   categoryId?: string;
   /**
    * @remarks
-   * The matched category name.
+   * The name of the matched category.
    * 
    * @example
    * 位置和活动跟踪器
@@ -21,7 +21,7 @@ export class CategoryMatchResponseBodyData extends $dara.Model {
   categoryName?: string;
   /**
    * @remarks
-   * The full path of the category, separated by "/".
+   * The full path of the category, separated by forward slashes (/).
    * 
    * @example
    * 宠物用品/猫用品/猫挂饰、项圈、牵引带/位置和活动跟踪器
@@ -29,7 +29,7 @@ export class CategoryMatchResponseBodyData extends $dara.Model {
   categoryPath?: string;
   /**
    * @remarks
-   * The matching confidence score, ranging from 0 to 100.
+   * The match confidence score. Valid values: 0 to 100.
    * 
    * @example
    * 96
@@ -37,7 +37,7 @@ export class CategoryMatchResponseBodyData extends $dara.Model {
   confidence?: number;
   /**
    * @remarks
-   * Indicates whether the matching is successful.
+   * Indicates whether the category matching is successful.
    * 
    * @example
    * true
@@ -45,10 +45,10 @@ export class CategoryMatchResponseBodyData extends $dara.Model {
   matchSuccessful?: boolean;
   /**
    * @remarks
-   * The explanation of the matching reason.
+   * The reason for the category match.
    * 
    * @example
-   * The product core is a cat collar with AirTag positioning function, belonging to the \\"Location and Activity Trackers\\" category, with leaf node semantics precisely matching its tracking function and cat-use attributes
+   * The core product is a cat collar with AirTag positioning functionality, belonging to the \\"Location and Activity Trackers\\" category. The leaf node semantically matches its tracking functionality and cat-use attributes precisely
    */
   reason?: string;
   /**
@@ -116,7 +116,7 @@ export class CategoryMatchResponseBody extends $dara.Model {
   message?: string;
   /**
    * @remarks
-   * The request ID, which uniquely identifies the API call.
+   * The request ID, which uniquely identifies the request.
    * 
    * @example
    * 2157065A-D6C8-1F3E-A4D0-B1234567890

package/src/models/DiduiAreaDeductionRequest.ts

@@ -73,7 +73,7 @@ export class DiduiAreaDeductionRequestProductsBoxes extends $dara.Model {
 export class DiduiAreaDeductionRequestProducts extends $dara.Model {
   /**
    * @remarks
-   * The detection boxes for the current SKU. Coordinate values range from 0 to 1000.
+   * The instance boxes for the current SKU. The coordinate range is 0 to 1000.
    * 
    * This parameter is required.
    */
@@ -124,7 +124,7 @@ export class DiduiAreaDeductionRequest extends $dara.Model {
   products?: DiduiAreaDeductionRequestProducts[];
   /**
    * @remarks
-   * The ID of the customer-specific SKU vector store that determines which store is used for retrieval. The store must be created in advance through the store creation process.
+   * The ID of the customer-specific SKU vector database that determines which database is used for recall. The database must be created in advance through the database creation process.
    * 
    * @example
    * rag_xxx