@alicloud/agentloop20260520 2.3.8 → 2.4.0

package/src/models/GetPipelineStatsResponseBody.ts

@@ -4,61 +4,97 @@ import * as $dara from '@darabonba/typescript';
 
 export class GetPipelineStatsResponseBodySummary extends $dara.Model {
   /**
+   * @remarks
+   * The average execution duration in milliseconds.
+   * 
    * @example
    * 2500
    */
   avgElapsedMs?: number;
   /**
+   * @remarks
+   * The number of cancelled runs.
+   * 
    * @example
    * 0
    */
   cancelledRuns?: number;
   /**
+   * @remarks
+   * The committed watermark in UNIX seconds.
+   * 
    * @example
    * 1735660800
    */
   committedWatermark?: number;
   /**
+   * @remarks
+   * The number of failed runs.
+   * 
    * @example
    * 0
    */
   failedRuns?: number;
   /**
+   * @remarks
+   * The schedule lag in seconds, calculated as the current time minus the watermark.
+   * 
    * @example
    * 120
    */
   scheduleLagSeconds?: number;
   /**
+   * @remarks
+   * The number of succeeded runs.
+   * 
    * @example
    * 44
    */
   succeededRuns?: number;
   /**
+   * @remarks
+   * The success rate, ranging from 0 to 1.
+   * 
    * @example
    * 1.0
    */
   successRate?: number;
   /**
+   * @remarks
+   * The total number of output bytes.
+   * 
    * @example
    * 3221225472
    */
   totalOutputBytes?: number;
   /**
+   * @remarks
+   * The total number of output rows.
+   * 
    * @example
    * 1200000
    */
   totalOutputRows?: number;
   /**
+   * @remarks
+   * The total number of processed bytes.
+   * 
    * @example
    * 5368709120
    */
   totalProcessedBytes?: number;
   /**
+   * @remarks
+   * The total number of processed rows.
+   * 
    * @example
    * 1500000
    */
   totalProcessedRows?: number;
   /**
+   * @remarks
+   * The total number of runs in the window.
+   * 
    * @example
    * 44
    */
@@ -108,41 +144,65 @@ export class GetPipelineStatsResponseBodySummary extends $dara.Model {
 
 export class GetPipelineStatsResponseBodyTimeSeries extends $dara.Model {
   /**
+   * @remarks
+   * The average execution duration in milliseconds.
+   * 
    * @example
    * 2500
    */
   avgElapsedMs?: number;
   /**
+   * @remarks
+   * The number of output bytes.
+   * 
    * @example
    * 322122547
    */
   outputBytes?: number;
   /**
+   * @remarks
+   * The number of output rows.
+   * 
    * @example
    * 80000
    */
   outputRows?: number;
   /**
+   * @remarks
+   * The number of processed bytes.
+   * 
    * @example
    * 536870912
    */
   processedBytes?: number;
   /**
+   * @remarks
+   * The number of processed rows.
+   * 
    * @example
    * 100000
    */
   processedRows?: number;
   /**
+   * @remarks
+   * The number of runs.
+   * 
    * @example
    * 5
    */
   runs?: number;
   /**
+   * @remarks
+   * The number of succeeded runs.
+   * 
    * @example
    * 5
    */
   succeededRuns?: number;
   /**
+   * @remarks
+   * The start timestamp of the time bucket in UNIX seconds.
+   * 
    * @example
    * 1735574400
    */
@@ -184,11 +244,17 @@ export class GetPipelineStatsResponseBodyTimeSeries extends $dara.Model {
 
 export class GetPipelineStatsResponseBody extends $dara.Model {
   /**
+   * @remarks
+   * The end time of the statistical window in UNIX seconds.
+   * 
    * @example
    * 1735660800
    */
   endTime?: number;
   /**
+   * @remarks
+   * The statistical granularity.
+   * 
    * @example
    * Hour
    */
@@ -203,18 +269,29 @@ export class GetPipelineStatsResponseBody extends $dara.Model {
   pipelineName?: string;
   /**
    * @remarks
-   * The request ID, which is used to locate the request during troubleshooting.
+   * The request ID used to locate the request during troubleshooting.
    * 
    * @example
    * 9ACFB10A-1B2C-3D4E-5F6G-7H8I9J0K1L2M
    */
   requestId?: string;
   /**
+   * @remarks
+   * The start time of the statistical window in UNIX seconds.
+   * 
    * @example
    * 1735574400
    */
   startTime?: number;
+  /**
+   * @remarks
+   * The aggregation summary.
+   */
   summary?: GetPipelineStatsResponseBodySummary;
+  /**
+   * @remarks
+   * The time series data.
+   */
   timeSeries?: GetPipelineStatsResponseBodyTimeSeries[];
   static names(): { [key: string]: string } {
     return {

package/src/models/IndexJsonKey.ts

@@ -5,9 +5,9 @@ import * as $dara from '@darabonba/typescript';
 export class IndexJsonKey extends $dara.Model {
   /**
    * @remarks
-   * Specifies whether the field contains Chinese characters. This parameter is required only when the **type** parameter is set to **text**. Valid values:
-   *   - true: The field contains Chinese characters.
-   *   - false: The field does not contain Chinese characters.
+   * Specifies whether Chinese characters are included. This parameter is required only when the **type** parameter is set to **text**. Valid values:
+   *   - true: Chinese characters are included.
+   *   - false: Chinese characters are not included.
    * 
    * @example
    * false

package/src/models/IndexKey.ts

@@ -6,9 +6,9 @@ import { IndexJsonKey } from "./IndexJsonKey";
 export class IndexKey extends $dara.Model {
   /**
    * @remarks
-   * Specifies whether Chinese is included. This parameter is required only when the **type** parameter is set to **text**. Valid values:
-   *   - true: Chinese is included.
-   *   - false: Chinese is not included.
+   * Specifies whether the field contains Chinese characters. This parameter is required only when the **type** parameter is set to **text**. Valid values:
+   * - true: The field contains Chinese characters.
+   * - false: The field does not contain Chinese characters.
    * 
    * @example
    * true
@@ -16,7 +16,7 @@ export class IndexKey extends $dara.Model {
   chn?: boolean;
   /**
    * @remarks
-   * The description.
+   * The field description.
    * 
    * @example
    * test
@@ -24,7 +24,7 @@ export class IndexKey extends $dara.Model {
   description?: string;
   /**
    * @remarks
-   * The field embedding type.
+   * The embedding type of the field.
    * 
    * @example
    * agentloop-embedding-v4
@@ -32,12 +32,15 @@ export class IndexKey extends $dara.Model {
   embedding?: string;
   /**
    * @remarks
-   * The JSON subfields. This parameter takes effect only when type is set to json.
+   * The JSON subfields. This property takes effect only when the type is set to json.
+   * 
+   * @example
+   * {"content":{"type":"text","chn":true}}
    */
   jsonKeys?: { [key: string]: IndexJsonKey };
   /**
    * @remarks
-   * The type.
+   * The field type.
    * 
    * @example
    * text

package/src/models/ListContextStoreApikeysRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class ListContextStoreAPIKeysRequest extends $dara.Model {
   /**
    * @remarks
-   * The maximum number of API keys to return. Default value: 20. Maximum value: 100.
+   * The maximum number of API keys to return in the current request. Default value: 20. Maximum value: 100.
    * 
    * @example
    * 20
@@ -13,7 +13,7 @@ export class ListContextStoreAPIKeysRequest extends $dara.Model {
   maxResults?: number;
   /**
    * @remarks
-   * The pagination token. Set this parameter to the nextToken value returned in the previous response to retrieve the next page. Do not specify this parameter for the first request.
+   * The pagination token. Pass the nextToken value from the previous response to retrieve the next page. Do not specify this parameter for the first request.
    * 
    * @example
    * MTIzNDU2Nzg5MA==

package/src/models/ListContextStoreApikeysResponseBody.ts

@@ -13,7 +13,7 @@ export class ListContextStoreAPIKeysResponseBodyResults extends $dara.Model {
   agentSpace?: string;
   /**
    * @remarks
-   * The full value of the API key. The plaintext value is returned only when the API key is created. In list scenarios, the value is masked based on business rules.
+   * The full value of the API key. The plaintext value is returned only when the API key is created. In list scenarios, the value is masked based on business conventions.
    * 
    * @example
    * sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
@@ -29,7 +29,7 @@ export class ListContextStoreAPIKeysResponseBodyResults extends $dara.Model {
   contextStoreName?: string;
   /**
    * @remarks
-   * The time when the API key was created, in ISO 8601 UTC format.
+   * The time when the API key was created. The time is in the ISO 8601 standard in the UTC format.
    * 
    * Use the UTC time format: yyyy-MM-ddTHH:mm:ssZ
    * 
@@ -77,7 +77,7 @@ export class ListContextStoreAPIKeysResponseBodyResults extends $dara.Model {
 export class ListContextStoreAPIKeysResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The maximum number of entries per page that was specified in the request. This value is echoed back.
+   * The maximum number of results per page specified in the request.
    * 
    * @example
    * 20
@@ -93,7 +93,7 @@ export class ListContextStoreAPIKeysResponseBody extends $dara.Model {
   nextToken?: string;
   /**
    * @remarks
-   * The request ID, which is used to locate and troubleshoot issues.
+   * The request ID, which is used to locate the request for troubleshooting.
    * 
    * @example
    * 9ACFB10A-1B2C-3D4E-5F6G-7H8I9J0K1L2M
@@ -106,7 +106,7 @@ export class ListContextStoreAPIKeysResponseBody extends $dara.Model {
   results?: ListContextStoreAPIKeysResponseBodyResults[];
   /**
    * @remarks
-   * The total number of API keys that match the query conditions.
+   * The total number of API keys that meet the query conditions.
    * 
    * @example
    * 3

package/src/models/ListContextStoresRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class ListContextStoresRequest extends $dara.Model {
   /**
    * @remarks
-   * Filters context stores by name. Exact match is supported. If this parameter is not specified, no filtering is applied.
+   * The name of the context store used for filtering. Exact match is supported. If this parameter is not specified, no filtering is performed.
    * 
    * @example
    * my-context-store
@@ -13,7 +13,7 @@ export class ListContextStoresRequest extends $dara.Model {
   contextStoreName?: string;
   /**
    * @remarks
-   * Filters context stores by type, such as experience or memory. If this parameter is not specified, no filtering is applied.
+   * The type of the context store used for filtering, such as experience or memory. If this parameter is not specified, no filtering is performed.
    * 
    * @example
    * experience
@@ -21,7 +21,7 @@ export class ListContextStoresRequest extends $dara.Model {
   contextType?: string;
   /**
    * @remarks
-   * The maximum number of context stores to return. Default value: 20. Maximum value: 100.
+   * The maximum number of context stores to return in the current request. Default value: 20. Maximum value: 100.
    * 
    * @example
    * 20
@@ -29,18 +29,27 @@ export class ListContextStoresRequest extends $dara.Model {
   maxResults?: number;
   /**
    * @remarks
-   * The pagination token. Set this parameter to the nextToken value returned in the previous response to retrieve the next page. Do not specify this parameter for the first request.
+   * The pagination token. To retrieve the next page, pass the nextToken value from the previous response. Do not specify this parameter for the first request.
    * 
    * @example
    * MTIzNDU2Nzg5MA==
    */
   nextToken?: string;
+  /**
+   * @remarks
+   * The memory data source type used for filtering, such as manual, trajectory, or dataset. If this parameter is not specified, no filtering is performed.
+   * 
+   * @example
+   * trajectory
+   */
+  sourceType?: string;
   static names(): { [key: string]: string } {
     return {
       contextStoreName: 'contextStoreName',
       contextType: 'contextType',
       maxResults: 'maxResults',
       nextToken: 'nextToken',
+      sourceType: 'sourceType',
     };
   }
 
@@ -50,6 +59,7 @@ export class ListContextStoresRequest extends $dara.Model {
       contextType: 'string',
       maxResults: 'number',
       nextToken: 'string',
+      sourceType: 'string',
     };
   }
 

package/src/models/ListContextStoresResponseBody.ts

@@ -42,12 +42,12 @@ export class ListContextStoresResponseBodyResults extends $dara.Model {
    * The description of the context store.
    * 
    * @example
-   * 我的上下文库
+   * My context store
    */
   description?: string;
   /**
    * @remarks
-   * The region ID of the context store.
+   * The ID of the region where the context store resides.
    * 
    * @example
    * cn-hangzhou
@@ -55,7 +55,7 @@ export class ListContextStoresResponseBodyResults extends $dara.Model {
   regionId?: string;
   /**
    * @remarks
-   * The list of service names. This parameter has a value only for context stores of the experience type. The service names are used together with the data source AgentSpace to locate trace data sources.
+   * The list of service names. This parameter has a value only for the experience type. It is used together with the data source AgentSpace to locate the trace data source.
    * 
    * @example
    * ["order-service","payment-service"]
@@ -63,12 +63,28 @@ export class ListContextStoresResponseBodyResults extends $dara.Model {
   serviceNames?: string[];
   /**
    * @remarks
-   * The status of the context store. Valid values: ACTIVE, INITIALIZING, and FAILED.
+   * The memory data source type, such as manual, trajectory, or dataset. This parameter has a value only for the memory type.
+   * 
+   * @example
+   * trajectory
+   */
+  sourceType?: string;
+  /**
+   * @remarks
+   * The status of the context store. Valid values include ACTIVE, INITIALIZING, and FAILED.
    * 
    * @example
    * ACTIVE
    */
   status?: string;
+  /**
+   * @remarks
+   * The memory storage mode, such as event or upsert. This parameter has a value only for the memory type.
+   * 
+   * @example
+   * upsert
+   */
+  storageMode?: string;
   /**
    * @remarks
    * The time when the context store was last updated, in ISO 8601 UTC format.
@@ -88,7 +104,9 @@ export class ListContextStoresResponseBodyResults extends $dara.Model {
       description: 'description',
       regionId: 'regionId',
       serviceNames: 'serviceNames',
+      sourceType: 'sourceType',
       status: 'status',
+      storageMode: 'storageMode',
       updateTime: 'updateTime',
     };
   }
@@ -102,7 +120,9 @@ export class ListContextStoresResponseBodyResults extends $dara.Model {
       description: 'string',
       regionId: 'string',
       serviceNames: { 'type': 'array', 'itemType': 'string' },
+      sourceType: 'string',
       status: 'string',
+      storageMode: 'string',
       updateTime: 'string',
     };
   }
@@ -122,7 +142,7 @@ export class ListContextStoresResponseBodyResults extends $dara.Model {
 export class ListContextStoresResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The maximum number of entries per page that was specified in the request. This value is echoed back.
+   * The maximum number of results per page specified in the request.
    * 
    * @example
    * 20
@@ -130,7 +150,7 @@ export class ListContextStoresResponseBody extends $dara.Model {
   maxResults?: number;
   /**
    * @remarks
-   * The token for the next page. An empty string indicates that the current page is the last page.
+   * The token for the next page. An empty string indicates that the last page is reached.
    * 
    * @example
    * MTIzNDU2Nzg5MA==
@@ -138,7 +158,7 @@ export class ListContextStoresResponseBody extends $dara.Model {
   nextToken?: string;
   /**
    * @remarks
-   * The request ID. You can use this ID to locate and troubleshoot issues.
+   * The request ID, which can be used to locate the request during troubleshooting.
    * 
    * @example
    * 9ACFB10A-1B2C-3D4E-5F6G-7H8I9J0K1L2M
@@ -151,7 +171,7 @@ export class ListContextStoresResponseBody extends $dara.Model {
   results?: ListContextStoresResponseBodyResults[];
   /**
    * @remarks
-   * The total number of context stores that match the query conditions.
+   * The total number of context stores that meet the query conditions.
    * 
    * @example
    * 5

package/src/models/ListDatasetsRequest.ts

@@ -5,12 +5,16 @@ import * as $dara from '@darabonba/typescript';
 export class ListDatasetsRequest extends $dara.Model {
   /**
    * @remarks
-   * The dataset name.
+   * The name of the dataset.
    * 
    * @example
    * product_faq_dataset
    */
   datasetName?: string;
+  /**
+   * @remarks
+   * Filters datasets by labels.
+   */
   labels?: { [key: string]: string[] };
   /**
    * @remarks
@@ -22,7 +26,7 @@ export class ListDatasetsRequest extends $dara.Model {
   maxResults?: number;
   /**
    * @remarks
-   * The pagination token. You do not need to set this parameter for the first request. For subsequent requests, set this parameter to the nextToken value returned in the previous response.
+   * The next token. You do not need to set this parameter for the first request. For subsequent requests, pass the nextToken value returned in the previous response.
    * 
    * @example
    * RsfoUqpOJd5nd0F1e4OquY/7dKNGp1JMgsKtvCagmtY=

package/src/models/ListDatasetsResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class ListDatasetsResponseBodyDatasets extends $dara.Model {
   /**
    * @remarks
-   * The agent space name.
+   * The name of the agent workspace.
    * 
    * @example
    * sop-agent
@@ -23,7 +23,7 @@ export class ListDatasetsResponseBodyDatasets extends $dara.Model {
   createTime?: string;
   /**
    * @remarks
-   * The dataset name.
+   * The name of the dataset.
    * 
    * @example
    * product_faq_dataset
@@ -31,13 +31,21 @@ export class ListDatasetsResponseBodyDatasets extends $dara.Model {
   datasetName?: string;
   /**
    * @remarks
-   * The dataset description.
+   * The description of the dataset.
    * 
    * @example
    * Product FAQ dataset for semantic search
    */
   description?: string;
+  /**
+   * @remarks
+   * Indicates whether the dataset is added to favorites.
+   */
   isFavorite?: boolean;
+  /**
+   * @remarks
+   * The labels of the dataset.
+   */
   labels?: { [key: string]: string[] };
   /**
    * @remarks
@@ -103,7 +111,7 @@ export class ListDatasetsResponseBody extends $dara.Model {
   datasets?: ListDatasetsResponseBodyDatasets[];
   /**
    * @remarks
-   * The maximum number of results specified in this request.
+   * The maximum number of entries returned for this request.
    * 
    * @example
    * 100
@@ -111,9 +119,9 @@ export class ListDatasetsResponseBody extends $dara.Model {
   maxResults?: number;
   /**
    * @remarks
-   * The token for the next page of results.
+   * The token for the next page of query results.
    * 
-   * If the total number of results exceeds the maxResults limit, the data is truncated. You can use nextToken to query the next page of data.
+   * If the total number of returned results exceeds the maxResults limit, the data is truncated. You can use nextToken to query the next page of data.
    * 
    * @example
    * umaQfI7x758Ns4TgWrj8yA3fYlnk7dJgsfhMrSViRY8=

package/src/models/ListDatasetsShrinkRequest.ts

@@ -5,12 +5,16 @@ import * as $dara from '@darabonba/typescript';
 export class ListDatasetsShrinkRequest extends $dara.Model {
   /**
    * @remarks
-   * The dataset name.
+   * The name of the dataset.
    * 
    * @example
    * product_faq_dataset
    */
   datasetName?: string;
+  /**
+   * @remarks
+   * Filters datasets by labels.
+   */
   labelsShrink?: string;
   /**
    * @remarks
@@ -22,7 +26,7 @@ export class ListDatasetsShrinkRequest extends $dara.Model {
   maxResults?: number;
   /**
    * @remarks
-   * The pagination token. You do not need to set this parameter for the first request. For subsequent requests, set this parameter to the nextToken value returned in the previous response.
+   * The next token. You do not need to set this parameter for the first request. For subsequent requests, pass the nextToken value returned in the previous response.
    * 
    * @example
    * RsfoUqpOJd5nd0F1e4OquY/7dKNGp1JMgsKtvCagmtY=