@alicloud/agentcore20260804 1.2.1 → 1.2.2

package/dist/client.js

@@ -62,7 +62,7 @@ class Client extends openapi_core_1.default {
         return openapi_core_2.OpenApiUtil.getEndpointRules(productId, regionId, endpointRule, network, suffix);
     }
     /**
-     * 批量删除模型
+     * Deletes models in a specified workspace in batches. If any model is in use, the entire batch request fails.
      *
      * @param tmpReq - BatchDeleteModelsRequest
      * @param headers - map
@@ -103,7 +103,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.BatchDeleteModelsResponse({}));
     }
     /**
-     * 批量删除模型
+     * Deletes models in a specified workspace in batches. If any model is in use, the entire batch request fails.
      *
      * @param request - BatchDeleteModelsRequest
      * @returns BatchDeleteModelsResponse
@@ -337,7 +337,7 @@ class Client extends openapi_core_1.default {
         return await this.createAgentSpecVersionWithOptions(workspaceId, agentSpecName, request, headers, runtime);
     }
     /**
-     * 创建凭证
+     * Creates a credential in a specified workspace for agent authentication when accessing external services. Currently, only the apiKey type is supported. The credential content is passed in as a JSON string through credentialMetadata and can only be queried in masked form after being written.
      *
      * @param tmpReq - CreateCredentialRequest
      * @param headers - map
@@ -378,7 +378,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateCredentialResponse({}));
     }
     /**
-     * 创建凭证
+     * Creates a credential in a specified workspace for agent authentication when accessing external services. Currently, only the apiKey type is supported. The credential content is passed in as a JSON string through credentialMetadata and can only be queried in masked form after being written.
      *
      * @param request - CreateCredentialRequest
      * @returns CreateCredentialResponse
@@ -706,7 +706,7 @@ class Client extends openapi_core_1.default {
         return await this.createModelWithOptions(workspaceId, request, headers, runtime);
     }
     /**
-     * 创建模型连接
+     * Creates a model connection in a specified workspace and configures the upstream model service address, invoke protocol, and access credentials.
      *
      * @param tmpReq - CreateModelConnectionRequest
      * @param headers - map
@@ -747,7 +747,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateModelConnectionResponse({}));
     }
     /**
-     * 创建模型连接
+     * Creates a model connection in a specified workspace and configures the upstream model service address, invoke protocol, and access credentials.
      *
      * @param request - CreateModelConnectionRequest
      * @returns CreateModelConnectionResponse
@@ -813,7 +813,7 @@ class Client extends openapi_core_1.default {
         return await this.createSkillDraftWithOptions(workspaceId, request, headers, runtime);
     }
     /**
-     * 创建团队
+     * Creates a team in a specified workspace and sets user members and agent members at the same time. The user members must include exactly one member with the ADMIN role. Agent members can only have the LEADER or WORKER role.
      *
      * @param tmpReq - CreateTeamRequest
      * @param headers - map
@@ -854,7 +854,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateTeamResponse({}));
     }
     /**
-     * 创建团队
+     * Creates a team in a specified workspace and sets user members and agent members at the same time. The user members must include exactly one member with the ADMIN role. Agent members can only have the LEADER or WORKER role.
      *
      * @param request - CreateTeamRequest
      * @returns CreateTeamResponse
@@ -865,7 +865,7 @@ class Client extends openapi_core_1.default {
         return await this.createTeamWithOptions(workspaceId, request, headers, runtime);
     }
     /**
-     * 创建用户
+     * Creates a user in a specified workspace. The username must be unique within the workspace and can contain only lowercase letters, digits, and hyphens. Reserved names such as manager, admin, or names starting with worker- cannot be used. If password is not specified, the server generates an initial password and returns it in the initialPassword field of the response.
      *
      * @param tmpReq - CreateUserRequest
      * @param headers - map
@@ -906,7 +906,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateUserResponse({}));
     }
     /**
-     * 创建用户
+     * Creates a user in a specified workspace. The username must be unique within the workspace and can contain only lowercase letters, digits, and hyphens. Reserved names such as manager, admin, or names starting with worker- cannot be used. If password is not specified, the server generates an initial password and returns it in the initialPassword field of the response.
      *
      * @param request - CreateUserRequest
      * @returns CreateUserResponse
@@ -975,7 +975,7 @@ class Client extends openapi_core_1.default {
         return await this.createWorkspaceWithOptions(request, headers, runtime);
     }
     /**
-     * 调试模型
+     * Calls a specified model through a published model connection to verify whether the model call chain is available.
      *
      * @param tmpReq - DebugModelRequest
      * @param headers - map
@@ -1011,7 +1011,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.DebugModelResponse({}));
     }
     /**
-     * 调试模型
+     * Calls a specified model through a published model connection to verify whether the model call chain is available.
      *
      * @param request - DebugModelRequest
      * @returns DebugModelResponse
@@ -1160,7 +1160,7 @@ class Client extends openapi_core_1.default {
         return await this.deleteAgentSpecVersionWithOptions(workspaceId, agentSpecName, request, headers, runtime);
     }
     /**
-     * 删除凭证
+     * Deletes a credential from the specified workspace and removes the ciphertext hosted in the credential service. After deletion, agents that are bound to this credential can no longer retrieve the credential content.
      *
      * @param request - DeleteCredentialRequest
      * @param headers - map
@@ -1191,7 +1191,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.DeleteCredentialResponse({}));
     }
     /**
-     * 删除凭证
+     * Deletes a credential from the specified workspace and removes the ciphertext hosted in the credential service. After deletion, agents that are bound to this credential can no longer retrieve the credential content.
      *
      * @param request - DeleteCredentialRequest
      * @returns DeleteCredentialResponse
@@ -1369,7 +1369,7 @@ class Client extends openapi_core_1.default {
         return await this.deleteMcpWithOptions(mcpServerId, workspaceId, request, headers, runtime);
     }
     /**
-     * 删除模型
+     * Deletes a model from a specified workspace. Models that are currently in use cannot be deleted.
      *
      * @param request - DeleteModelRequest
      * @param headers - map
@@ -1400,7 +1400,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.DeleteModelResponse({}));
     }
     /**
-     * 删除模型
+     * Deletes a model from a specified workspace. Models that are currently in use cannot be deleted.
      *
      * @param request - DeleteModelRequest
      * @returns DeleteModelResponse
@@ -1411,7 +1411,7 @@ class Client extends openapi_core_1.default {
         return await this.deleteModelWithOptions(workspaceId, modelId, request, headers, runtime);
     }
     /**
-     * 删除模型连接
+     * Submits an asynchronous deletion task for a specified model connection. The connection cannot be deleted if it has associated models or runtime references.
      *
      * @param request - DeleteModelConnectionRequest
      * @param headers - map
@@ -1442,7 +1442,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.DeleteModelConnectionResponse({}));
     }
     /**
-     * 删除模型连接
+     * Submits an asynchronous deletion task for a specified model connection. The connection cannot be deleted if it has associated models or runtime references.
      *
      * @param request - DeleteModelConnectionRequest
      * @returns DeleteModelConnectionResponse
@@ -1543,7 +1543,7 @@ class Client extends openapi_core_1.default {
         return await this.deleteSkillDraftWithOptions(workspaceId, skillName, request, headers, runtime);
     }
     /**
-     * 删除团队
+     * Deletes a team in the specified workspace. Deleting a team does not delete the users or agents in the team. It only dissociates the member relationships.
      *
      * @param request - DeleteTeamRequest
      * @param headers - map
@@ -1574,7 +1574,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.DeleteTeamResponse({}));
     }
     /**
-     * 删除团队
+     * Deletes a team in the specified workspace. Deleting a team does not delete the users or agents in the team. It only dissociates the member relationships.
      *
      * @param request - DeleteTeamRequest
      * @returns DeleteTeamResponse
@@ -1585,7 +1585,7 @@ class Client extends openapi_core_1.default {
         return await this.deleteTeamWithOptions(workspaceId, teamId, request, headers, runtime);
     }
     /**
-     * 删除用户
+     * Deletes a user from a specified workspace. A user cannot be deleted while the user is still a member of any team. Remove the user from all teams before deleting the user.
      *
      * @param request - DeleteUserRequest
      * @param headers - map
@@ -1616,7 +1616,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.DeleteUserResponse({}));
     }
     /**
-     * 删除用户
+     * Deletes a user from a specified workspace. A user cannot be deleted while the user is still a member of any team. Remove the user from all teams before deleting the user.
      *
      * @param request - DeleteUserRequest
      * @returns DeleteUserResponse
@@ -2048,7 +2048,7 @@ class Client extends openapi_core_1.default {
         return await this.getAgentSpecVersionWithOptions(workspaceId, agentSpecName, agentSpecVersion, request, headers, runtime);
     }
     /**
-     * 查询凭证
+     * Queries the details of a specified credential and returns the list of agents that are bound to the credential. The credential content is returned in masked form.
      *
      * @param request - GetCredentialRequest
      * @param headers - map
@@ -2074,7 +2074,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetCredentialResponse({}));
     }
     /**
-     * 查询凭证
+     * Queries the details of a specified credential and returns the list of agents that are bound to the credential. The credential content is returned in masked form.
      *
      * @param request - GetCredentialRequest
      * @returns GetCredentialResponse
@@ -2327,7 +2327,7 @@ class Client extends openapi_core_1.default {
         return await this.getModelWithOptions(workspaceId, modelId, request, headers, runtime);
     }
     /**
-     * 查询模型连接
+     * Queries the detailed configuration, credential configuration status, publish status, and region of a specified model connection.
      *
      * @param request - GetModelConnectionRequest
      * @param headers - map
@@ -2353,7 +2353,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetModelConnectionResponse({}));
     }
     /**
-     * 查询模型连接
+     * Queries the detailed configuration, credential configuration status, publish status, and region of a specified model connection.
      *
      * @param request - GetModelConnectionRequest
      * @returns GetModelConnectionResponse
@@ -2590,7 +2590,7 @@ class Client extends openapi_core_1.default {
         return await this.getSkillVersionDetailWithOptions(workspaceId, skillName, skillVersion, request, headers, runtime);
     }
     /**
-     * 查询团队
+     * Queries the details of a specified team. The response includes the complete properties and team roles of each user member and agent member in the team.
      *
      * @param request - GetTeamRequest
      * @param headers - map
@@ -2616,7 +2616,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetTeamResponse({}));
     }
     /**
-     * 查询团队
+     * Queries the details of a specified team. The response includes the complete properties and team roles of each user member and agent member in the team.
      *
      * @param request - GetTeamRequest
      * @returns GetTeamResponse
@@ -2627,7 +2627,7 @@ class Client extends openapi_core_1.default {
         return await this.getTeamWithOptions(workspaceId, teamId, request, headers, runtime);
     }
     /**
-     * 查询用户
+     * Queries the details of a specified user in a workspace. Returns an error if the user does not exist.
      *
      * @param request - GetUserRequest
      * @param headers - map
@@ -2653,7 +2653,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetUserResponse({}));
     }
     /**
-     * 查询用户
+     * Queries the details of a specified user in a workspace. Returns an error if the user does not exist.
      *
      * @param request - GetUserRequest
      * @returns GetUserResponse
@@ -2986,7 +2986,7 @@ class Client extends openapi_core_1.default {
         return await this.listAgentTeamsWithOptions(workspaceId, request, headers, runtime);
     }
     /**
-     * 查询凭证列表
+     * Queries credentials in a specified workspace by using paging. You can use credentialType to filter by type, nameLike to filter by credential name using fuzzy match, maxResults to specify the maximum number of records per page, and nextToken to retrieve the next page. If maxResults is not specified, the server returns 10 records by default.
      *
      * @param request - ListCredentialsRequest
      * @param headers - map
@@ -3002,6 +3002,9 @@ class Client extends openapi_core_1.default {
         if (!$dara.isNull(request.maxResults)) {
             query["maxResults"] = request.maxResults;
         }
+        if (!$dara.isNull(request.name)) {
+            query["name"] = request.name;
+        }
         if (!$dara.isNull(request.nameLike)) {
             query["nameLike"] = request.nameLike;
         }
@@ -3026,7 +3029,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListCredentialsResponse({}));
     }
     /**
-     * 查询凭证列表
+     * Queries credentials in a specified workspace by using paging. You can use credentialType to filter by type, nameLike to filter by credential name using fuzzy match, maxResults to specify the maximum number of records per page, and nextToken to retrieve the next page. If maxResults is not specified, the server returns 10 records by default.
      *
      * @param request - ListCredentialsRequest
      * @returns ListCredentialsResponse
@@ -3237,11 +3240,11 @@ class Client extends openapi_core_1.default {
         return await this.listMcpToolsWithOptions(workspaceId, mcpServerId, request, headers, runtime);
     }
     /**
-     * Queries MCP services and their configurations and statuses in a specified workspace by using paging.
+     * Queries MCP services and their configurations and statuses in a specified workspace by page.
      *
      * @remarks
      * ## Operation description
-     * Queries MCP services and their configurations and statuses in a specified workspace by using paging.
+     * Queries MCP services and their configurations and statuses in a specified workspace by page.
      *
      * @param request - ListMcpsRequest
      * @param headers - map
@@ -3281,11 +3284,11 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListMcpsResponse({}));
     }
     /**
-     * Queries MCP services and their configurations and statuses in a specified workspace by using paging.
+     * Queries MCP services and their configurations and statuses in a specified workspace by page.
      *
      * @remarks
      * ## Operation description
-     * Queries MCP services and their configurations and statuses in a specified workspace by using paging.
+     * Queries MCP services and their configurations and statuses in a specified workspace by page.
      *
      * @param request - ListMcpsRequest
      * @returns ListMcpsResponse
@@ -3296,10 +3299,10 @@ class Client extends openapi_core_1.default {
         return await this.listMcpsWithOptions(workspaceId, request, headers, runtime);
     }
     /**
-     * 查询模型连接列表
+     * Queries model connections in a specified workspace with paging. Supports filtering by name, provider type, and invoke protocol.
      *
      * @remarks
-     * 查询指定 AgentCore 工作空间中的模型连接。支持通过 `Name` 按名称筛选，并通过 `SearchType` 选择精确匹配或模糊匹配；支持按模型提供商类型和调用协议筛选，并支持分页查询。
+     * Queries model connections in a specified AgentCore workspace. Supports filtering by name through `Name` and selecting exact match or fuzzy match through `SearchType`. Also supports filtering by model provider type and invoke protocol, and supports paging.
      *
      * @param request - ListModelConnectionsRequest
      * @param headers - map
@@ -3348,10 +3351,10 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListModelConnectionsResponse({}));
     }
     /**
-     * 查询模型连接列表
+     * Queries model connections in a specified workspace with paging. Supports filtering by name, provider type, and invoke protocol.
      *
      * @remarks
-     * 查询指定 AgentCore 工作空间中的模型连接。支持通过 `Name` 按名称筛选，并通过 `SearchType` 选择精确匹配或模糊匹配；支持按模型提供商类型和调用协议筛选，并支持分页查询。
+     * Queries model connections in a specified AgentCore workspace. Supports filtering by name through `Name` and selecting exact match or fuzzy match through `SearchType`. Also supports filtering by model provider type and invoke protocol, and supports paging.
      *
      * @param request - ListModelConnectionsRequest
      * @returns ListModelConnectionsResponse
@@ -3630,7 +3633,7 @@ class Client extends openapi_core_1.default {
         return await this.listSkillsWithOptions(workspaceId, request, headers, runtime);
     }
     /**
-     * 查询团队列表
+     * Queries teams in a specified workspace by paging. Use nameLike to filter by team name with fuzzy match, maxResults to specify the maximum number of records per page, and nextToken to retrieve the next page. If maxResults is not specified, the server returns 10 records by default. Member information in the list includes only the member identity, name, and team role.
      *
      * @param request - ListTeamsRequest
      * @param headers - map
@@ -3667,7 +3670,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListTeamsResponse({}));
     }
     /**
-     * 查询团队列表
+     * Queries teams in a specified workspace by paging. Use nameLike to filter by team name with fuzzy match, maxResults to specify the maximum number of records per page, and nextToken to retrieve the next page. If maxResults is not specified, the server returns 10 records by default. Member information in the list includes only the member identity, name, and team role.
      *
      * @param request - ListTeamsRequest
      * @returns ListTeamsResponse
@@ -4058,7 +4061,7 @@ class Client extends openapi_core_1.default {
         return await this.redraftSkillVersionWithOptions(workspaceId, skillName, skillVersion, request, headers, runtime);
     }
     /**
-     * 重置用户密码
+     * Resets the logon password of a specified user. Specify the user by agentCoreUserId or username. At least one of the two parameters must be specified. Only users who use workspace local password authentication can be reset. If password is not specified, the server generates a random password and returns it in the response.
      *
      * @param tmpReq - ResetUserPasswordRequest
      * @param headers - map
@@ -4094,7 +4097,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ResetUserPasswordResponse({}));
     }
     /**
-     * 重置用户密码
+     * Resets the logon password of a specified user. Specify the user by agentCoreUserId or username. At least one of the two parameters must be specified. Only users who use workspace local password authentication can be reset. If password is not specified, the server generates a random password and returns it in the response.
      *
      * @param request - ResetUserPasswordRequest
      * @returns ResetUserPasswordResponse
@@ -4386,7 +4389,7 @@ class Client extends openapi_core_1.default {
         return await this.updateAgentSpecWithOptions(workspaceId, agentSpecName, request, headers, runtime);
     }
     /**
-     * 更新凭证
+     * Updates the content or description of a specified credential. At least one of credentialMetadata and description must be specified. Unspecified properties remain unchanged. The credential name and credential type cannot be modified after creation.
      *
      * @param tmpReq - UpdateCredentialRequest
      * @param headers - map
@@ -4427,7 +4430,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.UpdateCredentialResponse({}));
     }
     /**
-     * 更新凭证
+     * Updates the content or description of a specified credential. At least one of credentialMetadata and description must be specified. Unspecified properties remain unchanged. The credential name and credential type cannot be modified after creation.
      *
      * @param request - UpdateCredentialRequest
      * @returns UpdateCredentialResponse
@@ -4655,7 +4658,12 @@ class Client extends openapi_core_1.default {
         return await this.updateMcpWithOptions(workspaceId, mcpServerId, request, headers, runtime);
     }
     /**
-     * Updates the description of a specified model. Other model configurations cannot be modified through this operation.
+     * Updates the description, context token limit, maximum output token count, or capability configuration of a specified model.
+     *
+     * @remarks
+     * This operation updates description, contextSize, maxTokens, and capabilities. At least one non-null parameter must be provided. Parameters that are not provided or set to null retain their original values. The capabilities object is replaced as a whole. Capability fields not included in the object are treated as false.
+     * Modifying only description does not refresh the model configuration of associated agents. When contextSize, maxTokens, or capabilities actually change, the system asynchronously refreshes managed agents that reference the model within the same workspace, as well as external agents whose model source is PLATFORM. External agents whose model source is RUNTIME are not affected. Submitting the same configuration repeatedly does not trigger a new model configuration refresh.
+     * A successful response indicates that the model configuration has been saved. It does not indicate that associated agents have completed the configuration refresh or that the runtime has loaded the new configuration. Call GetModel to query the saved model configuration.
      *
      * @param tmpReq - UpdateModelRequest
      * @param headers - map
@@ -4696,7 +4704,12 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.UpdateModelResponse({}));
     }
     /**
-     * Updates the description of a specified model. Other model configurations cannot be modified through this operation.
+     * Updates the description, context token limit, maximum output token count, or capability configuration of a specified model.
+     *
+     * @remarks
+     * This operation updates description, contextSize, maxTokens, and capabilities. At least one non-null parameter must be provided. Parameters that are not provided or set to null retain their original values. The capabilities object is replaced as a whole. Capability fields not included in the object are treated as false.
+     * Modifying only description does not refresh the model configuration of associated agents. When contextSize, maxTokens, or capabilities actually change, the system asynchronously refreshes managed agents that reference the model within the same workspace, as well as external agents whose model source is PLATFORM. External agents whose model source is RUNTIME are not affected. Submitting the same configuration repeatedly does not trigger a new model configuration refresh.
+     * A successful response indicates that the model configuration has been saved. It does not indicate that associated agents have completed the configuration refresh or that the runtime has loaded the new configuration. Call GetModel to query the saved model configuration.
      *
      * @param request - UpdateModelRequest
      * @returns UpdateModelResponse
@@ -4924,7 +4937,7 @@ class Client extends openapi_core_1.default {
         return await this.updateSkillScopeWithOptions(workspaceId, skillName, request, headers, runtime);
     }
     /**
-     * 更新团队
+     * Updates the description and members of a specified team. When users or agents are passed in, the corresponding member list is replaced using full overwrite semantics. Member lists that are not passed in remain unchanged. The team name cannot be modified after creation.
      *
      * @param tmpReq - UpdateTeamRequest
      * @param headers - map
@@ -4965,7 +4978,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.UpdateTeamResponse({}));
     }
     /**
-     * 更新团队
+     * Updates the description and members of a specified team. When users or agents are passed in, the corresponding member list is replaced using full overwrite semantics. Member lists that are not passed in remain unchanged. The team name cannot be modified after creation.
      *
      * @param request - UpdateTeamRequest
      * @returns UpdateTeamResponse
@@ -4976,7 +4989,7 @@ class Client extends openapi_core_1.default {
         return await this.updateTeamWithOptions(workspaceId, teamId, request, headers, runtime);
     }
     /**
-     * 更新用户
+     * Updates the display name, email address, or note of a specified user. At least one of displayName, email, and note must be specified. Unspecified properties remain unchanged. The username cannot be modified after creation.
      *
      * @param tmpReq - UpdateUserRequest
      * @param headers - map
@@ -5017,7 +5030,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.UpdateUserResponse({}));
     }
     /**
-     * 更新用户
+     * Updates the display name, email address, or note of a specified user. At least one of displayName, email, and note must be specified. Unspecified properties remain unchanged. The username cannot be modified after creation.
      *
      * @param request - UpdateUserRequest
      * @returns UpdateUserResponse