@alicloud/winnexo20260512 1.2.0 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (185) hide show
  1. package/dist/client.d.ts +229 -159
  2. package/dist/client.js +351 -164
  3. package/dist/client.js.map +1 -1
  4. package/dist/models/BatchRemoveOperatingObjectFavoritesRequest.d.ts +61 -0
  5. package/dist/models/BatchRemoveOperatingObjectFavoritesRequest.js +69 -0
  6. package/dist/models/BatchRemoveOperatingObjectFavoritesRequest.js.map +1 -0
  7. package/dist/models/BatchRemoveOperatingObjectFavoritesResponse.d.ts +19 -0
  8. package/dist/models/BatchRemoveOperatingObjectFavoritesResponse.js +69 -0
  9. package/dist/models/BatchRemoveOperatingObjectFavoritesResponse.js.map +1 -0
  10. package/dist/models/BatchRemoveOperatingObjectFavoritesResponseBody.d.ts +128 -0
  11. package/dist/models/BatchRemoveOperatingObjectFavoritesResponseBody.js +104 -0
  12. package/dist/models/BatchRemoveOperatingObjectFavoritesResponseBody.js.map +1 -0
  13. package/dist/models/BatchRemoveOperatingObjectFavoritesShrinkRequest.d.ts +61 -0
  14. package/dist/models/BatchRemoveOperatingObjectFavoritesShrinkRequest.js +66 -0
  15. package/dist/models/BatchRemoveOperatingObjectFavoritesShrinkRequest.js.map +1 -0
  16. package/dist/models/CheckHealthResponseBody.d.ts +3 -3
  17. package/dist/models/ClearOperatingObjectFavoritesRequest.d.ts +51 -0
  18. package/dist/models/ClearOperatingObjectFavoritesRequest.js +64 -0
  19. package/dist/models/ClearOperatingObjectFavoritesRequest.js.map +1 -0
  20. package/dist/models/ClearOperatingObjectFavoritesResponse.d.ts +19 -0
  21. package/dist/models/ClearOperatingObjectFavoritesResponse.js +69 -0
  22. package/dist/models/ClearOperatingObjectFavoritesResponse.js.map +1 -0
  23. package/dist/models/ClearOperatingObjectFavoritesResponseBody.d.ts +85 -0
  24. package/dist/models/ClearOperatingObjectFavoritesResponseBody.js +74 -0
  25. package/dist/models/ClearOperatingObjectFavoritesResponseBody.js.map +1 -0
  26. package/dist/models/CreateAnnouncementRequest.d.ts +2 -2
  27. package/dist/models/CreateAnnouncementResponseBody.d.ts +3 -3
  28. package/dist/models/CreateAnnouncementShrinkRequest.d.ts +2 -2
  29. package/dist/models/CreateConversationResponseBody.d.ts +3 -3
  30. package/dist/models/CreateGroupAliDingChatRequest.d.ts +0 -2
  31. package/dist/models/CreateGroupAliDingChatRequest.js +0 -2
  32. package/dist/models/CreateGroupAliDingChatRequest.js.map +1 -1
  33. package/dist/models/CreateGroupDingtalkChatRequest.d.ts +6 -6
  34. package/dist/models/CreateGroupDingtalkChatResponseBody.d.ts +4 -4
  35. package/dist/models/CreateGroupDingtalkChatShrinkRequest.d.ts +6 -6
  36. package/dist/models/CreateGroupFeishuDocRequest.d.ts +2 -2
  37. package/dist/models/CreateGroupFeishuDocResponseBody.d.ts +3 -3
  38. package/dist/models/CreateGroupFeishuDocShrinkRequest.d.ts +2 -2
  39. package/dist/models/CreateKnowledgeBaseAliDingDocResponseBody.d.ts +1 -1
  40. package/dist/models/CreatePersonalDingtalkMeetingResponseBody.d.ts +1 -1
  41. package/dist/models/CreatePersonalDirectoryRequest.d.ts +2 -2
  42. package/dist/models/CreatePersonalDirectoryResponseBody.d.ts +4 -4
  43. package/dist/models/CreateTenantDirectoryRequest.d.ts +1 -1
  44. package/dist/models/CreateTenantDirectoryResponseBody.d.ts +3 -3
  45. package/dist/models/CreateUserRequest.d.ts +10 -2
  46. package/dist/models/CreateUserRequest.js +2 -0
  47. package/dist/models/CreateUserRequest.js.map +1 -1
  48. package/dist/models/CreateUserShrinkRequest.d.ts +10 -2
  49. package/dist/models/CreateUserShrinkRequest.js +2 -0
  50. package/dist/models/CreateUserShrinkRequest.js.map +1 -1
  51. package/dist/models/CreateUserWithGroupsRequest.d.ts +7 -7
  52. package/dist/models/CreateUserWithGroupsResponseBody.d.ts +7 -7
  53. package/dist/models/CreateUserWithGroupsShrinkRequest.d.ts +7 -7
  54. package/dist/models/DeleteChatSessionRequest.d.ts +2 -2
  55. package/dist/models/GetChatSessionRequest.d.ts +1 -1
  56. package/dist/models/GetChatSessionResponseBody.d.ts +3 -3
  57. package/dist/models/GetScheduledTaskUnderstandDetailRequest.d.ts +3 -3
  58. package/dist/models/GetScheduledTaskUnderstandDetailResponseBody.d.ts +1 -1
  59. package/dist/models/GetScheduledTaskUnderstandDetailShrinkRequest.d.ts +2 -2
  60. package/dist/models/GetSourceRequest.d.ts +1 -1
  61. package/dist/models/GetSourceResponseBody.d.ts +4 -4
  62. package/dist/models/ListActiveAnnouncementsRequest.d.ts +3 -3
  63. package/dist/models/ListActiveAnnouncementsResponseBody.d.ts +7 -7
  64. package/dist/models/ListBillingRequest.d.ts +6 -6
  65. package/dist/models/ListBillingResponseBody.d.ts +5 -5
  66. package/dist/models/ListOperatingObjectFavoritesRequest.d.ts +67 -0
  67. package/dist/models/ListOperatingObjectFavoritesRequest.js +68 -0
  68. package/dist/models/ListOperatingObjectFavoritesRequest.js.map +1 -0
  69. package/dist/models/ListOperatingObjectFavoritesResponse.d.ts +19 -0
  70. package/dist/models/ListOperatingObjectFavoritesResponse.js +69 -0
  71. package/dist/models/ListOperatingObjectFavoritesResponse.js.map +1 -0
  72. package/dist/models/ListOperatingObjectFavoritesResponseBody.d.ts +158 -0
  73. package/dist/models/ListOperatingObjectFavoritesResponseBody.js +110 -0
  74. package/dist/models/ListOperatingObjectFavoritesResponseBody.js.map +1 -0
  75. package/dist/models/ListOutputFilesRequest.d.ts +3 -3
  76. package/dist/models/ListOutputFilesResponseBody.d.ts +2 -2
  77. package/dist/models/ListScheduledTasksRequest.d.ts +3 -3
  78. package/dist/models/ListScheduledTasksResponseBody.d.ts +7 -7
  79. package/dist/models/ListScheduledTasksShrinkRequest.d.ts +3 -3
  80. package/dist/models/ListSkillsRequest.d.ts +1 -1
  81. package/dist/models/ListSkillsResponseBody.d.ts +3 -3
  82. package/dist/models/ListSkillsShrinkRequest.d.ts +1 -1
  83. package/dist/models/ListVisibleKnowledgeBasesHeaders.d.ts +1 -1
  84. package/dist/models/ListVisibleKnowledgeBasesResponseBody.d.ts +7 -7
  85. package/dist/models/OfflineAnnouncementRequest.d.ts +1 -1
  86. package/dist/models/OfflineAnnouncementResponseBody.d.ts +1 -1
  87. package/dist/models/QueryPrimaryObjectDataRequest.d.ts +5 -5
  88. package/dist/models/QueryPrimaryObjectDataResponseBody.d.ts +1 -1
  89. package/dist/models/RecommendNextActionsRequest.d.ts +1 -1
  90. package/dist/models/RecommendNextActionsResponseBody.d.ts +1 -1
  91. package/dist/models/RetryDirectoryFailedSourcesRequest.d.ts +1 -1
  92. package/dist/models/RetryDirectoryFailedSourcesResponseBody.d.ts +2 -2
  93. package/dist/models/RetryKnowledgeBaseFailedSourcesRequest.d.ts +2 -2
  94. package/dist/models/RetryKnowledgeBaseFailedSourcesResponseBody.d.ts +2 -2
  95. package/dist/models/SendAsyncChatMessageResponseBody.d.ts +1 -1
  96. package/dist/models/SendChatMessageRequest.d.ts +2 -2
  97. package/dist/models/SendChatMessageShrinkRequest.d.ts +2 -2
  98. package/dist/models/StreamChatMessageRequest.d.ts +2 -2
  99. package/dist/models/StreamChatMessageResponseBody.d.ts +17 -1
  100. package/dist/models/StreamChatMessageResponseBody.js +4 -0
  101. package/dist/models/StreamChatMessageResponseBody.js.map +1 -1
  102. package/dist/models/UpdateChatSessionResponseBody.d.ts +1 -1
  103. package/dist/models/UploadChatFileAdvanceRequest.d.ts +13 -13
  104. package/dist/models/UploadChatFileRequest.d.ts +13 -13
  105. package/dist/models/UploadChatFileResponseBody.d.ts +13 -13
  106. package/dist/models/model.d.ts +12 -0
  107. package/dist/models/model.js +35 -11
  108. package/dist/models/model.js.map +1 -1
  109. package/package.json +1 -1
  110. package/src/client.ts +374 -164
  111. package/src/models/BatchRemoveOperatingObjectFavoritesRequest.ts +85 -0
  112. package/src/models/BatchRemoveOperatingObjectFavoritesResponse.ts +40 -0
  113. package/src/models/BatchRemoveOperatingObjectFavoritesResponseBody.ts +176 -0
  114. package/src/models/BatchRemoveOperatingObjectFavoritesShrinkRequest.ts +82 -0
  115. package/src/models/CheckHealthResponseBody.ts +3 -3
  116. package/src/models/ClearOperatingObjectFavoritesRequest.ts +70 -0
  117. package/src/models/ClearOperatingObjectFavoritesResponse.ts +40 -0
  118. package/src/models/ClearOperatingObjectFavoritesResponseBody.ts +114 -0
  119. package/src/models/CreateAnnouncementRequest.ts +2 -2
  120. package/src/models/CreateAnnouncementResponseBody.ts +3 -3
  121. package/src/models/CreateAnnouncementShrinkRequest.ts +2 -2
  122. package/src/models/CreateConversationResponseBody.ts +3 -3
  123. package/src/models/CreateGroupAliDingChatRequest.ts +0 -2
  124. package/src/models/CreateGroupDingtalkChatRequest.ts +6 -6
  125. package/src/models/CreateGroupDingtalkChatResponseBody.ts +4 -4
  126. package/src/models/CreateGroupDingtalkChatShrinkRequest.ts +6 -6
  127. package/src/models/CreateGroupFeishuDocRequest.ts +2 -2
  128. package/src/models/CreateGroupFeishuDocResponseBody.ts +3 -3
  129. package/src/models/CreateGroupFeishuDocShrinkRequest.ts +2 -2
  130. package/src/models/CreateKnowledgeBaseAliDingDocResponseBody.ts +1 -1
  131. package/src/models/CreatePersonalDingtalkMeetingResponseBody.ts +1 -1
  132. package/src/models/CreatePersonalDirectoryRequest.ts +2 -2
  133. package/src/models/CreatePersonalDirectoryResponseBody.ts +4 -4
  134. package/src/models/CreateTenantDirectoryRequest.ts +1 -1
  135. package/src/models/CreateTenantDirectoryResponseBody.ts +3 -3
  136. package/src/models/CreateUserRequest.ts +12 -2
  137. package/src/models/CreateUserShrinkRequest.ts +12 -2
  138. package/src/models/CreateUserWithGroupsRequest.ts +7 -7
  139. package/src/models/CreateUserWithGroupsResponseBody.ts +7 -7
  140. package/src/models/CreateUserWithGroupsShrinkRequest.ts +7 -7
  141. package/src/models/DeleteChatSessionRequest.ts +2 -2
  142. package/src/models/GetChatSessionRequest.ts +1 -1
  143. package/src/models/GetChatSessionResponseBody.ts +3 -3
  144. package/src/models/GetScheduledTaskUnderstandDetailRequest.ts +3 -3
  145. package/src/models/GetScheduledTaskUnderstandDetailResponseBody.ts +1 -1
  146. package/src/models/GetScheduledTaskUnderstandDetailShrinkRequest.ts +2 -2
  147. package/src/models/GetSourceRequest.ts +1 -1
  148. package/src/models/GetSourceResponseBody.ts +4 -4
  149. package/src/models/ListActiveAnnouncementsRequest.ts +3 -3
  150. package/src/models/ListActiveAnnouncementsResponseBody.ts +7 -7
  151. package/src/models/ListBillingRequest.ts +6 -6
  152. package/src/models/ListBillingResponseBody.ts +5 -5
  153. package/src/models/ListOperatingObjectFavoritesRequest.ts +90 -0
  154. package/src/models/ListOperatingObjectFavoritesResponse.ts +40 -0
  155. package/src/models/ListOperatingObjectFavoritesResponseBody.ts +214 -0
  156. package/src/models/ListOutputFilesRequest.ts +3 -3
  157. package/src/models/ListOutputFilesResponseBody.ts +2 -2
  158. package/src/models/ListScheduledTasksRequest.ts +3 -3
  159. package/src/models/ListScheduledTasksResponseBody.ts +7 -7
  160. package/src/models/ListScheduledTasksShrinkRequest.ts +3 -3
  161. package/src/models/ListSkillsRequest.ts +1 -1
  162. package/src/models/ListSkillsResponseBody.ts +3 -3
  163. package/src/models/ListSkillsShrinkRequest.ts +1 -1
  164. package/src/models/ListVisibleKnowledgeBasesHeaders.ts +1 -1
  165. package/src/models/ListVisibleKnowledgeBasesResponseBody.ts +7 -7
  166. package/src/models/OfflineAnnouncementRequest.ts +1 -1
  167. package/src/models/OfflineAnnouncementResponseBody.ts +1 -1
  168. package/src/models/QueryPrimaryObjectDataRequest.ts +5 -5
  169. package/src/models/QueryPrimaryObjectDataResponseBody.ts +1 -1
  170. package/src/models/RecommendNextActionsRequest.ts +1 -1
  171. package/src/models/RecommendNextActionsResponseBody.ts +1 -1
  172. package/src/models/RetryDirectoryFailedSourcesRequest.ts +1 -1
  173. package/src/models/RetryDirectoryFailedSourcesResponseBody.ts +2 -2
  174. package/src/models/RetryKnowledgeBaseFailedSourcesRequest.ts +2 -2
  175. package/src/models/RetryKnowledgeBaseFailedSourcesResponseBody.ts +2 -2
  176. package/src/models/SendAsyncChatMessageResponseBody.ts +1 -1
  177. package/src/models/SendChatMessageRequest.ts +2 -2
  178. package/src/models/SendChatMessageShrinkRequest.ts +2 -2
  179. package/src/models/StreamChatMessageRequest.ts +2 -2
  180. package/src/models/StreamChatMessageResponseBody.ts +21 -1
  181. package/src/models/UpdateChatSessionResponseBody.ts +1 -1
  182. package/src/models/UploadChatFileAdvanceRequest.ts +13 -13
  183. package/src/models/UploadChatFileRequest.ts +13 -13
  184. package/src/models/UploadChatFileResponseBody.ts +13 -13
  185. package/src/models/model.ts +12 -0
package/dist/client.js CHANGED
@@ -66,11 +66,6 @@ class Client extends openapi_core_1.default {
66
66
  constructor(config) {
67
67
  super(config);
68
68
  this._endpointRule = "regional";
69
- this._endpointMap = {
70
- 'cn-shanghai': "winnexo.cn-shanghai.aliyuncs.com",
71
- 'cn-zhangjiakou': "winnexo.cn-zhangjiakou.aliyuncs.com",
72
- 'cn-hangzhou': "winnexo.cn-hangzhou.aliyuncs.com",
73
- };
74
69
  this.checkConfig(config);
75
70
  this._endpoint = this.getEndpoint("winnexo", this._regionId, this._endpointRule, this._network, this._suffix, this._endpointMap, this._endpoint);
76
71
  }
@@ -230,6 +225,73 @@ class Client extends openapi_core_1.default {
230
225
  let headers = {};
231
226
  return await this.addUserGroupMembersWithOptions(request, headers, runtime);
232
227
  }
228
+ /**
229
+ * Batch cancels digital employee favorites for specific object types.
230
+ *
231
+ * @remarks
232
+ * Idempotently cancels favorites across three independent dimensions: graphName, operatingObjectName, and objectType. The input array accepts 1 to 200 items per request. Each item must be a non-empty string with a maximum length of 128 characters. The server validates and deduplicates items while preserving order. Non-string values, values that exceed the length limit, or arrays that exceed the size limit are rejected. Deletion, per-item status updates, and remaining valid count are completed within a single transaction. To safely cancel all favorites, you must also call ClearOperatingObjectFavorites to clean up historical records, MISSING records, or permission-hidden records that are not visible in the list. Then read back the result to confirm that total is 0.
233
+ *
234
+ * @param tmpReq - BatchRemoveOperatingObjectFavoritesRequest
235
+ * @param headers - map
236
+ * @param runtime - runtime options for this request RuntimeOptions
237
+ * @returns BatchRemoveOperatingObjectFavoritesResponse
238
+ */
239
+ async batchRemoveOperatingObjectFavoritesWithOptions(tmpReq, headers, runtime) {
240
+ tmpReq.validate();
241
+ let request = new $_model.BatchRemoveOperatingObjectFavoritesShrinkRequest({});
242
+ openapi_core_2.OpenApiUtil.convert(tmpReq, request);
243
+ if (!$dara.isNull(tmpReq.objectIds)) {
244
+ request.objectIdsShrink = openapi_core_2.OpenApiUtil.arrayToStringWithSpecifiedStyle(tmpReq.objectIds, "objectIds", "json");
245
+ }
246
+ let query = {};
247
+ if (!$dara.isNull(request.tenantId)) {
248
+ query["tenantId"] = request.tenantId;
249
+ }
250
+ let body = {};
251
+ if (!$dara.isNull(request.graphName)) {
252
+ body["graphName"] = request.graphName;
253
+ }
254
+ if (!$dara.isNull(request.objectIdsShrink)) {
255
+ body["objectIds"] = request.objectIdsShrink;
256
+ }
257
+ if (!$dara.isNull(request.objectType)) {
258
+ body["objectType"] = request.objectType;
259
+ }
260
+ if (!$dara.isNull(request.operatingObjectName)) {
261
+ body["operatingObjectName"] = request.operatingObjectName;
262
+ }
263
+ let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
264
+ headers: headers,
265
+ query: openapi_core_2.OpenApiUtil.query(query),
266
+ body: openapi_core_2.OpenApiUtil.parseToMap(body),
267
+ });
268
+ let params = new openapi_core_2.$OpenApiUtil.Params({
269
+ action: "BatchRemoveOperatingObjectFavorites",
270
+ version: "2026-05-12",
271
+ protocol: "HTTPS",
272
+ pathname: `/openapi/batchRemoveOperatingObjectFavorites`,
273
+ method: "POST",
274
+ authType: "AK",
275
+ style: "ROA",
276
+ reqBodyType: "formData",
277
+ bodyType: "json",
278
+ });
279
+ return $dara.cast(await this.callApi(params, req, runtime), new $_model.BatchRemoveOperatingObjectFavoritesResponse({}));
280
+ }
281
+ /**
282
+ * Batch cancels digital employee favorites for specific object types.
283
+ *
284
+ * @remarks
285
+ * Idempotently cancels favorites across three independent dimensions: graphName, operatingObjectName, and objectType. The input array accepts 1 to 200 items per request. Each item must be a non-empty string with a maximum length of 128 characters. The server validates and deduplicates items while preserving order. Non-string values, values that exceed the length limit, or arrays that exceed the size limit are rejected. Deletion, per-item status updates, and remaining valid count are completed within a single transaction. To safely cancel all favorites, you must also call ClearOperatingObjectFavorites to clean up historical records, MISSING records, or permission-hidden records that are not visible in the list. Then read back the result to confirm that total is 0.
286
+ *
287
+ * @param request - BatchRemoveOperatingObjectFavoritesRequest
288
+ * @returns BatchRemoveOperatingObjectFavoritesResponse
289
+ */
290
+ async batchRemoveOperatingObjectFavorites(request) {
291
+ let runtime = new $dara.RuntimeOptions({});
292
+ let headers = {};
293
+ return await this.batchRemoveOperatingObjectFavoritesWithOptions(request, headers, runtime);
294
+ }
233
295
  /**
234
296
  * Performs a service health check.
235
297
  *
@@ -272,15 +334,74 @@ class Client extends openapi_core_1.default {
272
334
  let headers = {};
273
335
  return await this.checkHealthWithOptions(request, headers, runtime);
274
336
  }
337
+ /**
338
+ * Clears all follows of a specific object type for a digital employee.
339
+ *
340
+ * @remarks
341
+ * Clears all persisted follows for the current calling user across three independent dimensions: graphName, operatingObjectName, and objectType. This includes historical records, MISSING records, and permission-hidden records that are not visible in the list. The operation does not return invisible object IDs and verifies that the remaining physical record count is zero within the same transaction.
342
+ *
343
+ * @param request - ClearOperatingObjectFavoritesRequest
344
+ * @param headers - map
345
+ * @param runtime - runtime options for this request RuntimeOptions
346
+ * @returns ClearOperatingObjectFavoritesResponse
347
+ */
348
+ async clearOperatingObjectFavoritesWithOptions(request, headers, runtime) {
349
+ request.validate();
350
+ let query = {};
351
+ if (!$dara.isNull(request.tenantId)) {
352
+ query["tenantId"] = request.tenantId;
353
+ }
354
+ let body = {};
355
+ if (!$dara.isNull(request.graphName)) {
356
+ body["graphName"] = request.graphName;
357
+ }
358
+ if (!$dara.isNull(request.objectType)) {
359
+ body["objectType"] = request.objectType;
360
+ }
361
+ if (!$dara.isNull(request.operatingObjectName)) {
362
+ body["operatingObjectName"] = request.operatingObjectName;
363
+ }
364
+ let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
365
+ headers: headers,
366
+ query: openapi_core_2.OpenApiUtil.query(query),
367
+ body: openapi_core_2.OpenApiUtil.parseToMap(body),
368
+ });
369
+ let params = new openapi_core_2.$OpenApiUtil.Params({
370
+ action: "ClearOperatingObjectFavorites",
371
+ version: "2026-05-12",
372
+ protocol: "HTTPS",
373
+ pathname: `/openapi/clearOperatingObjectFavorites`,
374
+ method: "POST",
375
+ authType: "AK",
376
+ style: "ROA",
377
+ reqBodyType: "formData",
378
+ bodyType: "json",
379
+ });
380
+ return $dara.cast(await this.callApi(params, req, runtime), new $_model.ClearOperatingObjectFavoritesResponse({}));
381
+ }
382
+ /**
383
+ * Clears all follows of a specific object type for a digital employee.
384
+ *
385
+ * @remarks
386
+ * Clears all persisted follows for the current calling user across three independent dimensions: graphName, operatingObjectName, and objectType. This includes historical records, MISSING records, and permission-hidden records that are not visible in the list. The operation does not return invisible object IDs and verifies that the remaining physical record count is zero within the same transaction.
387
+ *
388
+ * @param request - ClearOperatingObjectFavoritesRequest
389
+ * @returns ClearOperatingObjectFavoritesResponse
390
+ */
391
+ async clearOperatingObjectFavorites(request) {
392
+ let runtime = new $dara.RuntimeOptions({});
393
+ let headers = {};
394
+ return await this.clearOperatingObjectFavoritesWithOptions(request, headers, runtime);
395
+ }
275
396
  /**
276
397
  * Creates a service notice.
277
398
  *
278
399
  * @remarks
279
- * ## Operation description
280
- * Creates a service notice. The caller identity must be mapped to a real platform user in the system O&M tenant and must have notice management permissions.
400
+ * ## Request description
401
+ * Creates a service notice. The caller must be mapped to a real platform user in the system O&M tenant and must have announcement management permissions.
281
402
  * - `priority`: The importance level of the notice. Valid values: URGENT, IMPORTANT, and GENERAL.
282
403
  * - `targetTenantIds` / `targetRoleCodes`: Used only when the corresponding target mode is set to SPECIFIED. Pass values as a JSON array.
283
- * - `effectiveStart` / `effectiveEnd`: ISO 8601 timestamps with time zone information.
404
+ * - `effectiveStart` / `effectiveEnd`: ISO 8601 time with time zone.
284
405
  * - `publishNow`: If set to true, the notice is published immediately after creation. Otherwise, it is saved as a draft.
285
406
  *
286
407
  * @param tmpReq - CreateAnnouncementRequest
@@ -361,11 +482,11 @@ class Client extends openapi_core_1.default {
361
482
  * Creates a service notice.
362
483
  *
363
484
  * @remarks
364
- * ## Operation description
365
- * Creates a service notice. The caller identity must be mapped to a real platform user in the system O&M tenant and must have notice management permissions.
485
+ * ## Request description
486
+ * Creates a service notice. The caller must be mapped to a real platform user in the system O&M tenant and must have announcement management permissions.
366
487
  * - `priority`: The importance level of the notice. Valid values: URGENT, IMPORTANT, and GENERAL.
367
488
  * - `targetTenantIds` / `targetRoleCodes`: Used only when the corresponding target mode is set to SPECIFIED. Pass values as a JSON array.
368
- * - `effectiveStart` / `effectiveEnd`: ISO 8601 timestamps with time zone information.
489
+ * - `effectiveStart` / `effectiveEnd`: ISO 8601 time with time zone.
369
490
  * - `publishNow`: If set to true, the notice is published immediately after creation. Otherwise, it is saved as a draft.
370
491
  *
371
492
  * @param request - CreateAnnouncementRequest
@@ -596,15 +717,15 @@ class Client extends openapi_core_1.default {
596
717
  return await this.createGroupAliDingChatWithOptions(request, headers, runtime);
597
718
  }
598
719
  /**
599
- * Creates a group-level DingTalk chat knowledge source.
720
+ * Creates knowledge from a standard DingTalk group chat for a group.
600
721
  *
601
722
  * @remarks
602
- * ## Operation description
603
- * - Connects a specified DingTalk chat to the knowledge base of a group that the caller has joined.
723
+ * ## Request description
724
+ * - Connects a specified standard DingTalk group chat to the group knowledge base that the caller has joined.
604
725
  * - The resource type is fixed to DINGTALK, the scope is fixed to GROUP, and the owning user is parsed from the gateway authentication identity.
605
726
  * - groupId, chatId, and historyStartTime are required.
606
- * - updateFrequency can be configured by using a preset or a five-field cron expression for subsequent synchronization frequency.
607
- * - The server verifies the caller\\"s group membership and the target group directory permissions. The same chat can be created as different sources.
727
+ * - updateFrequency can be configured through preset or a five-segment cron expression for subsequent synchronization frequency.
728
+ * - The server verifies the caller\\"s group member identity and target group directory permissions. The same group chat can be created as different Sources.
608
729
  *
609
730
  * @param tmpReq - CreateGroupDingtalkChatRequest
610
731
  * @param headers - map
@@ -672,15 +793,15 @@ class Client extends openapi_core_1.default {
672
793
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateGroupDingtalkChatResponse({}));
673
794
  }
674
795
  /**
675
- * Creates a group-level DingTalk chat knowledge source.
796
+ * Creates knowledge from a standard DingTalk group chat for a group.
676
797
  *
677
798
  * @remarks
678
- * ## Operation description
679
- * - Connects a specified DingTalk chat to the knowledge base of a group that the caller has joined.
799
+ * ## Request description
800
+ * - Connects a specified standard DingTalk group chat to the group knowledge base that the caller has joined.
680
801
  * - The resource type is fixed to DINGTALK, the scope is fixed to GROUP, and the owning user is parsed from the gateway authentication identity.
681
802
  * - groupId, chatId, and historyStartTime are required.
682
- * - updateFrequency can be configured by using a preset or a five-field cron expression for subsequent synchronization frequency.
683
- * - The server verifies the caller\\"s group membership and the target group directory permissions. The same chat can be created as different sources.
803
+ * - updateFrequency can be configured through preset or a five-segment cron expression for subsequent synchronization frequency.
804
+ * - The server verifies the caller\\"s group member identity and target group directory permissions. The same group chat can be created as different Sources.
684
805
  *
685
806
  * @param request - CreateGroupDingtalkChatRequest
686
807
  * @returns CreateGroupDingtalkChatResponse
@@ -1802,9 +1923,9 @@ class Client extends openapi_core_1.default {
1802
1923
  * @remarks
1803
1924
  * ## Request description
1804
1925
  * - This API is used to create a personal folder (category) under "My Resources".
1805
- * - If `parentDirectoryId` is not specified, the system automatically uses or creates the default root folder of the current digital human as the parent folder.
1806
- * - If `parentDirectoryId` is specified, it must be an existing personal folder of the current user under the current digital human.
1807
- * - `tenant_id` and `user_id` are derived from the authentication identity only. These fields are ignored if included in the request body.
1926
+ * - If `parentDirectoryId` is not specified, the system automatically uses or creates the default root folder of the current digital employee as the parent folder.
1927
+ * - If `parentDirectoryId` is specified, it must be an existing personal folder of the current user under the current digital employee.
1928
+ * - `tenant_id` and `user_id` are derived from the authenticated identity only. These fields are ignored if passed in the request body.
1808
1929
  *
1809
1930
  * @param request - CreatePersonalDirectoryRequest
1810
1931
  * @param headers - map
@@ -1854,9 +1975,9 @@ class Client extends openapi_core_1.default {
1854
1975
  * @remarks
1855
1976
  * ## Request description
1856
1977
  * - This API is used to create a personal folder (category) under "My Resources".
1857
- * - If `parentDirectoryId` is not specified, the system automatically uses or creates the default root folder of the current digital human as the parent folder.
1858
- * - If `parentDirectoryId` is specified, it must be an existing personal folder of the current user under the current digital human.
1859
- * - `tenant_id` and `user_id` are derived from the authentication identity only. These fields are ignored if included in the request body.
1978
+ * - If `parentDirectoryId` is not specified, the system automatically uses or creates the default root folder of the current digital employee as the parent folder.
1979
+ * - If `parentDirectoryId` is specified, it must be an existing personal folder of the current user under the current digital employee.
1980
+ * - `tenant_id` and `user_id` are derived from the authenticated identity only. These fields are ignored if passed in the request body.
1860
1981
  *
1861
1982
  * @param request - CreatePersonalDirectoryRequest
1862
1983
  * @returns CreatePersonalDirectoryResponse
@@ -2508,11 +2629,11 @@ class Client extends openapi_core_1.default {
2508
2629
  *
2509
2630
  * @remarks
2510
2631
  * ## Request description
2511
- * - This API is used to create a new enterprise knowledge base directory under a specified tenant.
2512
- * - You can specify the parent directory of the new directory by setting the `parentId` parameter. If this parameter is not specified, the directory is created as a root directory by default.
2513
- * - The `path` parameter is optional. If this parameter is not specified, the system automatically calculates the path based on the parent directory.
2632
+ * - This API is used to create a new enterprise knowledge base folder under a specified tenant.
2633
+ * - You can set the `parentId` parameter to specify the parent folder of the new folder. If this parameter is not specified, the folder is created as a root folder by default.
2634
+ * - The `path` parameter is optional. If this parameter is not specified, the system automatically calculates the path based on the parent folder.
2514
2635
  * - Calling this operation requires the corresponding permissions. Multiple authentication methods are supported, including AK, BearerToken, and APP authentication.
2515
- * - After the directory is created, the related information of the new directory is returned, such as the directory ID and name.
2636
+ * - After the folder is created, the related information about the new folder is returned, such as the folder ID and name.
2516
2637
  *
2517
2638
  * @param request - CreateTenantDirectoryRequest
2518
2639
  * @param headers - map
@@ -2561,11 +2682,11 @@ class Client extends openapi_core_1.default {
2561
2682
  *
2562
2683
  * @remarks
2563
2684
  * ## Request description
2564
- * - This API is used to create a new enterprise knowledge base directory under a specified tenant.
2565
- * - You can specify the parent directory of the new directory by setting the `parentId` parameter. If this parameter is not specified, the directory is created as a root directory by default.
2566
- * - The `path` parameter is optional. If this parameter is not specified, the system automatically calculates the path based on the parent directory.
2685
+ * - This API is used to create a new enterprise knowledge base folder under a specified tenant.
2686
+ * - You can set the `parentId` parameter to specify the parent folder of the new folder. If this parameter is not specified, the folder is created as a root folder by default.
2687
+ * - The `path` parameter is optional. If this parameter is not specified, the system automatically calculates the path based on the parent folder.
2567
2688
  * - Calling this operation requires the corresponding permissions. Multiple authentication methods are supported, including AK, BearerToken, and APP authentication.
2568
- * - After the directory is created, the related information of the new directory is returned, such as the directory ID and name.
2689
+ * - After the folder is created, the related information about the new folder is returned, such as the folder ID and name.
2569
2690
  *
2570
2691
  * @param request - CreateTenantDirectoryRequest
2571
2692
  * @returns CreateTenantDirectoryResponse
@@ -2581,12 +2702,12 @@ class Client extends openapi_core_1.default {
2581
2702
  * @remarks
2582
2703
  * Creates a user by using OpenAPI.
2583
2704
  * Business orchestration:
2584
- * 1. Parses roleCodes → role_ids (validates against system role enumerations).
2705
+ * 1. Parses roleCodes into role_ids (validates against system role enumerations).
2585
2706
  * 2. Checks whether the user already exists (used to return the isNewUser flag).
2586
- * 3. Calls UserManagementService.add_tenant_member to create or add the user (the password must be passed in as an RSA ciphertext by the caller).
2707
+ * 3. Calls UserManagementService.add_tenant_member to create or add the user (the password must be passed by the caller as an RSA ciphertext).
2587
2708
  * 4. Returns the creation result (including the isNewUser flag).
2588
2709
  * Error codes:
2589
- * - ERR.User.DeactivatedInTenant: The user is deactivated in the tenant. Use updateUser to resume the user.
2710
+ * - ERR.User.DeactivatedInTenant: The user is deactivated in the tenant. Use updateUser to restore the user.
2590
2711
  * - ERR.User.AlreadyInTenant: The user is already an active member of the tenant.
2591
2712
  * - ERR.User.DisplayNameDuplicateInTenant: The display name is duplicate within the tenant.
2592
2713
  *
@@ -2616,6 +2737,9 @@ class Client extends openapi_core_1.default {
2616
2737
  if (!$dara.isNull(request.roleCodesShrink)) {
2617
2738
  body["roleCodes"] = request.roleCodesShrink;
2618
2739
  }
2740
+ if (!$dara.isNull(request.ssoProvider)) {
2741
+ body["ssoProvider"] = request.ssoProvider;
2742
+ }
2619
2743
  if (!$dara.isNull(request.wnAccountId)) {
2620
2744
  body["wnAccountId"] = request.wnAccountId;
2621
2745
  }
@@ -2643,12 +2767,12 @@ class Client extends openapi_core_1.default {
2643
2767
  * @remarks
2644
2768
  * Creates a user by using OpenAPI.
2645
2769
  * Business orchestration:
2646
- * 1. Parses roleCodes → role_ids (validates against system role enumerations).
2770
+ * 1. Parses roleCodes into role_ids (validates against system role enumerations).
2647
2771
  * 2. Checks whether the user already exists (used to return the isNewUser flag).
2648
- * 3. Calls UserManagementService.add_tenant_member to create or add the user (the password must be passed in as an RSA ciphertext by the caller).
2772
+ * 3. Calls UserManagementService.add_tenant_member to create or add the user (the password must be passed by the caller as an RSA ciphertext).
2649
2773
  * 4. Returns the creation result (including the isNewUser flag).
2650
2774
  * Error codes:
2651
- * - ERR.User.DeactivatedInTenant: The user is deactivated in the tenant. Use updateUser to resume the user.
2775
+ * - ERR.User.DeactivatedInTenant: The user is deactivated in the tenant. Use updateUser to restore the user.
2652
2776
  * - ERR.User.AlreadyInTenant: The user is already an active member of the tenant.
2653
2777
  * - ERR.User.DisplayNameDuplicateInTenant: The display name is duplicate within the tenant.
2654
2778
  *
@@ -2723,16 +2847,15 @@ class Client extends openapi_core_1.default {
2723
2847
  * Creates a WINNEXO user in the current tenant and assigns roles and user groups to the user.
2724
2848
  *
2725
2849
  * @remarks
2726
- * Creates a user and sets initial roles and user groups via OpenAPI.
2727
- * Business orchestration:
2728
- * 1. Parses roleCodes → role_ids (system role enumeration validation)
2729
- * 2. Checks whether the user already exists (used to return the isNewUser flag)
2730
- * 3. Validates the tenant ownership of userGroupIds and completes creation/joining (the password must be passed in by the caller as RSA ciphertext)
2731
- * 4. Returns the creation result (including the isNewUser flag)
2732
- * Error codes:
2733
- * - ERR.User.DeactivatedInTenant: The user is deactivated in the tenant. Use updateUser to resume.
2734
- * - ERR.User.AlreadyInTenant: The user is already an active member of the tenant.
2735
- * - ERR.User.DisplayNameDuplicateInTenant: The display name is duplicate within the tenant.
2850
+ * ## Request description
2851
+ * - This operation creates a WINNEXO user under a specified tenant and optionally assigns system roles and user groups to the user.
2852
+ * - The `accountId` parameter serves as the logon account for the user and must be unique.
2853
+ * - The `displayName` parameter specifies the display name of the user, which must also be unique within the tenant and cannot exceed 100 characters in length.
2854
+ * - The optional `roleCodes` parameter specifies a list of roles for the user. By default, the `APPLICATION_USER` role is assigned.
2855
+ * - The `userGroupIds` parameter allows you to add up to 100 user group IDs to the new user. Make sure that all specified user groups belong to the same tenant.
2856
+ * - The password must be encrypted by using the RSA-OAEP-SHA256 algorithm and submitted in Base64 format.
2857
+ * - This operation supports calls over HTTPS and requires the request body in JSON format.
2858
+ * - For security authentication, AK, BearerToken, and APP are supported.
2736
2859
  *
2737
2860
  * @param tmpReq - CreateUserWithGroupsRequest
2738
2861
  * @param headers - map
@@ -2791,16 +2914,15 @@ class Client extends openapi_core_1.default {
2791
2914
  * Creates a WINNEXO user in the current tenant and assigns roles and user groups to the user.
2792
2915
  *
2793
2916
  * @remarks
2794
- * Creates a user and sets initial roles and user groups via OpenAPI.
2795
- * Business orchestration:
2796
- * 1. Parses roleCodes → role_ids (system role enumeration validation)
2797
- * 2. Checks whether the user already exists (used to return the isNewUser flag)
2798
- * 3. Validates the tenant ownership of userGroupIds and completes creation/joining (the password must be passed in by the caller as RSA ciphertext)
2799
- * 4. Returns the creation result (including the isNewUser flag)
2800
- * Error codes:
2801
- * - ERR.User.DeactivatedInTenant: The user is deactivated in the tenant. Use updateUser to resume.
2802
- * - ERR.User.AlreadyInTenant: The user is already an active member of the tenant.
2803
- * - ERR.User.DisplayNameDuplicateInTenant: The display name is duplicate within the tenant.
2917
+ * ## Request description
2918
+ * - This operation creates a WINNEXO user under a specified tenant and optionally assigns system roles and user groups to the user.
2919
+ * - The `accountId` parameter serves as the logon account for the user and must be unique.
2920
+ * - The `displayName` parameter specifies the display name of the user, which must also be unique within the tenant and cannot exceed 100 characters in length.
2921
+ * - The optional `roleCodes` parameter specifies a list of roles for the user. By default, the `APPLICATION_USER` role is assigned.
2922
+ * - The `userGroupIds` parameter allows you to add up to 100 user group IDs to the new user. Make sure that all specified user groups belong to the same tenant.
2923
+ * - The password must be encrypted by using the RSA-OAEP-SHA256 algorithm and submitted in Base64 format.
2924
+ * - This operation supports calls over HTTPS and requires the request body in JSON format.
2925
+ * - For security authentication, AK, BearerToken, and APP are supported.
2804
2926
  *
2805
2927
  * @param request - CreateUserWithGroupsRequest
2806
2928
  * @returns CreateUserWithGroupsResponse
@@ -2818,8 +2940,8 @@ class Client extends openapi_core_1.default {
2818
2940
  * - This API is used to upload a file to the "My Resources" section of a specified digital employee.
2819
2941
  * - `source_type` is fixed to `FILE`, `scope` is fixed to `PERSONAL`, and `platform` is fixed to `LOCAL`.
2820
2942
  * - The file must include an OSS persistent address (`filePath`). Other information such as the public access URL and original file name is optional.
2821
- * - If the target directory ID (`directoryId`) is not specified, the file is automatically attached to the default root directory of the current digital employee. If specified, ensure that the directory belongs to the personal directory of the caller.
2822
- * - Security authentication is supported through multiple methods (AK, BearerToken, APP).
2943
+ * - If the target directory ID (`directoryId`) is not specified, the file is automatically bound to the default root directory of the current digital employee. If specified, ensure that the directory belongs to the caller\\"s personal directory.
2944
+ * - Multiple authentication methods (AK, BearerToken, APP) are supported for security authentication.
2823
2945
  * - The operation type is write (`write`), and operation logs are recorded for subsequent auditing.
2824
2946
  *
2825
2947
  * @param request - DeleteChatSessionRequest
@@ -2861,8 +2983,8 @@ class Client extends openapi_core_1.default {
2861
2983
  * - This API is used to upload a file to the "My Resources" section of a specified digital employee.
2862
2984
  * - `source_type` is fixed to `FILE`, `scope` is fixed to `PERSONAL`, and `platform` is fixed to `LOCAL`.
2863
2985
  * - The file must include an OSS persistent address (`filePath`). Other information such as the public access URL and original file name is optional.
2864
- * - If the target directory ID (`directoryId`) is not specified, the file is automatically attached to the default root directory of the current digital employee. If specified, ensure that the directory belongs to the personal directory of the caller.
2865
- * - Security authentication is supported through multiple methods (AK, BearerToken, APP).
2986
+ * - If the target directory ID (`directoryId`) is not specified, the file is automatically bound to the default root directory of the current digital employee. If specified, ensure that the directory belongs to the caller\\"s personal directory.
2987
+ * - Multiple authentication methods (AK, BearerToken, APP) are supported for security authentication.
2866
2988
  * - The operation type is write (`write`), and operation logs are recorded for subsequent auditing.
2867
2989
  *
2868
2990
  * @param request - DeleteChatSessionRequest
@@ -3139,7 +3261,7 @@ class Client extends openapi_core_1.default {
3139
3261
  * - `source_type` is fixed to `FILE`, `scope` is fixed to `PERSONAL`, and `platform` is fixed to `LOCAL`.
3140
3262
  * - The file must include an OSS persistent address (`filePath`). Other information such as the public access URL and original file name is optional.
3141
3263
  * - If no target folder ID (`directoryId`) is specified, the file is automatically attached to the default root folder of the current digital employee. If specified, ensure that the folder belongs to the invoker\\"s personal folder.
3142
- * - Security verification is supported through multiple authenticate methods (AK, BearerToken, APP).
3264
+ * - Multiple authentication methods (AK, BearerToken, APP) are supported to authenticate requests.
3143
3265
  * - The operation type is write (`write`), and operation logs are recorded for subsequent auditing.
3144
3266
  *
3145
3267
  * @param request - GetChatSessionRequest
@@ -3185,7 +3307,7 @@ class Client extends openapi_core_1.default {
3185
3307
  * - `source_type` is fixed to `FILE`, `scope` is fixed to `PERSONAL`, and `platform` is fixed to `LOCAL`.
3186
3308
  * - The file must include an OSS persistent address (`filePath`). Other information such as the public access URL and original file name is optional.
3187
3309
  * - If no target folder ID (`directoryId`) is specified, the file is automatically attached to the default root folder of the current digital employee. If specified, ensure that the folder belongs to the invoker\\"s personal folder.
3188
- * - Security verification is supported through multiple authenticate methods (AK, BearerToken, APP).
3310
+ * - Multiple authentication methods (AK, BearerToken, APP) are supported to authenticate requests.
3189
3311
  * - The operation type is write (`write`), and operation logs are recorded for subsequent auditing.
3190
3312
  *
3191
3313
  * @param request - GetChatSessionRequest
@@ -3579,12 +3701,12 @@ class Client extends openapi_core_1.default {
3579
3701
  * Retrieves the details of scheduled task understanding.
3580
3702
  *
3581
3703
  * @remarks
3582
- * ## Request description
3704
+ * ## Operation description
3583
3705
  * - This operation uploads a file to the enterprise knowledge base.
3584
- * - You must have the `DEVELOPMENT_KB_MANAGE` permission to call this API operation.
3585
- * - You must provide the OSS persistent address (`filePath`) of the file when uploading.
3586
- * - Optional parameters include the public access URL of the file and the original file name to enhance the completeness of file information.
3587
- * - If `directoryId` is specified, the file is placed in the corresponding enterprise knowledge base directory. Otherwise, the file is bound to the default root directory of the current digital employee by default.
3706
+ * - The `DEVELOPMENT_KB_MANAGE` feature permission is required to call this API.
3707
+ * - The OSS persistent address (`filePath`) of the file must be provided during upload.
3708
+ * - Optional parameters include the public access URL and original file name to enhance the completeness of file information.
3709
+ * - If `directoryId` is specified, the file is placed in the corresponding enterprise knowledge base directory. Otherwise, the file is bound to the default root directory of the current digital employee.
3588
3710
  * - You can add tags to the resource by using `sourceTags` for subsequent management and retrieval.
3589
3711
  * - This operation initiates a billing item (UNSTRUCTURED_PARSE). Ensure that your account balance is sufficient.
3590
3712
  *
@@ -3642,12 +3764,12 @@ class Client extends openapi_core_1.default {
3642
3764
  * Retrieves the details of scheduled task understanding.
3643
3765
  *
3644
3766
  * @remarks
3645
- * ## Request description
3767
+ * ## Operation description
3646
3768
  * - This operation uploads a file to the enterprise knowledge base.
3647
- * - You must have the `DEVELOPMENT_KB_MANAGE` permission to call this API operation.
3648
- * - You must provide the OSS persistent address (`filePath`) of the file when uploading.
3649
- * - Optional parameters include the public access URL of the file and the original file name to enhance the completeness of file information.
3650
- * - If `directoryId` is specified, the file is placed in the corresponding enterprise knowledge base directory. Otherwise, the file is bound to the default root directory of the current digital employee by default.
3769
+ * - The `DEVELOPMENT_KB_MANAGE` feature permission is required to call this API.
3770
+ * - The OSS persistent address (`filePath`) of the file must be provided during upload.
3771
+ * - Optional parameters include the public access URL and original file name to enhance the completeness of file information.
3772
+ * - If `directoryId` is specified, the file is placed in the corresponding enterprise knowledge base directory. Otherwise, the file is bound to the default root directory of the current digital employee.
3651
3773
  * - You can add tags to the resource by using `sourceTags` for subsequent management and retrieval.
3652
3774
  * - This operation initiates a billing item (UNSTRUCTURED_PARSE). Ensure that your account balance is sufficient.
3653
3775
  *
@@ -4418,8 +4540,8 @@ class Client extends openapi_core_1.default {
4418
4540
  * Queries currently effective service notices.
4419
4541
  *
4420
4542
  * @remarks
4421
- * ## Request description
4422
- * Performs a paging query for published platform notices that are effective within the current database time window. The invoking identity must be a real user who has the notice viewing permission in the system O&M tenant.
4543
+ * ## Operation description
4544
+ * Performs a paging query for published platform announcements that are effective within the current database time window. The caller must be a real user in the system O&M tenant who has the permission to view announcements.
4423
4545
  *
4424
4546
  * @param request - ListActiveAnnouncementsRequest
4425
4547
  * @param headers - map
@@ -4461,8 +4583,8 @@ class Client extends openapi_core_1.default {
4461
4583
  * Queries currently effective service notices.
4462
4584
  *
4463
4585
  * @remarks
4464
- * ## Request description
4465
- * Performs a paging query for published platform notices that are effective within the current database time window. The invoking identity must be a real user who has the notice viewing permission in the system O&M tenant.
4586
+ * ## Operation description
4587
+ * Performs a paging query for published platform announcements that are effective within the current database time window. The caller must be a real user in the system O&M tenant who has the permission to view announcements.
4466
4588
  *
4467
4589
  * @param request - ListActiveAnnouncementsRequest
4468
4590
  * @returns ListActiveAnnouncementsResponse
@@ -4824,12 +4946,12 @@ class Client extends openapi_core_1.default {
4824
4946
  * Queries and filters the bill list through OpenAPI with support for multiple filter conditions.
4825
4947
  *
4826
4948
  * @remarks
4827
- * ## Operation description
4949
+ * ## Request description
4828
4950
  * - This operation queries the bill list based on specified conditions.
4829
4951
  * - Supports filtering by tenant, user, operation type, status, time range, business source, and other conditions.
4830
4952
  * - Returns bill data in pages. The default page size is 20 records.
4831
4953
  * - You can choose whether to filter out bills with zero credit consumption. By default, such bills are filtered out.
4832
- * - Authentication information (such as AK, BearerToken, or APP authentication) is required in the request.
4954
+ * - Authentication information (such as AK, BearerToken, or APP authentication) is required for the request.
4833
4955
  *
4834
4956
  * @param request - ListBillingRequest
4835
4957
  * @param headers - map
@@ -4895,12 +5017,12 @@ class Client extends openapi_core_1.default {
4895
5017
  * Queries and filters the bill list through OpenAPI with support for multiple filter conditions.
4896
5018
  *
4897
5019
  * @remarks
4898
- * ## Operation description
5020
+ * ## Request description
4899
5021
  * - This operation queries the bill list based on specified conditions.
4900
5022
  * - Supports filtering by tenant, user, operation type, status, time range, business source, and other conditions.
4901
5023
  * - Returns bill data in pages. The default page size is 20 records.
4902
5024
  * - You can choose whether to filter out bills with zero credit consumption. By default, such bills are filtered out.
4903
- * - Authentication information (such as AK, BearerToken, or APP authentication) is required in the request.
5025
+ * - Authentication information (such as AK, BearerToken, or APP authentication) is required for the request.
4904
5026
  *
4905
5027
  * @param request - ListBillingRequest
4906
5028
  * @returns ListBillingResponse
@@ -5098,17 +5220,82 @@ class Client extends openapi_core_1.default {
5098
5220
  return await this.listKnowledgeBaseDirectoriesWithOptions(request, headers, runtime);
5099
5221
  }
5100
5222
  /**
5101
- * Queries the output list of the current user with support for conditional filtering and pagination.
5223
+ * Queries the precise object type follows of a digital employee by page.
5224
+ *
5225
+ * @remarks
5226
+ * Queries follows by three independent dimensions: graphName, operatingObjectName, and objectType. Supports primary objects and explicit first-level associated objects. Uses opaque cursor pagination and is not limited by the 1000-item display window of the follow panel.
5227
+ *
5228
+ * @param request - ListOperatingObjectFavoritesRequest
5229
+ * @param headers - map
5230
+ * @param runtime - runtime options for this request RuntimeOptions
5231
+ * @returns ListOperatingObjectFavoritesResponse
5232
+ */
5233
+ async listOperatingObjectFavoritesWithOptions(request, headers, runtime) {
5234
+ request.validate();
5235
+ let query = {};
5236
+ if (!$dara.isNull(request.tenantId)) {
5237
+ query["tenantId"] = request.tenantId;
5238
+ }
5239
+ let body = {};
5240
+ if (!$dara.isNull(request.graphName)) {
5241
+ body["graphName"] = request.graphName;
5242
+ }
5243
+ if (!$dara.isNull(request.nextToken)) {
5244
+ body["nextToken"] = request.nextToken;
5245
+ }
5246
+ if (!$dara.isNull(request.objectType)) {
5247
+ body["objectType"] = request.objectType;
5248
+ }
5249
+ if (!$dara.isNull(request.operatingObjectName)) {
5250
+ body["operatingObjectName"] = request.operatingObjectName;
5251
+ }
5252
+ if (!$dara.isNull(request.pageSize)) {
5253
+ body["pageSize"] = request.pageSize;
5254
+ }
5255
+ let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
5256
+ headers: headers,
5257
+ query: openapi_core_2.OpenApiUtil.query(query),
5258
+ body: openapi_core_2.OpenApiUtil.parseToMap(body),
5259
+ });
5260
+ let params = new openapi_core_2.$OpenApiUtil.Params({
5261
+ action: "ListOperatingObjectFavorites",
5262
+ version: "2026-05-12",
5263
+ protocol: "HTTPS",
5264
+ pathname: `/openapi/listOperatingObjectFavorites`,
5265
+ method: "POST",
5266
+ authType: "AK",
5267
+ style: "ROA",
5268
+ reqBodyType: "formData",
5269
+ bodyType: "json",
5270
+ });
5271
+ return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListOperatingObjectFavoritesResponse({}));
5272
+ }
5273
+ /**
5274
+ * Queries the precise object type follows of a digital employee by page.
5275
+ *
5276
+ * @remarks
5277
+ * Queries follows by three independent dimensions: graphName, operatingObjectName, and objectType. Supports primary objects and explicit first-level associated objects. Uses opaque cursor pagination and is not limited by the 1000-item display window of the follow panel.
5278
+ *
5279
+ * @param request - ListOperatingObjectFavoritesRequest
5280
+ * @returns ListOperatingObjectFavoritesResponse
5281
+ */
5282
+ async listOperatingObjectFavorites(request) {
5283
+ let runtime = new $dara.RuntimeOptions({});
5284
+ let headers = {};
5285
+ return await this.listOperatingObjectFavoritesWithOptions(request, headers, runtime);
5286
+ }
5287
+ /**
5288
+ * Queries the output list of the current user, with support for conditional filtering and pagination.
5102
5289
  *
5103
5290
  * @remarks
5104
5291
  * ## Operation description
5105
- * - This API operation queries the output list of the current logon user.
5106
- * - `tenantId` is a common parameter. If this parameter is not specified, the default tenant of the caller is used.
5107
- * - You can filter results by using parameters such as `operatingObjectName`, `itemType`, and `keyword`.
5108
- * - Set `sharedOnly` to `true` to display only shared outputs.
5109
- * - Pagination is controlled by `page` (page number) and `pageSize` (number of entries per page). By default, the first page is returned with 20 records per page.
5292
+ * - This API operation queries the output list of the current logged-in user.
5293
+ * - `tenantId` is a common parameter. If not specified, the default tenant of the caller is used.
5294
+ * - Supports filtering by parameters such as `operatingObjectName`, `itemType`, and `keyword`.
5295
+ * - Set `sharedOnly` to `true` to display only outputs with sharing enabled.
5296
+ * - Pagination is controlled by `page` (page number) and `pageSize` (number of items per page). By default, results start from page 1 with 20 records per page.
5110
5297
  * - Results are sorted by update time in descending order by default.
5111
- * - The `tenant_id` or `user_id` values passed in the request body are ignored. This information is obtained only from the authenticated identity.
5298
+ * - The `tenant_id` or `user_id` passed in the request body by the caller is ignored. This information is derived only from the authenticated identity.
5112
5299
  *
5113
5300
  * @param request - ListOutputFilesRequest
5114
5301
  * @param headers - map
@@ -5159,17 +5346,17 @@ class Client extends openapi_core_1.default {
5159
5346
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListOutputFilesResponse({}));
5160
5347
  }
5161
5348
  /**
5162
- * Queries the output list of the current user with support for conditional filtering and pagination.
5349
+ * Queries the output list of the current user, with support for conditional filtering and pagination.
5163
5350
  *
5164
5351
  * @remarks
5165
5352
  * ## Operation description
5166
- * - This API operation queries the output list of the current logon user.
5167
- * - `tenantId` is a common parameter. If this parameter is not specified, the default tenant of the caller is used.
5168
- * - You can filter results by using parameters such as `operatingObjectName`, `itemType`, and `keyword`.
5169
- * - Set `sharedOnly` to `true` to display only shared outputs.
5170
- * - Pagination is controlled by `page` (page number) and `pageSize` (number of entries per page). By default, the first page is returned with 20 records per page.
5353
+ * - This API operation queries the output list of the current logged-in user.
5354
+ * - `tenantId` is a common parameter. If not specified, the default tenant of the caller is used.
5355
+ * - Supports filtering by parameters such as `operatingObjectName`, `itemType`, and `keyword`.
5356
+ * - Set `sharedOnly` to `true` to display only outputs with sharing enabled.
5357
+ * - Pagination is controlled by `page` (page number) and `pageSize` (number of items per page). By default, results start from page 1 with 20 records per page.
5171
5358
  * - Results are sorted by update time in descending order by default.
5172
- * - The `tenant_id` or `user_id` values passed in the request body are ignored. This information is obtained only from the authenticated identity.
5359
+ * - The `tenant_id` or `user_id` passed in the request body by the caller is ignored. This information is derived only from the authenticated identity.
5173
5360
  *
5174
5361
  * @param request - ListOutputFilesRequest
5175
5362
  * @returns ListOutputFilesResponse
@@ -5333,7 +5520,7 @@ class Client extends openapi_core_1.default {
5333
5520
  * @remarks
5334
5521
  * ## Operation description
5335
5522
  * - This operation uploads a file to an enterprise knowledge base.
5336
- * - The `DEVELOPMENT_KB_MANAGE` permission is required to call this API.
5523
+ * - The DEVELOPMENT_KB_MANAGE permission is required to call this operation.
5337
5524
  * - You must provide the OSS persistent address (`filePath`) of the file when uploading.
5338
5525
  * - Optional parameters include the public access URL and original file name to enhance the completeness of file information.
5339
5526
  * - If `directoryId` is specified, the file is placed in the corresponding enterprise knowledge base directory. Otherwise, the file is bound to the default root directory of the current digital employee.
@@ -5403,7 +5590,7 @@ class Client extends openapi_core_1.default {
5403
5590
  * @remarks
5404
5591
  * ## Operation description
5405
5592
  * - This operation uploads a file to an enterprise knowledge base.
5406
- * - The `DEVELOPMENT_KB_MANAGE` permission is required to call this API.
5593
+ * - The DEVELOPMENT_KB_MANAGE permission is required to call this operation.
5407
5594
  * - You must provide the OSS persistent address (`filePath`) of the file when uploading.
5408
5595
  * - Optional parameters include the public access URL and original file name to enhance the completeness of file information.
5409
5596
  * - If `directoryId` is specified, the file is placed in the corresponding enterprise knowledge base directory. Otherwise, the file is bound to the default root directory of the current digital employee.
@@ -5423,15 +5610,15 @@ class Client extends openapi_core_1.default {
5423
5610
  *
5424
5611
  * @remarks
5425
5612
  * ## Request description
5426
- * This API retrieves all visible skills under the current tenant. It supports filtering by digital employee binding relationship, skill source, tags, keywords, and other conditions, and supports pagination.
5613
+ * This API retrieves all visible skills under the current tenant. It supports filtering by digital employee binding relationship, skill source, tags, and keywords, and supports pagination.
5427
5614
  * ### Request parameters
5428
5615
  * - **TenantId**: Optional. A common parameter passed through by the gateway to the backend header. If not specified, the default tenant of the current caller is used.
5429
5616
  * - **FilterType**: Optional. The skill filtering dimension. Valid values: `ALL` (all published), `BUILTIN` (built-in published), `CUSTOM` (custom published), `DRAFT` (drafts, including published skills with unpublished modifications). Default value: `ALL`.
5430
- * - **Tags**: Optional. Filters by tags. A match occurs if any tag in the array is hit.
5431
- * - **Keyword**: Optional. Performs fuzzy matching by skill name or description.
5617
+ * - **Tags**: Optional. Filters by tags. A match is returned if any tag in the array is hit.
5618
+ * - **Keyword**: Optional. Performs a fuzzy match on the skill name or description.
5432
5619
  * - **Page**: Optional. The page number. Minimum value: 1. Default value: 1.
5433
- * - **PageSize**: Optional. The number of entries per page. Value range: 1 to 100. Default value: 20.
5434
- * - **OperatingObjectName**: Optional. The digital employee name. If specified, filters by binding relationship. Must be used together with `BindStatus`.
5620
+ * - **PageSize**: Optional. The number of entries per page. Valid values: 1 to 100. Default value: 20.
5621
+ * - **OperatingObjectName**: Optional. The digital employee name. If specified, results are filtered by binding relationship. Must be used together with `BindStatus`.
5435
5622
  * - **BindStatus**: Optional. The binding status. Valid values: `BOUND` (bound), `UNBOUND` (unbound global skills).
5436
5623
  * ### Response parameters
5437
5624
  * The response contains the skill list `items`, total count `total`, current page `page`, and page size `pageSize`.
@@ -5497,15 +5684,15 @@ class Client extends openapi_core_1.default {
5497
5684
  *
5498
5685
  * @remarks
5499
5686
  * ## Request description
5500
- * This API retrieves all visible skills under the current tenant. It supports filtering by digital employee binding relationship, skill source, tags, keywords, and other conditions, and supports pagination.
5687
+ * This API retrieves all visible skills under the current tenant. It supports filtering by digital employee binding relationship, skill source, tags, and keywords, and supports pagination.
5501
5688
  * ### Request parameters
5502
5689
  * - **TenantId**: Optional. A common parameter passed through by the gateway to the backend header. If not specified, the default tenant of the current caller is used.
5503
5690
  * - **FilterType**: Optional. The skill filtering dimension. Valid values: `ALL` (all published), `BUILTIN` (built-in published), `CUSTOM` (custom published), `DRAFT` (drafts, including published skills with unpublished modifications). Default value: `ALL`.
5504
- * - **Tags**: Optional. Filters by tags. A match occurs if any tag in the array is hit.
5505
- * - **Keyword**: Optional. Performs fuzzy matching by skill name or description.
5691
+ * - **Tags**: Optional. Filters by tags. A match is returned if any tag in the array is hit.
5692
+ * - **Keyword**: Optional. Performs a fuzzy match on the skill name or description.
5506
5693
  * - **Page**: Optional. The page number. Minimum value: 1. Default value: 1.
5507
- * - **PageSize**: Optional. The number of entries per page. Value range: 1 to 100. Default value: 20.
5508
- * - **OperatingObjectName**: Optional. The digital employee name. If specified, filters by binding relationship. Must be used together with `BindStatus`.
5694
+ * - **PageSize**: Optional. The number of entries per page. Valid values: 1 to 100. Default value: 20.
5695
+ * - **OperatingObjectName**: Optional. The digital employee name. If specified, results are filtered by binding relationship. Must be used together with `BindStatus`.
5509
5696
  * - **BindStatus**: Optional. The binding status. Valid values: `BOUND` (bound), `UNBOUND` (unbound global skills).
5510
5697
  * ### Response parameters
5511
5698
  * The response contains the skill list `items`, total count `total`, current page `page`, and page size `pageSize`.
@@ -6184,11 +6371,11 @@ class Client extends openapi_core_1.default {
6184
6371
  return await this.moveResourceWithOptions(request, headers, runtime);
6185
6372
  }
6186
6373
  /**
6187
- * Offlines a service notice.
6374
+ * Takes a service notice offline.
6188
6375
  *
6189
6376
  * @remarks
6190
- * ## Request description
6191
- * Idempotently offlines a platform announcement by announcement ID. Returns `changed=true` when a PUBLISHED announcement is offlined for the first time. Returns `changed=false` when the announcement is already offline or expired.
6377
+ * ## Operation description
6378
+ * Idempotently takes a platform announcement offline by announcement ID. Returns `changed=true` when a PUBLISHED announcement is taken offline for the first time. Returns `changed=false` when the announcement is already offline or expired.
6192
6379
  * The caller must belong to the system operations tenant and have announcement management permissions.
6193
6380
  *
6194
6381
  * @param request - OfflineAnnouncementRequest
@@ -6225,11 +6412,11 @@ class Client extends openapi_core_1.default {
6225
6412
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.OfflineAnnouncementResponse({}));
6226
6413
  }
6227
6414
  /**
6228
- * Offlines a service notice.
6415
+ * Takes a service notice offline.
6229
6416
  *
6230
6417
  * @remarks
6231
- * ## Request description
6232
- * Idempotently offlines a platform announcement by announcement ID. Returns `changed=true` when a PUBLISHED announcement is offlined for the first time. Returns `changed=false` when the announcement is already offline or expired.
6418
+ * ## Operation description
6419
+ * Idempotently takes a platform announcement offline by announcement ID. Returns `changed=true` when a PUBLISHED announcement is taken offline for the first time. Returns `changed=false` when the announcement is already offline or expired.
6233
6420
  * The caller must belong to the system operations tenant and have announcement management permissions.
6234
6421
  *
6235
6422
  * @param request - OfflineAnnouncementRequest
@@ -6372,15 +6559,15 @@ class Client extends openapi_core_1.default {
6372
6559
  return await this.previewPersonalSourceWithOptions(request, headers, runtime);
6373
6560
  }
6374
6561
  /**
6375
- * Queries primary object data by operating object name with paging support, including filtering and search.
6562
+ * Queries primary object data by operating object name with pagination, and supports filtering and searching.
6376
6563
  *
6377
6564
  * @remarks
6378
- * ## Operation description
6379
- * - This API queries primary object data by a specified operating object name (such as `customer_1`) with paging.
6380
- * - Keyword-based search is supported. You can set whether to return only objects marked as favorites in Settings.
6381
- * - Complex filter conditions can be used to further narrow results, including but not limited to equal to, not equal to, greater than, and less than operators.
6565
+ * ## Request description
6566
+ * - This API queries primary object data with pagination based on a specified operating object name (such as `customer_1`).
6567
+ * - Supports keyword-based searching and allows you to specify whether to return only objects marked as favorites.
6568
+ * - Complex filter conditions can be used to further refine results, including but not limited to logical operators such as equal to, not equal to, greater than, and less than.
6382
6569
  * - If no primary object type is configured, an empty result set is returned.
6383
- * - Data in the request undergoes authentication and filtering to ensure security and accuracy.
6570
+ * - Data included in the request undergoes authentication and filtering to ensure security and accuracy.
6384
6571
  *
6385
6572
  * @param request - QueryPrimaryObjectDataRequest
6386
6573
  * @param headers - map
@@ -6428,15 +6615,15 @@ class Client extends openapi_core_1.default {
6428
6615
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.QueryPrimaryObjectDataResponse({}));
6429
6616
  }
6430
6617
  /**
6431
- * Queries primary object data by operating object name with paging support, including filtering and search.
6618
+ * Queries primary object data by operating object name with pagination, and supports filtering and searching.
6432
6619
  *
6433
6620
  * @remarks
6434
- * ## Operation description
6435
- * - This API queries primary object data by a specified operating object name (such as `customer_1`) with paging.
6436
- * - Keyword-based search is supported. You can set whether to return only objects marked as favorites in Settings.
6437
- * - Complex filter conditions can be used to further narrow results, including but not limited to equal to, not equal to, greater than, and less than operators.
6621
+ * ## Request description
6622
+ * - This API queries primary object data with pagination based on a specified operating object name (such as `customer_1`).
6623
+ * - Supports keyword-based searching and allows you to specify whether to return only objects marked as favorites.
6624
+ * - Complex filter conditions can be used to further refine results, including but not limited to logical operators such as equal to, not equal to, greater than, and less than.
6438
6625
  * - If no primary object type is configured, an empty result set is returned.
6439
- * - Data in the request undergoes authentication and filtering to ensure security and accuracy.
6626
+ * - Data included in the request undergoes authentication and filtering to ensure security and accuracy.
6440
6627
  *
6441
6628
  * @param request - QueryPrimaryObjectDataRequest
6442
6629
  * @returns QueryPrimaryObjectDataResponse
@@ -7358,7 +7545,7 @@ class Client extends openapi_core_1.default {
7358
7545
  * - Ensure that `tenantId` and `userId` come from verified identity information.
7359
7546
  * ### Precautions
7360
7547
  * - `directoryId` is a required parameter that specifies the target folder in which to check and retry failed data sources.
7361
- * - If `tenantId` is not provided, the tenant ID of the caller is used by default.
7548
+ * - If `tenantId` is not provided, the caller\\"s tenant ID is used by default.
7362
7549
  * - The API supports multiple authentication methods, including AccessKey, BearerToken, and APP authentication.
7363
7550
  *
7364
7551
  * @param request - RetryDirectoryFailedSourcesRequest
@@ -7406,7 +7593,7 @@ class Client extends openapi_core_1.default {
7406
7593
  * - Ensure that `tenantId` and `userId` come from verified identity information.
7407
7594
  * ### Precautions
7408
7595
  * - `directoryId` is a required parameter that specifies the target folder in which to check and retry failed data sources.
7409
- * - If `tenantId` is not provided, the tenant ID of the caller is used by default.
7596
+ * - If `tenantId` is not provided, the caller\\"s tenant ID is used by default.
7410
7597
  * - The API supports multiple authentication methods, including AccessKey, BearerToken, and APP authentication.
7411
7598
  *
7412
7599
  * @param request - RetryDirectoryFailedSourcesRequest
@@ -7418,15 +7605,15 @@ class Client extends openapi_core_1.default {
7418
7605
  return await this.retryDirectoryFailedSourcesWithOptions(request, headers, runtime);
7419
7606
  }
7420
7607
  /**
7421
- * Retries all data sources in failed status under a specified directory in batch.
7608
+ * Retries all data sources in failed status under a specified directory in batches.
7422
7609
  *
7423
7610
  * @remarks
7424
- * ## Request description
7611
+ * ## Operation description
7425
7612
  * This API retrieves and retries all data sources in FAILED status under a specified enterprise knowledge base directory (including its subdirectories). The request returns immediately, and the actual retry operations are executed asynchronously in the background.
7426
7613
  * - **Authentication**: In addition to basic authentication, the `DEVELOPMENT_KB_MANAGE` permission is required.
7427
7614
  * - **Security constraints**: Only callers with the corresponding tenant and user identity are allowed access, and KB management permission is required. Administrators can initiate retries for failed resources of any user.
7428
7615
  * - **Parameters**:
7429
- * - `directoryId` (required): The ID of the enterprise knowledge base directory for which to check and retry failed data sources.
7616
+ * - `directoryId` (required): The ID of the enterprise knowledge base directory to check and retry failed data sources.
7430
7617
  * - `tenantId` (optional): The tenant ID. The default tenant of the caller is used if this parameter is not specified.
7431
7618
  * - **Response**: On success, returns the number of data sources enqueued for retry and related details.
7432
7619
  *
@@ -7464,15 +7651,15 @@ class Client extends openapi_core_1.default {
7464
7651
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.RetryKnowledgeBaseFailedSourcesResponse({}));
7465
7652
  }
7466
7653
  /**
7467
- * Retries all data sources in failed status under a specified directory in batch.
7654
+ * Retries all data sources in failed status under a specified directory in batches.
7468
7655
  *
7469
7656
  * @remarks
7470
- * ## Request description
7657
+ * ## Operation description
7471
7658
  * This API retrieves and retries all data sources in FAILED status under a specified enterprise knowledge base directory (including its subdirectories). The request returns immediately, and the actual retry operations are executed asynchronously in the background.
7472
7659
  * - **Authentication**: In addition to basic authentication, the `DEVELOPMENT_KB_MANAGE` permission is required.
7473
7660
  * - **Security constraints**: Only callers with the corresponding tenant and user identity are allowed access, and KB management permission is required. Administrators can initiate retries for failed resources of any user.
7474
7661
  * - **Parameters**:
7475
- * - `directoryId` (required): The ID of the enterprise knowledge base directory for which to check and retry failed data sources.
7662
+ * - `directoryId` (required): The ID of the enterprise knowledge base directory to check and retry failed data sources.
7476
7663
  * - `tenantId` (optional): The tenant ID. The default tenant of the caller is used if this parameter is not specified.
7477
7664
  * - **Response**: On success, returns the number of data sources enqueued for retry and related details.
7478
7665
  *
@@ -7979,11 +8166,11 @@ class Client extends openapi_core_1.default {
7979
8166
  * Sends a message.
7980
8167
  *
7981
8168
  * @remarks
7982
- * ## Operation description
8169
+ * ## Request description
7983
8170
  * - This API is used to upload a file to the "My Resources" section of a specified digital employee.
7984
8171
  * - `source_type` is fixed to `FILE`, `scope` is fixed to `PERSONAL`, and `platform` is fixed to `LOCAL`.
7985
- * - A persistent OSS address (`filePath`) must be provided for the file. Other information such as the public access URL and original file name is optional.
7986
- * - If the target folder ID (`directoryId`) is not specified, the file is automatically attached to the default root folder of the current digital employee. If specified, ensure that the folder belongs to the invoker\\"s personal folder.
8172
+ * - The file must include an OSS persistent address (`filePath`). Other information such as the public access URL and original file name is optional.
8173
+ * - If no target folder ID (`directoryId`) is specified, the file is automatically attached to the default root folder of the current digital employee. If specified, ensure that the folder belongs to the invoker\\"s personal folder.
7987
8174
  * - Multiple authentication methods (AK, BearerToken, APP) are supported to authenticate requests.
7988
8175
  * - The operation type is write, and operation logs are recorded for subsequent auditing.
7989
8176
  *
@@ -8089,11 +8276,11 @@ class Client extends openapi_core_1.default {
8089
8276
  * Sends a message.
8090
8277
  *
8091
8278
  * @remarks
8092
- * ## Operation description
8279
+ * ## Request description
8093
8280
  * - This API is used to upload a file to the "My Resources" section of a specified digital employee.
8094
8281
  * - `source_type` is fixed to `FILE`, `scope` is fixed to `PERSONAL`, and `platform` is fixed to `LOCAL`.
8095
- * - A persistent OSS address (`filePath`) must be provided for the file. Other information such as the public access URL and original file name is optional.
8096
- * - If the target folder ID (`directoryId`) is not specified, the file is automatically attached to the default root folder of the current digital employee. If specified, ensure that the folder belongs to the invoker\\"s personal folder.
8282
+ * - The file must include an OSS persistent address (`filePath`). Other information such as the public access URL and original file name is optional.
8283
+ * - If no target folder ID (`directoryId`) is specified, the file is automatically attached to the default root folder of the current digital employee. If specified, ensure that the folder belongs to the invoker\\"s personal folder.
8097
8284
  * - Multiple authentication methods (AK, BearerToken, APP) are supported to authenticate requests.
8098
8285
  * - The operation type is write, and operation logs are recorded for subsequent auditing.
8099
8286
  *
@@ -8172,11 +8359,11 @@ class Client extends openapi_core_1.default {
8172
8359
  * Sends a message.
8173
8360
  *
8174
8361
  * @remarks
8175
- * ## Operation description
8362
+ * ## Request description
8176
8363
  * - This API is used to upload a file to the "My Resources" section of a specified digital employee.
8177
8364
  * - `source_type` is fixed to `FILE`, `scope` is fixed to `PERSONAL`, and `platform` is fixed to `LOCAL`.
8178
- * - A persistent OSS address (`filePath`) must be provided for the file. Other information such as the public access URL and original file name is optional.
8179
- * - If the target folder ID (`directoryId`) is not specified, the file is automatically attached to the default root folder of the current digital employee. If specified, ensure that the folder belongs to the invoker\\"s personal folder.
8365
+ * - The file must include an OSS persistent address (`filePath`). Other information such as the public access URL and original file name is optional.
8366
+ * - If no target folder ID (`directoryId`) is specified, the file is automatically attached to the default root folder of the current digital employee. If specified, ensure that the folder belongs to the invoker\\"s personal folder.
8180
8367
  * - Multiple authentication methods (AK, BearerToken, APP) are supported to authenticate requests.
8181
8368
  * - The operation type is write, and operation logs are recorded for subsequent auditing.
8182
8369
  *
@@ -9418,21 +9605,21 @@ class Client extends openapi_core_1.default {
9418
9605
  return await this.updateUserInfoWithOptions(request, headers, runtime);
9419
9606
  }
9420
9607
  /**
9421
- * Uploads a local file in a session.
9608
+ * Uploads a local file for a session.
9422
9609
  *
9423
9610
  * @remarks
9424
9611
  * ## Operation description
9425
- * This API is used to upload a session temporary file by using the **file transfer upload** mode (`fileTransfer`). The file binary data is not transmitted through the request body of this API. Instead, the file is first uploaded to Object Storage Service (OSS), and then the OSS address is passed to the backend through the `FileUrl` parameter. The backend retrieves the bytes from that address, writes them to its own OSS, and creates a session temporary file record.
9426
- * ### Call methods
9427
- * - **Recommended**: Use the `UploadChatFileAdvance` method generated by the SDK. Pass in the local file stream, and the SDK automatically completes the transfer upload and populates `FileUrl`.
9428
- * - **Direct upload**: Upload the file to an OSS address accessible by the server, and then directly call this API with the `FileUrl` parameter.
9612
+ * This API operation uploads a temporary temporary file by using the **file transfer upload** mode (`fileTransfer`). The file binary data is not transmitted in the request body of this API operation. Instead, the file is first uploaded to Object Storage Service (OSS), and then the OSS address is passed to the backend through the `FileUrl` parameter. The backend retrieves the bytes from that address, writes them to its own OSS bucket, and creates a temporary temporary file record.
9613
+ * ### How to call
9614
+ * - **Recommended**: Use the `UploadChatFileAdvance` method generated by the SDK. Pass in the local file stream, and the SDK automatically completes the transfer upload and populates the `FileUrl` parameter.
9615
+ * - **Direct upload**: Upload the file to an OSS address accessible by the server, and then call this API operation directly with the `FileUrl` parameter.
9429
9616
  * ### Request parameters
9430
- * - **FileUrl**: Required. The OSS address of the file. When you use the Advance method, the SDK automatically populates this parameter. You do not need to manually assign a value.
9431
- * - **FileName**: Required. The original file name including the extension, such as `report.pdf`. The OSS address generated during transfer does not carry the original file name. The backend uses this parameter to determine the file extension and display name. Therefore, you must explicitly pass in this parameter.
9617
+ * - **FileUrl**: Required. The OSS address of the file. When you use the Advance method, the SDK automatically populates this parameter. You do not need to manually set it.
9618
+ * - **FileName**: Required. The original file name including the extension, such as `report.pdf`. The OSS address generated during the transfer does not carry the original file name. The backend uses this parameter to determine the file extension and display name. Therefore, you must explicitly pass in this parameter.
9432
9619
  * - **ContentType**: Optional. The MIME type of the file. If this parameter is not specified, `application/octet-stream` is used.
9433
- * - **OperatingObjectName**: Optional. The Agent namespace identifier that determines the file storage path.
9620
+ * - **OperatingObjectName**: Optional. The agent namespace identifier that determines the file storage path.
9434
9621
  * ### Response parameters
9435
- * The response includes the OSS object path `objectName`, the storage address `fileUrl`, the public access address `filePublicUrl` (valid for 1 hour), and the file record ID `fileRecordId`. The `uploadSignatureUrl` parameter is always empty in this mode.
9622
+ * The response includes the OSS object path `objectName`, the storage address `fileUrl`, the publicly accessible address `filePublicUrl` (valid for 1 hour), and the file record ID `fileRecordId`. The `uploadSignatureUrl` parameter is always empty in this mode.
9436
9623
  *
9437
9624
  * @param request - UploadChatFileRequest
9438
9625
  * @param headers - map
@@ -9477,21 +9664,21 @@ class Client extends openapi_core_1.default {
9477
9664
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.UploadChatFileResponse({}));
9478
9665
  }
9479
9666
  /**
9480
- * Uploads a local file in a session.
9667
+ * Uploads a local file for a session.
9481
9668
  *
9482
9669
  * @remarks
9483
9670
  * ## Operation description
9484
- * This API is used to upload a session temporary file by using the **file transfer upload** mode (`fileTransfer`). The file binary data is not transmitted through the request body of this API. Instead, the file is first uploaded to Object Storage Service (OSS), and then the OSS address is passed to the backend through the `FileUrl` parameter. The backend retrieves the bytes from that address, writes them to its own OSS, and creates a session temporary file record.
9485
- * ### Call methods
9486
- * - **Recommended**: Use the `UploadChatFileAdvance` method generated by the SDK. Pass in the local file stream, and the SDK automatically completes the transfer upload and populates `FileUrl`.
9487
- * - **Direct upload**: Upload the file to an OSS address accessible by the server, and then directly call this API with the `FileUrl` parameter.
9671
+ * This API operation uploads a temporary temporary file by using the **file transfer upload** mode (`fileTransfer`). The file binary data is not transmitted in the request body of this API operation. Instead, the file is first uploaded to Object Storage Service (OSS), and then the OSS address is passed to the backend through the `FileUrl` parameter. The backend retrieves the bytes from that address, writes them to its own OSS bucket, and creates a temporary temporary file record.
9672
+ * ### How to call
9673
+ * - **Recommended**: Use the `UploadChatFileAdvance` method generated by the SDK. Pass in the local file stream, and the SDK automatically completes the transfer upload and populates the `FileUrl` parameter.
9674
+ * - **Direct upload**: Upload the file to an OSS address accessible by the server, and then call this API operation directly with the `FileUrl` parameter.
9488
9675
  * ### Request parameters
9489
- * - **FileUrl**: Required. The OSS address of the file. When you use the Advance method, the SDK automatically populates this parameter. You do not need to manually assign a value.
9490
- * - **FileName**: Required. The original file name including the extension, such as `report.pdf`. The OSS address generated during transfer does not carry the original file name. The backend uses this parameter to determine the file extension and display name. Therefore, you must explicitly pass in this parameter.
9676
+ * - **FileUrl**: Required. The OSS address of the file. When you use the Advance method, the SDK automatically populates this parameter. You do not need to manually set it.
9677
+ * - **FileName**: Required. The original file name including the extension, such as `report.pdf`. The OSS address generated during the transfer does not carry the original file name. The backend uses this parameter to determine the file extension and display name. Therefore, you must explicitly pass in this parameter.
9491
9678
  * - **ContentType**: Optional. The MIME type of the file. If this parameter is not specified, `application/octet-stream` is used.
9492
- * - **OperatingObjectName**: Optional. The Agent namespace identifier that determines the file storage path.
9679
+ * - **OperatingObjectName**: Optional. The agent namespace identifier that determines the file storage path.
9493
9680
  * ### Response parameters
9494
- * The response includes the OSS object path `objectName`, the storage address `fileUrl`, the public access address `filePublicUrl` (valid for 1 hour), and the file record ID `fileRecordId`. The `uploadSignatureUrl` parameter is always empty in this mode.
9681
+ * The response includes the OSS object path `objectName`, the storage address `fileUrl`, the publicly accessible address `filePublicUrl` (valid for 1 hour), and the file record ID `fileRecordId`. The `uploadSignatureUrl` parameter is always empty in this mode.
9495
9682
  *
9496
9683
  * @param request - UploadChatFileRequest
9497
9684
  * @returns UploadChatFileResponse