@alicloud/agentloop20260520 2.4.2 → 2.4.4

package/src/models/CreateContextStoreRequest.ts

@@ -13,7 +13,7 @@ export class CreateContextStoreRequestConfigAudit extends $dara.Model {
   droppedCandidates?: boolean;
   /**
    * @remarks
-   * The logging mode for recall queries. Valid values: raw (plaintext) and hash (HMAC only). Default value: raw.
+   * The recording mode for recall queries. Valid values: raw (plaintext) and hash (HMAC only). Default value: raw.
    * 
    * @example
    * raw
@@ -55,7 +55,7 @@ export class CreateContextStoreRequestConfigAudit extends $dara.Model {
 export class CreateContextStoreRequestConfigExtractionPoliciesModel extends $dara.Model {
   /**
    * @remarks
-   * The name of the extraction model. Currently, only qwen3.8-flash is supported, which uses internal platform credentials.
+   * The name of the extraction model. Currently, only qwen3.8-flash is supported. Platform internal credentials are used.
    * 
    * @example
    * qwen3.8-flash
@@ -84,36 +84,57 @@ export class CreateContextStoreRequestConfigExtractionPoliciesModel extends $dar
 
 export class CreateContextStoreRequestConfigExtractionPoliciesStoragePolicy extends $dara.Model {
   /**
+   * @remarks
+   * The allowed storage actions. Default value: all actions (ADD, UPDATE, MERGE, and DELETE).
+   * 
    * @example
    * ["ADD","UPDATE","MERGE","DELETE"]
    */
   allowedActions?: string[];
   /**
+   * @remarks
+   * Specifies whether to enable deduplication in event mode. Default value: true.
+   * 
    * @example
    * true
    */
   dedupe?: boolean;
   /**
+   * @remarks
+   * Specifies whether to enable human edit protection. Default value: true. When enabled, automatic extraction does not overwrite manually modified memories.
+   * 
    * @example
    * true
    */
   humanEditProtection?: boolean;
   /**
+   * @remarks
+   * The merge key for upsert operations. Valid values: factKey, semantic, and both. Default value: semantic.
+   * 
    * @example
    * semantic
    */
   mergeKey?: string;
   /**
+   * @remarks
+   * The storage mode. Valid values: event (event append) and upsert (merge update). Default value: upsert.
+   * 
    * @example
    * upsert
    */
   mode?: string;
   /**
+   * @remarks
+   * The similarity threshold for semantic merging. Valid values: 0 to 1. Default value: 0.4.
+   * 
    * @example
    * 0.4
    */
   similarityThreshold?: number;
   /**
+   * @remarks
+   * The number of days before memories expire. A value of 0 indicates that memories do not expire.
+   * 
    * @example
    * 0
    */
@@ -165,7 +186,7 @@ export class CreateContextStoreRequestConfigExtractionPolicies extends $dara.Mod
   categories?: string[];
   /**
    * @remarks
-   * The custom extraction instructions. This parameter is required when preset is set to custom. The length must be 1 to 8,000 characters.
+   * The custom extraction instructions. This parameter is required when preset is set to custom. Length: 1 to 8,000 characters.
    * 
    * @example
    * Extract only user product preferences
@@ -173,7 +194,7 @@ export class CreateContextStoreRequestConfigExtractionPolicies extends $dara.Mod
   customInstructions?: string;
   /**
    * @remarks
-   * Specifies whether to execute this policy for new inputs. Default value: true. Disabling the policy does not delete historical memories.
+   * Specifies whether to apply this policy to new inputs. Default value: true. Disabling the policy does not delete historical memories.
    * 
    * @example
    * true
@@ -208,10 +229,14 @@ export class CreateContextStoreRequestConfigExtractionPolicies extends $dara.Mod
    * fact
    */
   preset?: string;
+  /**
+   * @remarks
+   * The independent storage rules for this policy. If omitted, the original values are retained. New policies use default values. Repeatedly confirmed memories refresh the validity period by default.
+   */
   storagePolicy?: CreateContextStoreRequestConfigExtractionPoliciesStoragePolicy;
   /**
    * @remarks
-   * The ID of the extraction policy. This parameter is optional. If omitted, the default value is used. The ID must start with a letter and can contain only letters, digits, underscores, and hyphens. The maximum length is 64 characters. After default value processing, the ID must be unique within the same library. Modifying the name or instructions does not change this ID.
+   * The ID of the extraction policy. This parameter is optional. If omitted, the default value is used. The ID must start with a letter and can contain only letters, digits, underscores, and hyphens. Maximum length: 64 characters. After default processing, the ID must be unique within the same library. Modifying the name or instructions does not change this ID.
    * 
    * @example
    * preferences
@@ -269,7 +294,7 @@ export class CreateContextStoreRequestConfigExtractionPolicies extends $dara.Mod
 export class CreateContextStoreRequestConfigExtractionPolicyModel extends $dara.Model {
   /**
    * @remarks
-   * The name of the extraction model. Currently, only qwen3.8-flash is supported, which uses internal platform credentials.
+   * The name of the extraction model. Currently, only qwen3.8-flash is supported. Platform internal credentials are used.
    * 
    * @example
    * qwen3.8-flash
@@ -307,7 +332,7 @@ export class CreateContextStoreRequestConfigExtractionPolicy extends $dara.Model
   categories?: string[];
   /**
    * @remarks
-   * The custom extraction instructions. This parameter is required when preset is set to custom. The length must be 1 to 8,000 characters.
+   * The custom extraction instructions. This parameter is required when preset is set to custom. Length: 1 to 8,000 characters.
    * 
    * @example
    * Extract only user product preferences
@@ -408,7 +433,7 @@ export class CreateContextStoreRequestConfigScopePolicy extends $dara.Model {
 export class CreateContextStoreRequestConfigSourceDatasetCustomFields extends $dara.Model {
   /**
    * @remarks
-   * The field description. This parameter is required when usage is set to extraction-input and is appended to the extraction prompt.
+   * The description of the field. This parameter is required when usage is set to extraction-input and is appended to the extraction prompt.
    * 
    * @example
    * Customer tier
@@ -416,7 +441,7 @@ export class CreateContextStoreRequestConfigSourceDatasetCustomFields extends $d
   description?: string;
   /**
    * @remarks
-   * Specifies whether the field is sensitive.
+   * Specifies whether the field is a sensitive field.
    * 
    * @example
    * false
@@ -432,7 +457,7 @@ export class CreateContextStoreRequestConfigSourceDatasetCustomFields extends $d
   sourceField?: string;
   /**
    * @remarks
-   * The target path for writing data, such as metadata.customerTier.
+   * The target write path, such as metadata.customerTier.
    * 
    * @example
    * metadata.customerTier
@@ -440,9 +465,7 @@ export class CreateContextStoreRequestConfigSourceDatasetCustomFields extends $d
   target?: string;
   /**
    * @remarks
-   * The usage of the field. Valid values:
-   * - extraction-input: Participates in extraction.
-   * - ignore: Ignored.
+   * The usage of the field. Valid values: extraction-input (participates in extraction) and ignore (ignored).
    * 
    * @example
    * extraction-input
@@ -480,7 +503,7 @@ export class CreateContextStoreRequestConfigSourceDatasetCustomFields extends $d
 export class CreateContextStoreRequestConfigSourceDatasetFilter extends $dara.Model {
   /**
    * @remarks
-   * The subset of the Pipeline where clause, which is pushed down to SQL.
+   * The subset of the pipeline where clause, which is pushed down to SQL.
    * 
    * @example
    * appId = \\"crm-service\\"
@@ -510,9 +533,7 @@ export class CreateContextStoreRequestConfigSourceDatasetFilter extends $dara.Mo
 export class CreateContextStoreRequestConfigSourceDatasetVersionPolicy extends $dara.Model {
   /**
    * @remarks
-   * The consumption mode. Valid values:
-   * - follow: Consumes data incrementally based on __dataset_seq.
-   * - fixed: Consumes the specified ACTIVE version in full once.
+   * The consumption mode. Valid values: follow (incremental consumption based on __dataset_seq) and fixed (full consumption of the specified ACTIVE version once).
    * 
    * @example
    * follow
@@ -575,7 +596,7 @@ export class CreateContextStoreRequestConfigSourceDataset extends $dara.Model {
   datasetName?: string;
   /**
    * @remarks
-   * The row filter condition.
+   * The row filter conditions.
    */
   filter?: CreateContextStoreRequestConfigSourceDatasetFilter;
   /**
@@ -588,7 +609,7 @@ export class CreateContextStoreRequestConfigSourceDataset extends $dara.Model {
   pollIntervalSeconds?: number;
   /**
    * @remarks
-   * The row schema contract for the Dataset. The value is fixed to MemorySourceV1 in the current phase.
+   * The row schema contract of the Dataset. In the current version, this parameter is fixed to MemorySourceV1.
    * 
    * @example
    * MemorySourceV1
@@ -596,7 +617,7 @@ export class CreateContextStoreRequestConfigSourceDataset extends $dara.Model {
   schemaContract?: string;
   /**
    * @remarks
-   * The version consumption policy for the Dataset.
+   * The version consumption policy of the Dataset.
    */
   versionPolicy?: CreateContextStoreRequestConfigSourceDatasetVersionPolicy;
   static names(): { [key: string]: string } {
@@ -650,7 +671,7 @@ export class CreateContextStoreRequestConfigSourceTrajectoryFilter extends $dara
   agentNames?: string[];
   /**
    * @remarks
-   * Specifies whether to exclude degraded trajectories. Default value: false, which includes degraded trajectories.
+   * Specifies whether to exclude degraded trajectories. Default value: false (degraded trajectories are included).
    * 
    * @example
    * false
@@ -658,7 +679,7 @@ export class CreateContextStoreRequestConfigSourceTrajectoryFilter extends $dara
   excludeDegraded?: boolean;
   /**
    * @remarks
-   * The minimum number of steps. The value must be greater than or equal to 0.
+   * The minimum number of steps, which must be greater than or equal to 0.
    * 
    * @example
    * 2
@@ -778,7 +799,7 @@ export class CreateContextStoreRequestConfigSourceTrajectoryScopeMapping extends
 export class CreateContextStoreRequestConfigSourceTrajectory extends $dara.Model {
   /**
    * @remarks
-   * The trajectory filter condition. Conditions are combined with AND, and items within a list are combined with OR.
+   * The trajectory filter conditions. Conditions are combined with AND, and elements within a list are combined with OR.
    */
   filter?: CreateContextStoreRequestConfigSourceTrajectoryFilter;
   /**
@@ -799,12 +820,12 @@ export class CreateContextStoreRequestConfigSourceTrajectory extends $dara.Model
   pollIntervalSeconds?: number;
   /**
    * @remarks
-   * The scope field mapping. The value is a JSONPath expression. Only the $.a.b and $.a[0] formats are supported.
+   * The scope field mapping. The value must be a JSONPath expression. Only the $.a.b and $.a[0] formats are supported.
    */
   scopeMapping?: CreateContextStoreRequestConfigSourceTrajectoryScopeMapping;
   /**
    * @remarks
-   * The start time for trajectory consumption in ISO 8601 UTC format. If this parameter is not specified, the creation time is used by default.
+   * The start time for trajectory consumption in ISO 8601 UTC format. If you do not specify this parameter, the creation time is used by default.
    * 
    * Use the UTC time format: yyyy-MM-ddTHH:mm:ssZ
    * 
@@ -850,7 +871,7 @@ export class CreateContextStoreRequestConfigSourceTrajectory extends $dara.Model
 export class CreateContextStoreRequestConfigSourceVersionPolicy extends $dara.Model {
   /**
    * @remarks
-   * The continuous consumption mode. The value is fixed to follow.
+   * The continuous consumption mode. Set the value to follow.
    * 
    * @example
    * follow
@@ -858,7 +879,7 @@ export class CreateContextStoreRequestConfigSourceVersionPolicy extends $dara.Mo
   mode?: string;
   /**
    * @remarks
-   * The initial consumed append sequence number. The value is a decimal string of a non-negative int64 integer. Default value: 0. The __dataset_seq field is used, and the business timestamp is not used as the consumption checkpoint.
+   * The initial consumed append sequence number. The value must be a decimal string of a non-negative 64-bit integer. Default value: 0. The __dataset_seq field is used, and the business timestamp is not used as the consumption checkpoint.
    * 
    * @example
    * 0
@@ -890,7 +911,7 @@ export class CreateContextStoreRequestConfigSourceVersionPolicy extends $dara.Mo
 export class CreateContextStoreRequestConfigSource extends $dara.Model {
   /**
    * @remarks
-   * The AgentSpace where the trace data source is located. If not specified, the default value is the AgentSpace in the current path. Cross-AgentSpace operations are not supported in the current phase. If specified, the value must be identical to the path AgentSpace. Otherwise, a 400 parameter error is returned. This parameter cannot be modified after creation.
+   * The AgentSpace where the trace data source is located. If not specified, the default value is the AgentSpace in the current path. Cross-AgentSpace operations are not supported in the current version. If specified, the value must be the same as the AgentSpace in the path. Otherwise, a 400 parameter error is returned. This parameter cannot be modified after creation.
    * 
    * @example
    * my-agent-space
@@ -898,7 +919,7 @@ export class CreateContextStoreRequestConfigSource extends $dara.Model {
   agentSpace?: string;
   /**
    * @remarks
-   * The DatasetBinding v1 configuration shared with optimization tasks. It includes version, selection (all/window and structured filters), and customFields. It is validated by the server and does not accept SQL or column mappings.
+   * The DatasetBinding v1 shared with optimization tasks, which includes version, selection (all/window and structured filters), and customFields. This parameter is validated by the server and does not accept SQL or column mappings.
    * 
    * @example
    * {"version":1,"selection":{"mode":"all"}}
@@ -906,12 +927,12 @@ export class CreateContextStoreRequestConfigSource extends $dara.Model {
   binding?: { [key: string]: any };
   /**
    * @remarks
-   * The Dataset data source configuration. This parameter is required when source.type is set to dataset.
+   * The Dataset datasource config. This parameter is required when source.type is set to dataset.
    */
   dataset?: CreateContextStoreRequestConfigSourceDataset;
   /**
    * @remarks
-   * The source name of the experience Dataset, which must be located in the current AgentSpace. This parameter is provided only when the type is experience and source.type is set to dataset.
+   * The name of the experience Dataset source, which must be located in the current AgentSpace. This parameter is provided only when the type is experience and source.type is set to dataset.
    * 
    * @example
    * reviewed_trajectories
@@ -919,7 +940,7 @@ export class CreateContextStoreRequestConfigSource extends $dara.Model {
   datasetName?: string;
   /**
    * @remarks
-   * The input format of the Dataset. For experience library Dataset sources, only atif is supported, and the fixed columns are consistent with those of optimization tasks.
+   * The input format of the Dataset. For experience library Dataset sources, only atif is supported, and the fixed columns are the same as those for optimization tasks.
    * 
    * @example
    * atif
@@ -927,7 +948,7 @@ export class CreateContextStoreRequestConfigSource extends $dara.Model {
   format?: string;
   /**
    * @remarks
-   * The maximum number of Dataset records to read per batch. Valid values: 1 to 1000. Default value: 1000. In manual mode, exceeding the limit causes a failure. In follow mode, bounded pagination is used to continue consumption.
+   * The maximum number of records to read per batch. Valid values: 1 to 1000. Default value: 1000. In manual mode, exceeding the limit causes a failure. In follow mode, bounded pagination is used to continue consumption.
    * 
    * @example
    * 1000
@@ -935,7 +956,7 @@ export class CreateContextStoreRequestConfigSource extends $dara.Model {
   maxRecords?: number;
   /**
    * @remarks
-   * The start time for data backfill in ISO 8601 UTC format. If this parameter is not specified, the current time is used.
+   * The start time for data backfill in ISO 8601 UTC format. If not specified, the backfill starts from the current time.
    * 
    * Use the UTC time format: yyyy-MM-ddTHH:mm:ssZ
    * 
@@ -945,12 +966,12 @@ export class CreateContextStoreRequestConfigSource extends $dara.Model {
   startTime?: string;
   /**
    * @remarks
-   * The trajectory data source configuration. This parameter is required when source.type is set to trajectory.
+   * The trajectory datasource config. This parameter is required when source.type is set to trajectory.
    */
   trajectory?: CreateContextStoreRequestConfigSourceTrajectory;
   /**
    * @remarks
-   * The data source type for the memory type. Valid values: trajectory, dataset. If this parameter is not specified, the default value is manual, which means data is written only through AddContexts. This parameter cannot be modified after creation.
+   * The data source type for the memory type. Valid values: trajectory and dataset. If this parameter is not specified, manual is used, which means only AddContexts can write data. This parameter cannot be modified after creation.
    * 
    * @example
    * trajectory
@@ -958,7 +979,7 @@ export class CreateContextStoreRequestConfigSource extends $dara.Model {
   type?: string;
   /**
    * @remarks
-   * The continuous consumption configuration for the native experience dataset. The default value is manual. The follow mode is allowed only when binding.selection.mode is set to all. In this mode, data is consumed by append sequence number. This configuration cannot be modified after creation.
+   * The continuous consumption configuration for the Dataset of the native experience library. Default value: manual. If the value is follow, only binding.selection.mode=all is allowed, and data is consumed based on the append sequence number. This parameter cannot be modified after creation.
    */
   versionPolicy?: CreateContextStoreRequestConfigSourceVersionPolicy;
   static names(): { [key: string]: string } {
@@ -1015,7 +1036,7 @@ export class CreateContextStoreRequestConfigSource extends $dara.Model {
 export class CreateContextStoreRequestConfigStoragePolicy extends $dara.Model {
   /**
    * @remarks
-   * The allowed storage actions. Default value: all. Valid values: ADD, UPDATE, MERGE, DELETE.
+   * The allowed storage actions. Default value: all actions (ADD, UPDATE, MERGE, and DELETE).
    * 
    * @example
    * ["ADD","UPDATE","MERGE","DELETE"]
@@ -1031,7 +1052,7 @@ export class CreateContextStoreRequestConfigStoragePolicy extends $dara.Model {
   dedupe?: boolean;
   /**
    * @remarks
-   * Specifies whether to enable manual edit protection. Default value: true. If this feature is enabled, automatic extraction does not overwrite manually modified memories.
+   * Specifies whether to enable human edit protection. Default value: true. When enabled, automatic extraction does not overwrite manually modified memories.
    * 
    * @example
    * true
@@ -1039,7 +1060,7 @@ export class CreateContextStoreRequestConfigStoragePolicy extends $dara.Model {
   humanEditProtection?: boolean;
   /**
    * @remarks
-   * The merge key for upsert operations. Default value: semantic. Valid values: factKey, semantic, both.
+   * The merge key for upsert operations. Valid values: factKey, semantic, and both. Default value: semantic.
    * 
    * @example
    * semantic
@@ -1047,7 +1068,7 @@ export class CreateContextStoreRequestConfigStoragePolicy extends $dara.Model {
   mergeKey?: string;
   /**
    * @remarks
-   * The storage mode. Default value: upsert. Valid values: event (event append), upsert (merge update).
+   * The storage mode. Valid values: event (event append) and upsert (merge update). Default value: upsert.
    * 
    * @example
    * upsert
@@ -1063,7 +1084,7 @@ export class CreateContextStoreRequestConfigStoragePolicy extends $dara.Model {
   similarityThreshold?: number;
   /**
    * @remarks
-   * The number of days before a memory expires. A value of 0 indicates that the memory does not expire.
+   * The number of days before memories expire. A value of 0 indicates that memories do not expire.
    * 
    * @example
    * 0
@@ -1113,7 +1134,7 @@ export class CreateContextStoreRequestConfig extends $dara.Model {
   audit?: CreateContextStoreRequestConfigAudit;
   /**
    * @remarks
-   * The extraction policies. You can specify 1 to 10 policies. In a request, you can specify either this field or the compatible extractionPolicy field, but not both. The strategyVersion parameter indicates the snapshot version of the entire library configuration.
+   * The extraction policies. You can configure 1 to 10 policies. Compatible fields passed back as-is during updates are ignored. strategyVersion indicates the snapshot version of the entire library configuration.
    */
   extractionPolicies?: CreateContextStoreRequestConfigExtractionPolicies[];
   /**
@@ -1123,7 +1144,7 @@ export class CreateContextStoreRequestConfig extends $dara.Model {
   extractionPolicy?: CreateContextStoreRequestConfigExtractionPolicy;
   /**
    * @remarks
-   * The metadata field mapping. The key is the business field and the value is the storage field.
+   * The metadata field mapping, where the key is the business field and the value is the storage field.
    * 
    * @example
    * {"userId":"user_id","sessionId":"session_id"}
@@ -1144,7 +1165,7 @@ export class CreateContextStoreRequestConfig extends $dara.Model {
   scopePolicy?: CreateContextStoreRequestConfigScopePolicy;
   /**
    * @remarks
-   * The list of service names. This parameter is required and cannot be empty. It works with source.agentSpace to locate the trace data source. The trajectory extraction service uses agentSpace to query the bound CMS workspace and project or logstore, and then filters by serviceName. This parameter cannot be modified after creation.
+   * The list of service names. This parameter is required and cannot be empty. It works with source.agentSpace to locate the trace data source. The trajectory extraction service uses the agentSpace to find the bound CMS workspace and project or logstore, and then filters by serviceName. This parameter cannot be modified after creation.
    * 
    * @example
    * ["order-service","payment-service"]
@@ -1152,7 +1173,7 @@ export class CreateContextStoreRequestConfig extends $dara.Model {
   serviceNames?: string[];
   /**
    * @remarks
-   * The data source configuration, which serves only as the root identifier for the data source. This block is optional.
+   * The datasource config, which serves only as the root identity for the data source. This block is optional.
    */
   source?: CreateContextStoreRequestConfigSource;
   /**
@@ -1239,7 +1260,7 @@ export class CreateContextStoreRequest extends $dara.Model {
   contextStoreName?: string;
   /**
    * @remarks
-   * The type of the context store. Valid values include experience (experience store) and memory (memory store).
+   * The type of the context store. Valid values include experience and memory.
    * 
    * This parameter is required.
    * 
@@ -1257,7 +1278,7 @@ export class CreateContextStoreRequest extends $dara.Model {
   description?: string;
   /**
    * @remarks
-   * The idempotency token. This is a unique string generated by the client to ensure the idempotency of the creation operation.
+   * The client token. It is a unique string generated by the client to ensure the idempotency of the create operation.
    * 
    * @example
    * a1b2c3d4-1234-5678-90ab-cdef12345678

package/src/models/CreateContextStoreResponseBody.ts

@@ -13,7 +13,7 @@ export class CreateContextStoreResponseBody extends $dara.Model {
   requestId?: string;
   /**
    * @remarks
-   * The version number of the currently effective strategy (memory type).
+   * The version number of the effective strategy for the memory type.
    * 
    * @example
    * 1