@alicloud/agentcore20260804 3.0.1 → 3.1.0

package/src/models/ListCustomAgentsResponseBody.ts

@@ -15,7 +15,7 @@ export class ListCustomAgentsResponseBodyItemsArtifactCode extends $dara.Model {
   entrypoint?: string;
   /**
    * @remarks
-   * The identifier of the code runtime environment in the currently saved configuration. The runtime image uses a saved snapshot. Adding a new version to the directory does not automatically change the existing configuration.
+   * The identifier of the code runtime environment in the currently saved configuration. The runtime image uses the saved snapshot. Adding a new version to the directory does not automatically change the existing configuration.
    * 
    * This parameter is required.
    * 
@@ -69,9 +69,7 @@ export class ListCustomAgentsResponseBodyItemsArtifactContainer extends $dara.Mo
   entrypoint?: string;
   /**
    * @remarks
-   * The ID of the Container Registry Enterprise instance.
-   * 
-   * This parameter is required.
+   * The ID of the ACR Enterprise instance.
    * 
    * @example
    * cri-example
@@ -79,9 +77,7 @@ export class ListCustomAgentsResponseBodyItemsArtifactContainer extends $dara.Mo
   instanceId?: string;
   /**
    * @remarks
-   * The namespace of the Container Registry instance.
-   * 
-   * This parameter is required.
+   * The ACR namespace.
    * 
    * @example
    * team
@@ -89,9 +85,7 @@ export class ListCustomAgentsResponseBodyItemsArtifactContainer extends $dara.Mo
   namespace?: string;
   /**
    * @remarks
-   * The name of the Container Registry image repository.
-   * 
-   * This parameter is required.
+   * The name of the ACR image repository.
    * 
    * @example
    * app
@@ -99,9 +93,7 @@ export class ListCustomAgentsResponseBodyItemsArtifactContainer extends $dara.Mo
   repo?: string;
   /**
    * @remarks
-   * The tag of the image.
-   * 
-   * This parameter is required.
+   * The image tag.
    * 
    * @example
    * v1
@@ -315,7 +307,7 @@ export class ListCustomAgentsResponseBodyItemsProtocolPaths extends $dara.Model
 export class ListCustomAgentsResponseBodyItemsProtocol extends $dara.Model {
   /**
    * @remarks
-   * The request header configuration for the current protocol. The key is the header name and the value is a string.
+   * The request header configuration of the current protocol. The key is the header name and the value is a string.
    */
   headers?: { [key: string]: string };
   /**
@@ -325,7 +317,10 @@ export class ListCustomAgentsResponseBodyItemsProtocol extends $dara.Model {
   paths?: ListCustomAgentsResponseBodyItemsProtocolPaths[];
   /**
    * @remarks
-   * The invoke Protocol Type. Valid values: agui (AG-UI protocol), openai-chat-completion (OpenAI Chat Completions compatible protocol), and custom (custom protocol).
+   * The invoke Protocol Type. Valid values:
+   * - agui: AG-UI protocol.
+   * - openai-chat-completion: OpenAI Chat Completions compatible protocol.
+   * - custom: Custom protocol.
    * 
    * This parameter is required.
    * 
@@ -446,7 +441,14 @@ export class ListCustomAgentsResponseBodyItems extends $dara.Model {
   runtime?: string;
   /**
    * @remarks
-   * The overall status of the agent. Valid values: Creating, Running, Failed, Updating, Deleting, and Deleted. To query the execution progress of the latest configuration, call the GetCustomAgent operation.
+   * The overall status of the agent. Valid values:
+   * - Creating: The agent is being created.
+   * - Running: The agent is running.
+   * - Failed: The agent failed.
+   * - Updating: The agent is being updated.
+   * - Deleting: The agent is being deleted.
+   * - Deleted: The agent is deleted.
+   * To query the execution progress of the latest configuration, call the GetCustomAgent operation.
    * 
    * @example
    * Running
@@ -527,7 +529,7 @@ export class ListCustomAgentsResponseBodyItems extends $dara.Model {
 export class ListCustomAgentsResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The request result code. The value is SUCCESS when the request is successful.
+   * The request result code. The value is SUCCESS if the request is successful.
    * 
    * @example
    * SUCCESS
@@ -535,7 +537,7 @@ export class ListCustomAgentsResponseBody extends $dara.Model {
   code?: string;
   /**
    * @remarks
-   * The HTTP status code of the current request. The value is 200 when the request is successful.
+   * The HTTP status code of the request. The value is 200 if the request is successful.
    * 
    * @example
    * 200
@@ -556,7 +558,7 @@ export class ListCustomAgentsResponseBody extends $dara.Model {
   maxResults?: number;
   /**
    * @remarks
-   * The message that describes the processing result of the request. The value is success if the request succeeds.
+   * The message that describes the result of the request. The value is success if the request is successful.
    * 
    * @example
    * success
@@ -564,7 +566,7 @@ export class ListCustomAgentsResponseBody extends $dara.Model {
   message?: string;
   /**
    * @remarks
-   * The opaque token used to query the next page. An empty value indicates that no more pages exist. Pass this token as is in subsequent requests.
+   * The opaque token used to query the next page. An empty value indicates that no more pages are available. Pass this token as-is in subsequent requests.
    * 
    * @example
    * djE6YWdlbnRjb3JlLmFnZW50Lmxpc3QuY3VzdG9tOjIw
@@ -572,7 +574,7 @@ export class ListCustomAgentsResponseBody extends $dara.Model {
   nextToken?: string;
   /**
    * @remarks
-   * The unique identifier of the request, used to locate and troubleshoot issues.
+   * The unique identifier of the request. You can use this ID to locate and troubleshoot issues.
    * 
    * @example
    * 550E8400-E29B-41D4-A716-446655440000
@@ -580,7 +582,7 @@ export class ListCustomAgentsResponseBody extends $dara.Model {
   requestId?: string;
   /**
    * @remarks
-   * Indicates whether the request was processed successfully. A value of true indicates success. A successful creation, update, or deletion does not mean that the background operation is complete.
+   * Indicates whether the request was processed successfully. A value of true indicates that the request was successful. A successful creation, update, or deletion response does not mean that the background operation is complete.
    */
   success?: boolean;
   /**

package/src/models/ListIdentityProvidersRequest.ts

@@ -13,7 +13,7 @@ export class ListIdentityProvidersRequest extends $dara.Model {
   maxResults?: number;
   /**
    * @remarks
-   * The cursor for querying the next page. Do not specify this parameter for the first call. For subsequent calls, specify the nextToken value returned from the previous call.
+   * The cursor for querying the next page. Do not specify this parameter in the first call. Specify the nextToken returned in the previous call for subsequent calls.
    * 
    * @example
    * aWRlbnRpdHktcHJvdmlkZXItb2Zmc2V0OjEw

package/src/models/ListIdentityProvidersResponseBody.ts

@@ -13,7 +13,7 @@ export class ListIdentityProvidersResponseBodyItemsConfiguration extends $dara.M
   bindingType?: string;
   /**
    * @remarks
-   * Required for manual entry. Must be non-empty and up to 2048 characters. Existing configurations cannot be changed. This is different from the local entity ID returned by SP queries.
+   * Required for manual entry. It must be non-empty and contain a maximum of 2,048 characters. Existing configurations cannot be changed. This is different from the local entity ID returned in SP queries.
    * 
    * @example
    * https://idp.example.com/entity
@@ -21,7 +21,7 @@ export class ListIdentityProvidersResponseBodyItemsConfiguration extends $dara.M
   entityId?: string;
   /**
    * @remarks
-   * Required for manual entry. Must be an absolute HTTPS URL without user credentials or fragments.
+   * Required for manual entry. It must be an absolute HTTPS URL without user credentials or fragments.
    * 
    * @example
    * https://idp.example.com/sso
@@ -105,7 +105,7 @@ export class ListIdentityProvidersResponseBodyItemsMetadata extends $dara.Model
   corpId?: string;
   /**
    * @remarks
-   * Required for manual entry. Must be non-empty and up to 2048 characters. Existing configurations cannot be changed. This is different from the local entity ID returned by SP queries.
+   * Required for manual entry. It must be non-empty and contain a maximum of 2,048 characters. Existing configurations cannot be changed. This is different from the local entity ID returned in SP queries.
    * 
    * @example
    * https://idp.example.com/entity
@@ -113,7 +113,7 @@ export class ListIdentityProvidersResponseBodyItemsMetadata extends $dara.Model
   entityId?: string;
   /**
    * @remarks
-   * Required for manual entry. Must be an absolute HTTPS URL without user credentials or fragments.
+   * Required for manual entry. It must be an absolute HTTPS URL without user credentials or fragments.
    * 
    * @example
    * https://idp.example.com/sso
@@ -163,7 +163,7 @@ export class ListIdentityProvidersResponseBodyItemsSaml extends $dara.Model {
   bindingType?: string;
   /**
    * @remarks
-   * Required for manual entry. Must be non-empty and up to 2048 characters. Existing configurations cannot be changed. This is different from the local entity ID returned by SP queries.
+   * Required for manual entry. It must be non-empty and contain a maximum of 2,048 characters. Existing configurations cannot be changed. This is different from the local entity ID returned in SP queries.
    * 
    * @example
    * https://idp.example.com/entity
@@ -171,7 +171,7 @@ export class ListIdentityProvidersResponseBodyItemsSaml extends $dara.Model {
   entityId?: string;
   /**
    * @remarks
-   * Required for manual entry. Must be an absolute HTTPS URL without user credentials or fragments.
+   * Required for manual entry. It must be an absolute HTTPS URL without user credentials or fragments.
    * 
    * @example
    * https://idp.example.com/sso
@@ -179,7 +179,7 @@ export class ListIdentityProvidersResponseBodyItemsSaml extends $dara.Model {
   loginUrl?: string;
   /**
    * @remarks
-   * Required as a non-empty array for manual entry. Uses PEM X.509 certificate text. Validates the current validity period. A maximum of two certificates are allowed after deduplication.
+   * A non-empty array is required for manual entry. Use PEM X.509 certificate text. The current validity period is verified. A maximum of two certificates are allowed after deduplication.
    * 
    * @example
    * ["-----BEGIN CERTIFICATE-----\\\\nMIICwDCCAaigAwIBAgIULlsHLfcADyBax5ZtFlj+YGzZVo0wDQYJKoZIhvcNAQEL\\\\nBQAwGjEYMBYGA1UEAwwPaWRwLmV4YW1wbGUuY29tMB4XDTI2MDEwMTAwMDAwMFoX\\\\nDTM2MDEwMTAwMDAwMFowGjEYMBYGA1UEAwwPaWRwLmV4YW1wbGUuY29tMIIBIjAN\\\\nBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAto0DN0W1CrPRzK9QZ9A1aApb4Lg8\\\\noGlp2c0PbN3LokXe/HzwxCMXx65IDnrenttxzTwp9BgUnUN/3LRzWaOL2UQ/vNYN\\\\nW9LFLkI1T64UPyI7eyi28YlALhb41xkYhEp7rz+MjqifBzVZeTDUxBYtbK2hAhbY\\\\nEL1+udwsXEx0KB7xuQ/rbI2OKeqAEAD1tfYg7T/SM2wrXNYhx+o1HtchM4/0I8Ok\\\\nkk27JQ4y3ofzC5sTySmFF1Y7XcpSd+5WSyazedhkAieo8AB01DkJV6nnKfH8sH0E\\\\nBsnH3FP8FhqCLrIeEkjX9B9OcIRLGjiZqx4u/ryW1QhMldnv+pFfNjWy/wIDAQAB\\\\nMA0GCSqGSIb3DQEBCwUAA4IBAQC1hSQG8AwtGOoX2gKBK4Hi5XBrBreij8WlLTUW\\\\nld0FINQ0Rg84f/27CjDthywj6wgxCesCuOVFhpxQa1UacsP/Gcai1aKABtLWImca\\\\nWECRYK5gDkwhTMFKM9mXA26hH1l4v/UR2iTpEK9H78egC4W7bs2LDTpPryuaNKTq\\\\nP2O0tMbNkAHB8yecz5LxHXnxadL9Egow25g2RClvpifWqDnuS9TSbKkIWLcPLjoc\\\\nJj2K9ILpBwhXiXi/BiSgyYTLiYvVvih9vX4s+hKGZNJc0j92YLiOHDF0XH1oxgdV\\\\njfTmRiedeb2VZJZElptD92z0AqFR7z2d5B+OqpPA2gjuMLV5\\\\n-----END CERTIFICATE-----"]
@@ -218,7 +218,7 @@ export class ListIdentityProvidersResponseBodyItemsSaml extends $dara.Model {
 export class ListIdentityProvidersResponseBodyItemsSyncScope extends $dara.Model {
   /**
    * @remarks
-   * Must contain at least one non-empty department ID when set to SelectedDepartments. The IDs should be obtained from ListIdentityProviderDepartments. Pass an empty array or omit this parameter when set to AllAuthorized.
+   * When the mode is SelectedDepartments, it must contain at least one non-empty department ID obtained from ListIdentityProviderDepartments. When the mode is AllAuthorized, pass an empty array or omit this field.
    * 
    * @example
    * ["10001"]
@@ -226,7 +226,10 @@ export class ListIdentityProvidersResponseBodyItemsSyncScope extends $dara.Model
   departmentIds?: string[];
   /**
    * @remarks
-   * AllAuthorized: the full authorization scope, limited by the application address book authorization. SelectedDepartments: the selected departments and all their sub-departments. A valid mode must be provided and verified by the backend when syncScope is explicitly submitted.
+   * Valid values:
+   * - AllAuthorized: The full authorization scope, limited by the application address book authorization.
+   * - SelectedDepartments: The selected departments and all their sub-departments.
+   * You must provide a valid mode when explicitly submitting syncScope. The backend verifies the mode.
    * 
    * @example
    * SelectedDepartments
@@ -261,7 +264,7 @@ export class ListIdentityProvidersResponseBodyItemsSyncScope extends $dara.Model
 export class ListIdentityProvidersResponseBodyItems extends $dara.Model {
   /**
    * @remarks
-   * The actual SAML configuration is retrieved on demand only through GetIdentityProvider. SCIM queries and provisioning return the actual receiving status and URL.
+   * The actual SAML configuration is read on demand only by GetIdentityProvider. SCIM queries and preparations return the actual received status and URLs.
    */
   configuration?: ListIdentityProvidersResponseBodyItemsConfiguration;
   /**
@@ -274,7 +277,7 @@ export class ListIdentityProvidersResponseBodyItems extends $dara.Model {
   createdAt?: string;
   /**
    * @remarks
-   * The event subscription callback URL. Configure this URL in the external identity provider application to receive organization change events. Returns an empty string if the user pool is not activated.
+   * The event subscription callback URL. You must configure this URL in the external identity provider application to receive organization change events. An empty string is returned if the user pool is not activated.
    * 
    * @example
    * http://auth.cn-hangzhou.agentteams.aliyuncs.com/roa/dingtalk/event/up-123456
@@ -290,7 +293,7 @@ export class ListIdentityProvidersResponseBodyItems extends $dara.Model {
   identityProviderType?: string;
   /**
    * @remarks
-   * The logon callback URL. Configure this URL in the external identity provider application. Returns an empty string if the user pool is not activated.
+   * The logon callback URL. You must configure this URL in the external identity provider application. An empty string is returned if the user pool is not activated.
    * 
    * @example
    * https://signin-cn-hangzhou.aliyunagentid.com/up-123456/dingtalk/callback
@@ -308,7 +311,7 @@ export class ListIdentityProvidersResponseBodyItems extends $dara.Model {
   metadata?: ListIdentityProvidersResponseBodyItemsMetadata;
   /**
    * @remarks
-   * Only SAML is currently supported. May not be returned if no valid configuration is saved. OIDC placeholder initialization is not supported.
+   * Only SAML is currently supported. This field may not be returned if no valid configuration is saved. OIDC placeholder initialization is not supported.
    * 
    * @example
    * SAML
@@ -316,12 +319,21 @@ export class ListIdentityProvidersResponseBodyItems extends $dara.Model {
   protocol?: string;
   /**
    * @remarks
-   * Input supports either XML or full manual entry. Queries return the standardized configuration and do not echo the original XML. Can be omitted if not configured.
+   * The input supports either XML or complete manual entry. Queries return the standardized configuration and do not echo the original XML. This field can be omitted if it is not configured.
    */
   saml?: ListIdentityProvidersResponseBodyItemsSaml;
   /**
    * @remarks
-   * The binding status. Valid values: CONFIGURED (the configuration is accepted and waiting for user pool activation), SYNCING (synchronizing organization members), SYNCED (organization member synchronization is completed), READY (the binding is effective), SYNC_FAILED (organization member synchronization failed), UPDATING (updating the configuration), UPDATE_FAILED (configuration update failed), DISCONNECTING (disconnecting), DISCONNECT_FAILED (disconnection failed).
+   * The binding status. Valid values:
+   * - CONFIGURED: The configuration is accepted and waiting for user pool activation.
+   * - SYNCING: Organization members are being synchronized.
+   * - SYNCED: Organization member synchronization is complete.
+   * - READY: The binding is in effect.
+   * - SYNC_FAILED: Organization member synchronization failed.
+   * - UPDATING: The configuration is being updated.
+   * - UPDATE_FAILED: Configuration update failed.
+   * - DISCONNECTING: The binding is being disconnected.
+   * - DISCONNECT_FAILED: Disconnection failed.
    * 
    * @example
    * READY
@@ -329,12 +341,12 @@ export class ListIdentityProvidersResponseBodyItems extends $dara.Model {
   status?: string;
   /**
    * @remarks
-   * Specifies whether to enable organization member synchronization. If enabled, the external identity provider synchronizes organization members as workspace users.
+   * Specifies whether to enable organization member synchronization. If enabled, organization members are synchronized as workspace users by this external identity provider.
    */
   syncEnabled?: boolean;
   /**
    * @remarks
-   * Follows the department-based synchronization scope definition. If omitted during creation, the default is AllAuthorized. The first vendor synchronization is determined by syncOnBind. If omitted or null during an update, the original value is retained. Updating the saved scope does not automatically trigger full synchronization.
+   * Follows the department-based synchronization scope definition. If omitted during creation, the default value is AllAuthorized, and the first provider synchronization is determined by syncOnBind. If omitted or set to null during an update, the original value is retained. Updating the saved scope does not automatically trigger full synchronization.
    */
   syncScope?: ListIdentityProvidersResponseBodyItemsSyncScope;
   /**
@@ -444,7 +456,7 @@ export class ListIdentityProvidersResponseBody extends $dara.Model {
   maxResults?: number;
   /**
    * @remarks
-   * The response message. Returns an error description if the request fails.
+   * The response message. An error description is returned if the request fails.
    * 
    * @example
    * success

package/src/models/PrepareIdentityProviderScimresponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class PrepareIdentityProviderSCIMResponseBodyDataConfiguration extends $dara.Model {
   /**
    * @remarks
-   * The URL configured for the external provisioning system. The presence of a URL does not indicate that the external configuration is completed or that AC synchronization is enabled.
+   * The URL configured for the external provisioning system. The presence of a URL does not indicate that the external configuration is completed or that access control synchronization is enabled.
    * 
    * @example
    * https://example.com/scim/v2
@@ -13,7 +13,7 @@ export class PrepareIdentityProviderSCIMResponseBodyDataConfiguration extends $d
   baseUrl?: string;
   /**
    * @remarks
-   * The AgentIdentity receiving status. Enabled indicates that SCIM receiving is enabled, and Disabled indicates that it is disabled. This status is not equivalent to the expected value of syncEnabled in AC.
+   * The receiving status of AgentIdentity. Enabled indicates that SCIM receiving is enabled, and Disabled indicates that it is disabled. This status is not equivalent to the expected value of syncEnabled for access control.
    * 
    * @example
    * Enabled
@@ -69,7 +69,7 @@ export class PrepareIdentityProviderSCIMResponseBodyDataCredential extends $dara
   expireTime?: string;
   /**
    * @remarks
-   * The AgentIdentity credential status. Only credentials that are in the Enabled state and have not expired are considered available. This field is not the operationStatus of a SCIM task.
+   * The credential status of AgentIdentity. Only credentials that are in the Enabled state and have not expired are considered available. This field is not the operationStatus of a SCIM task.
    * 
    * @example
    * Enabled
@@ -105,17 +105,17 @@ export class PrepareIdentityProviderSCIMResponseBodyDataCredential extends $dara
 export class PrepareIdentityProviderSCIMResponseBodyData extends $dara.Model {
   /**
    * @remarks
-   * The AgentIdentity receiving configuration. The actual SAML configuration is read on demand only by calling GetIdentityProvider. SCIM query and prepare operations return the actual receiving status and URL.
+   * The actual SAML configuration is read on demand only by using GetIdentityProvider. SCIM query and prepare operations return the actual receiving status and URL.
    */
   configuration?: PrepareIdentityProviderSCIMResponseBodyDataConfiguration;
   /**
    * @remarks
-   * The current credential summary, including credentialId, status, createTime, and expireTime. It does not include the repeatedly retrievable token.
+   * The current credential summary, which includes the credentialId, status, createTime, and expireTime fields. This summary does not include the token.
    */
   credential?: PrepareIdentityProviderSCIMResponseBodyDataCredential;
   /**
    * @remarks
-   * The plaintext token returned only when a new credential is created. If the prepare operation reuses a valid credential, this value is null. The token cannot be retrieved again from the list. If the response is lost, query the list first. The token is not automatically reissued. Do not write the token to logs or persistent frontend caches.
+   * The plaintext token is returned only when a new credential is created. If the prepare operation reuses a valid credential, this field is null. The token cannot be retrieved again from the list. If the response is lost, query the list first instead of automatically reissuing the token. Do not write the token to logs or persist it in frontend caches.
    * 
    * @example
    * example-scim-token
@@ -163,12 +163,12 @@ export class PrepareIdentityProviderSCIMResponseBody extends $dara.Model {
   code?: string;
   /**
    * @remarks
-   * The operation result. For the result structure, see the response fields of this API operation. For asynchronous write API operations, the response indicates that the request is accepted and does not guarantee that the background task is completed.
+   * The operation result. For the result structure, see the response fields of this API. For asynchronous write APIs, the response indicates that the request is accepted, but does not guarantee that the background task is completed.
    */
   data?: PrepareIdentityProviderSCIMResponseBodyData;
   /**
    * @remarks
-   * The HTTP status code of the current request. This code indicates the processing status of the request and is not equivalent to the final result of the background task.
+   * The processing status of the current request. This status is not equivalent to the final result of the background task.
    * 
    * @example
    * 200
@@ -176,7 +176,7 @@ export class PrepareIdentityProviderSCIMResponseBody extends $dara.Model {
   httpStatusCode?: number;
   /**
    * @remarks
-   * The result message, which indicates that the request is accepted or contains an error message. For asynchronous tasks, check the task result by calling the corresponding query API operation.
+   * The request acceptance or error message. For asynchronous tasks, you must check the task result by using the corresponding query API.
    * 
    * @example
    * success
@@ -192,7 +192,7 @@ export class PrepareIdentityProviderSCIMResponseBody extends $dara.Model {
   requestId?: string;
   /**
    * @remarks
-   * Indicates whether the current request is successful. A value of true indicates that the request is processed successfully. For asynchronous write operations, you must continue to query the task result.
+   * Indicates whether the current request is processed successfully. A value of true indicates success. For asynchronous write operations, you must continue to query the task result.
    */
   success?: boolean;
   static names(): { [key: string]: string } {