时间机器 （预览版）

Time Machine 是一个 AI 驱动的企业学习平台。 它使用模块、主题、测验和角色扮演练习将公司文档、视频和专家知识转化为结构化课程，并跟踪学习者进度。 专为可大规模载入、培训和认证员工的 HR 和 L&D 团队而构建。 连接器可自动完成完整的学习生命周期：管理课程、用户、部门和角色;从文档生成测验;并读取完成分析。

此连接器在以下产品和区域中可用：

Service Class 区域
Copilot Studio 高级 除以下各项外的所有 Power Automate 区域：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
逻辑应用程序 标准 除以下各项外的所有 逻辑应用区域 ：
     - Azure 政府区域
     - Azure中国区域
     - 美国国防部（DoD）
Power Apps 高级 除以下各项外的所有 Power Apps 区域：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
Power Automate 高级 除以下各项外的所有 Power Automate 区域：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
联系人
名称 时间计算机支持
URL https://timeml.ai
连接器元数据
Publisher Time Machine AI
网站 https://timeml.ai
隐私策略 https://timeml.ai/privacy-policy
类别 生产力;AI

Time Machine — Power Automate连接器

什么是时间计算机

Time Machine 是一个由 AI 提供支持的组织学习平台，可帮助公司为新式团队构建、运营和持续改进自适应学习系统。 组织使用 Time Machine 将现有知识、文档、记录和工作流转换为可缩放的培训体验，这些体验可加速载入、改进员工准备情况，以及在整个组织中复制高性能专业知识。

租户管理员通过时间计算机 REST API 管理用户、学习内容、组织资源和平台配置。 此连接器将公共 REST API 公开为Power Automate操作，使你无需编写代码即可自动执行用户预配、内容引入、知识同步和生命周期管理。

先决条件

  • 具有管理员访问权限的活动 Time Machine 租户
  • 管理员面板中的“设置”→ API 密钥颁发的时间计算机 API 密钥。https://web.timeml.ai 键是一个以 tm_live_. 开头的值。

Authentication

每个操作都使用标头中的 Authorization API 密钥进行身份验证。 在 Power Automate 中创建连接时：

  • 字段：API key
  • 值：粘贴 Bearer tm_live_<your-token> （完整字符串，包括标记前的 Bearer 前缀和空格）

可用操作

连接器镜像时间计算机公共 REST API（116 终结点）。 操作按资源分组：

  • 课程 - 列出/创建/更新/删除/发布课程，分配角色，生成 AI 创作的内容
  • 用户 - 列出/创建/更新/停用/重新激活用户
  • 文档 - 列表/上传/更新/删除文档
  • 媒体 — 列表/上传/更新/删除媒体项
  • 部门 - 列出/创建/更新/删除部门，管理角色，将用户分配到角色
  • 专家 - 列出/创建专家档案，询问专家问题，分配文档和角色
  • 演示培训 - 列出/创建/更新/删除演示训练
  • 课程内容 - 模块、主题、课程、练习、测验问题
  • 见解 - 每名学生、每课程和公司级分析
  • 证书 - 列出学生证书、下载证书 PDF

完整终结点引用在 https://api.timeml.ai/api/v1/docs.

示例工作流

  • Confluence 版本→ Time Machine：在 Confluence 中发布发布页面时，在 Time Machine 中将其作为文档上传，以便它流入学习字节库。
  • HR 载入：当 HRIS 中出现新员工行时，请使用其部门和角色分配创建 Time Machine 用户，从而触发 magic-link 邀请。
  • 课程完成通知：当学生完成课程时，将证书 PDF 发送到 Slack 并将完成记录到 Google Sheet。

已知的限制

  • API 密钥轮换：轮换 API 密钥时必须手动更新连接。 没有自动刷新机制。
  • 多部分上传：文件上传操作（上传文档，上传媒体）接受高达 50 MB 的文件。 对于较大的媒体，请拆分为多个上传或联系 Time Machine 支持人员。
  • 批处理操作：API 一次在一条记录上运行。 对于批量操作，请使用Power Automate的内置应用于每个控件。

Support

有关连接器的问题，请联系时间计算机帐户团队或电子邮件支持人员 support@timeml.ai。

正在创建连接

连接器支持以下身份验证类型：
默认 用于创建连接的参数。 所有区域 不可共享

违约

适用：所有区域

用于创建连接的参数。

这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

名称 类型 Description 必需
时间计算机 API 密钥（格式：持有者tm_live_...） 安全字符串 此 API 的 Time Machine API 密钥（格式：持有者tm_live_...） 是

操作

上传媒体项

多部分上传（文件 + 可选说明）。 图像的最大 50MB，视频为 500MB。
上载文档

多部分上传（文件 + 可选说明）。 最大 50MB。
下载证书 PDF

流式传输证书 PDF。 如果证书尚没有 PDF，则返回 404
为一个问题类型设置主题测验计数

替换给定 questionType 的计数（MULTIPLE_CHOICE或OPEN_ENDED）。 保留其他类型的计数
为一个问题类型设置模块测验计数

替换给定 questionType 的计数（MULTIPLE_CHOICE或OPEN_ENDED）。 保留其他类型的计数
从专家中删除一个角色分配

幂等
从专家中删除所有角色分配

幂等
从专家取消分配文档

幂等
从主题取消链接一个文档

幂等
从角色取消分配用户

幂等 — 204，即使未分配
从课程中删除一个角色分配

幂等
从课程中删除所有角色分配

幂等
使用 AI 内容生成完整课程

为每个主题创建课程 shell、所有模块、所有主题和排队 AI 内容生成
停用用户

幂等 - 即使已停用，也会返回用户
公司级见解

调用方公司的顶级 KPI
列出专家

呼叫者公司的专家分页列表
列出主题中的学习字节数

返回属于给定主题的学习字节。
列出主题中的练习

按序号Number 排序的混合类型（ILE_TEXT/RPE_VOICE/RPE_VIDEO）
列出媒体

调用方公司中的媒体项分页列表
列出学习字节中的课程

返回属于给定学习字节的课程。
列出学生的证书

返回呼叫方公司内给定学生赚取的证书
列出文档

调用方公司中的文档分页列表
列出有关主题的测验问题

返回附加到给定主题的测验问题。
列出模块上的测验问题

返回附加到给定模块的测验问题。
列出模块中的主题

返回按 ordinalNumber 排序的活动主题
列出演示训练

范围限定为调用方公司的分页列表
列出用户

呼叫方公司中用户的分页列表
列出课程

呼叫者公司的课程分页列表
列出课程中的模块

返回按 ordinalNumber 排序的活动模块
列出课程内问题

返回附加到给定课程的知识检查问题。
列出课程版本

返回按版本号排序的已发布版本元数据（计数 + 发布信息）
列出部门

具有嵌套角色的调用方公司中的所有部门
列出链接到主题的文档

分页;按文档名称进行可选搜索
创建演示培训

从以前上传的视频文件创建演示训练并开始处理
创建用户

创建用户并触发 magic-link 邀请流
创建空课程

创建具有给定名称的新课程 shell
创建部门

在呼叫者的公司中创建新部门。
删除主题上的一个测验问题

幂等 — 204（即使已删除）
删除主题简介

幂等 — 204，即使未设置任何简介
删除主题（软）

幂等 - 即使主题已删除，也会返回 204
删除学习字节（软）

幂等 — 204（即使已删除）
删除模块上的一个测验问题

幂等 — 204（即使已删除）
删除模块简介

幂等 — 204，即使未设置任何简介
删除模块（软）

幂等 - 即使模块已删除，也会返回 204
删除演示训练

幂等 - 即使演示训练不存在或已消失，也会返回 204
删除练习

幂等 — 204（即使已删除）
删除课程内问题

幂等 — 204（即使已删除）
删除课程（软）

幂等 — 204（即使已删除）
删除（停用）媒体项

幂等 - 即使项已被删除或缺失，也会返回 204
删除（停用）文档

幂等 - 即使文档已被删除或缺失，也会返回 204
删除（停用）部门

幂等 - 即使已停用，也会返回 204。 级联到角色分配。
删除（软）课程

幂等 - 即使课程已删除，也会返回 204
发布课程

发布课程;如果它没有可发布内容，则失败并出现 400
向专家提问

流式处理 AI 聊天周围的同步包装器。 返回组合的答案。
向主题添加ILE_TEXT练习

在给定主题中创建一个新的ILE_TEXT练习。
向主题添加RPE_VIDEO练习

在给定的主题中创建一个新的RPE_VIDEO角色扮演练习。
向主题添加RPE_VOICE练习

在给定主题中创建一个新的RPE_VOICE角色扮演练习。
向主题添加学习字节

在给定的主题中创建一个新的学习字节。
向主题添加测验问题

在给定的主题中创建一个新的测验问题。
向模块添加测验问题

在给定模块中创建一个新的测验问题。
向课程分配角色

累加 - 已分配的角色将被跳过。 返回更新的课程详细信息
在模块中重新排序主题

topicIds 必须完全按新顺序包含每个活动主题一次
在课程中重新排序模块

moduleIds 必须按新顺序完全包含每个活动模块一次
在部门中创建角色

创建范围限定为给定部门的新角色。
对主题重新排序测验问题

questionIds 必须按新顺序包含主题的每个活动测验问题。
对模块重新排序测验问题

questionIds 必须按新顺序包括模块的每个活动测验问题。
将主题添加到模块

在给定模块中创建一个新主题。
将主题移动到另一个模块

targetOrdinalNumber 是可选的;如果省略了主题，则追加到目标模块
将可用性切换给学生

设置演示培训是否发布到学生。 幂等。
将文档分配给专家

将文档批量链接到专家。 幂等。
将文档链接到主题

已添加 — 跳过已链接的文档
将模块添加到课程

在给定的课程中创建一个新模块。
将用户分配到角色

幂等
将角色分配给专家

累加 - 已分配的角色保留;追加的新项。 返回更新的专家
将课程添加到学习字节

在给定学习字节内创建新课程。
更新主题上的一个测验问题

提供与存储类型匹配的字段;忽略不相关的字段。
更新主题元数据

更新名称和/或说明。 省略的字段保留当前值
更新媒体元数据

更新名称和/或说明
更新学习字节元数据

省略的字段保留当前值
更新文档元数据

更新名称和/或说明
更新模块上的一个测验问题

提供与存储类型匹配的字段;忽略不相关的字段。
更新模块元数据

更新名称和/或说明。 省略的字段保留当前值
更新演示培训

部分更新。 仅传递要更改的字段。 assignedRoleIds 替换当前集。
更新用户

更新 firstName、lastName、isAdmin 和角色分配。 电子邮件在 v1 中不可编辑。
更新练习

类型感知：ILE_TEXT仅使用 prompt + generatedContent.scenario;RPE_* 使用所有 RPE 字段。 省略的字段保留当前值。
更新课程元数据

更新课程名称
更新课程内容

省略的内容保留当前值
更新课程内问题

提供与存储类型匹配的字段;忽略不相关的字段
更新部门

更新名称和/或说明
替换媒体二进制文件

替换现有媒体项的文件二进制文件;元数据保留
替换文档二进制文件

替换现有文档的文件二进制文件;元数据保留
每学生活动事件

分页仅向前事件流
每学生见解

给定窗口的聚合摘要和每课程明细
添加课程内问题

类型必须MULTIPLE_CHOICE（需要选项）或OPEN_ENDED
获取一个课程内问题

按其 ID 返回单个课内问题。
获取专家

返回专家元数据、链接文档和分配的角色/部门
获取主题

返回给定 ID 的主题详细信息。
获取主题上的一个测验问题

返回附加到给定主题的单个测验问题。
获取主题简介

返回给定主题上设置的简介文本。
获取媒体项

返回媒体元数据和生存期较短的已签名下载 URL
获取学习字节

返回元数据和嵌套课程
获取文档

返回文档元数据和生存期较短的已签名下载 URL
获取模块

返回给定 ID 的模块详细信息。
获取模块上的一个测验问题

返回附加到给定模块的单个测验问题。
获取模块简介

返回给定模块上设置的简介文本。
获取演示培训

返回包含细分的完整演示训练
获取用户

返回用户元数据和部门/角色分配
获取练习

返回给定 ID 的练习详细信息。
获取课程

返回包含模块摘要和已分配角色/部门的课程元数据
获取课程

返回课程内容、媒体和课程内问题
获取课程版本快照

返回给定版本的完整内容树（模块、主题、课程、练习、问题）
获取课程的 AI 生成状态

返回具有进度和目标信息的课程的活动 AI 生成请求列表
触发主题的 AI 内容生成

在课程中排队指定主题的 AI 内容生成
设置或替换主题简介

Upsert - 如果缺少，则创建替换（如果存在）
设置或替换模块简介

Upsert - 如果缺少，则创建替换（如果存在）
证书详细信息

返回一个限定为调用方公司的证书
通过 AI 重新生成特定项

重新生成单个课程、课程问题、测验、简介或练习
重新排序课内问题

questionIds 必须以新顺序包含课程的每个活动问题
重新激活用户

幂等 - 即使用户已处于活动状态，也会返回用户
重新运行视频处理

重新提交 AI 分段视频。 （可选）重写处理提示。

上传媒体项

操作 ID:
uploadMedia

多部分上传（文件 + 可选说明）。 图像的最大 50MB，视频为 500MB。

参数

名称 密钥 必需 类型 说明
文件
 file True file

文件
Description
 description string

Description

返回

Body
MediaDetailDto

上载文档

操作 ID:
uploadDocument

多部分上传（文件 + 可选说明）。 最大 50MB。

参数

名称 密钥 必需 类型 说明
文件
 file True file

文件
Description
 description string

Description

返回

Body
DocumentDetailDto

下载证书 PDF

操作 ID:
downloadCertificatePdf

流式传输证书 PDF。 如果证书尚没有 PDF，则返回 404

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id

返回

响应
StreamingResponseBody

为一个问题类型设置主题测验计数

操作 ID:
setTopicQuizSettings

替换给定 questionType 的计数（MULTIPLE_CHOICE或OPEN_ENDED）。 保留其他类型的计数

参数

名称 密钥 必需 类型 说明
主题 ID
 topicId True uuid

主题 ID
questionType
 questionType True string
计数
 count integer

返回

Body
TopicDto

为一个问题类型设置模块测验计数

操作 ID:
setModuleQuizSettings

替换给定 questionType 的计数（MULTIPLE_CHOICE或OPEN_ENDED）。 保留其他类型的计数

参数

名称 密钥 必需 类型 说明
模块 ID
 moduleId True uuid

模块 ID
questionType
 questionType True string
计数
 count integer

返回

Body
ModuleDetailDto

从专家中删除一个角色分配

操作 ID:
removeRoleFromExpert

幂等

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id
角色 ID
 roleId True uuid

角色 ID

从专家中删除所有角色分配

操作 ID:
removeAllRolesFromExpert

幂等

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id

从专家取消分配文档

操作 ID:
unassignDocumentFromExpert

幂等

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id
文档 ID
 documentId True uuid

文档 ID

从主题取消链接一个文档

操作 ID:
unlinkDocumentFromTopic

幂等

参数

名称 密钥 必需 类型 说明
主题 ID
 topicId True uuid

主题 ID
文档 ID
 documentId True uuid

文档 ID

从角色取消分配用户

操作 ID:
unassignUserFromRole

幂等 — 204，即使未分配

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id
角色 ID
 roleId True uuid

角色 ID
用户 ID
 userId True uuid

用户 ID

从课程中删除一个角色分配

操作 ID:
removeRoleFromCourse

幂等

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id
角色 ID
 roleId True uuid

角色 ID

从课程中删除所有角色分配

操作 ID:
removeAllRolesFromCourse

幂等

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id

使用 AI 内容生成完整课程

操作 ID:
generateCourse

为每个主题创建课程 shell、所有模块、所有主题和排队 AI 内容生成

参数

名称 密钥 必需 类型 说明
名字
 name True string
描述
 description string
名字
 name True string
描述
 description string
名字
 name True string
描述
 description string

返回

Body
GenerateCourseResponse

停用用户

操作 ID:
deactivateUser

幂等 - 即使已停用，也会返回用户

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id

返回

Body
UserDto

公司级见解

操作 ID:
getCompanyInsights

调用方公司的顶级 KPI

返回

Body
CompanyInsightsDto

列出专家

操作 ID:
listExperts

呼叫者公司的专家分页列表

参数

名称 密钥 必需 类型 说明
Page
 page integer

Page
大小
 size integer

大小
搜寻
 search string

搜寻

返回

Body
ExpertListResponse

列出主题中的学习字节数

操作 ID:
listLearningBytesInTopic

返回属于给定主题的学习字节。

参数

名称 密钥 必需 类型 说明
主题 ID
 topicId True uuid

主题 ID

返回

Body
LearningByteListResponse

列出主题中的练习

操作 ID:
listExercisesInTopic

按序号Number 排序的混合类型（ILE_TEXT/RPE_VOICE/RPE_VIDEO）

参数

名称 密钥 必需 类型 说明
主题 ID
 topicId True uuid

主题 ID

返回

Body
ExerciseListResponse

列出媒体

操作 ID:
listMedia

调用方公司中的媒体项分页列表

参数

名称 密钥 必需 类型 说明
Page
 page integer

Page
大小
 size integer

大小
搜寻
 search string

搜寻
种类
 kind string

种类
Status
 status string

Status

返回

Body
MediaListResponse

列出学习字节中的课程

操作 ID:
listLessonsInLearningByte

返回属于给定学习字节的课程。

参数

名称 密钥 必需 类型 说明
Lb Id
 lbId True uuid

Lb Id

返回

Body
LessonListResponse

列出学生的证书

操作 ID:
listStudentCertificates

返回呼叫方公司内给定学生赚取的证书

参数

名称 密钥 必需 类型 说明
用户 ID
 userId True uuid

用户 ID

返回

Body
CertificateListResponse

列出文档

操作 ID:
listDocuments

调用方公司中的文档分页列表

参数

名称 密钥 必需 类型 说明
Page
 page integer

Page
大小
 size integer

大小
搜寻
 search string

搜寻
Mime 类型
 mimeTypes string

Mime 类型
Status
 status string

Status

返回

Body
DocumentListResponse

列出有关主题的测验问题

操作 ID:
listTopicQuizQuestions

返回附加到给定主题的测验问题。

参数

名称 密钥 必需 类型 说明
主题 ID
 topicId True uuid

主题 ID

返回

Body
QuestionListResponse

列出模块上的测验问题

操作 ID:
listModuleQuizQuestions

返回附加到给定模块的测验问题。

参数

名称 密钥 必需 类型 说明
模块 ID
 moduleId True uuid

模块 ID

返回

Body
QuestionListResponse

列出模块中的主题

操作 ID:
listTopicsInModule

返回按 ordinalNumber 排序的活动主题

参数

名称 密钥 必需 类型 说明
模块 ID
 moduleId True uuid

模块 ID

返回

Body
TopicListResponse

列出演示训练

操作 ID:
listDemoTrainings

范围限定为调用方公司的分页列表

参数

名称 密钥 必需 类型 说明
Page
 page integer

Page
大小
 size integer

大小
搜寻
 search string

搜寻
训练类型
 trainingTypes string

训练类型
状态
 statuses string

状态
部门 ID
 departmentIds string

部门 ID
可用
 isAvailable boolean

可用

返回

Body
DemoTrainingListResponse

列出用户

操作 ID:
listUsers

呼叫方公司中用户的分页列表

参数

名称 密钥 必需 类型 说明
Page
 page integer

Page
大小
 size integer

大小
搜寻
 search string

搜寻
Status
 status string

Status
部门 ID
 departmentIds string

部门 ID
角色 ID
 roleIds string

角色 ID
种类
 kind string

种类

返回

Body
UserListResponse

列出课程

操作 ID:
listCourses

呼叫者公司的课程分页列表

参数

名称 密钥 必需 类型 说明
Page
 page integer

Page
大小
 size integer

大小
搜寻
 search string

搜寻
Status
 status string

Status
部门角色 ID
 departmentRoleIds string

部门角色 ID

返回

Body
CourseListResponse

列出课程中的模块

操作 ID:
listModulesInCourse

返回按 ordinalNumber 排序的活动模块

参数

名称 密钥 必需 类型 说明
课程 ID
 courseId True uuid

课程 ID

返回

Body
ModuleListResponse

列出课程内问题

操作 ID:
listLessonQuestions

返回附加到给定课程的知识检查问题。

参数

名称 密钥 必需 类型 说明
课程 ID
 lessonId True uuid

课程 ID

返回

Body
QuestionListResponse

列出课程版本

操作 ID:
listCourseVersions

返回按版本号排序的已发布版本元数据（计数 + 发布信息）

参数

名称 密钥 必需 类型 说明
课程 ID
 courseId True uuid

课程 ID

返回

Body
CourseVersionListResponse

列出部门

操作 ID:
listDepartments

具有嵌套角色的调用方公司中的所有部门

返回

Body
DepartmentListResponse

列出链接到主题的文档

操作 ID:
listTopicLinkedDocuments

分页;按文档名称进行可选搜索

参数

名称 密钥 必需 类型 说明
主题 ID
 topicId True uuid

主题 ID
Page
 page integer

Page
大小
 size integer

大小
搜寻
 search string

搜寻

返回

Body
TopicLinkedDocumentListResponse

创建演示培训

操作 ID:
createDemoTraining

从以前上传的视频文件创建演示训练并开始处理

参数

名称 密钥 必需 类型 说明
名字
 name True string
描述
 description string
trainingType
 trainingType True string
videoFileId
 videoFileId True uuid
departmentId
 departmentId uuid
processingPrompt
 processingPrompt string

返回

Body
DemoTrainingDto

创建用户

操作 ID:
createUser

创建用户并触发 magic-link 邀请流

参数

名称 密钥 必需 类型 说明
电子邮件
 email True email
firstName
 firstName string
lastName
 lastName string
isAdmin
 isAdmin boolean
departmentRoleIds
 departmentRoleIds array of uuid

返回

Body
UserDto

创建空课程

操作 ID:
createCourse

创建具有给定名称的新课程 shell

参数

名称 密钥 必需 类型 说明
名字
 name True string

返回

Body
CourseDetailDto

创建部门

操作 ID:
createDepartment

在呼叫者的公司中创建新部门。

参数

名称 密钥 必需 类型 说明
名字
 name True string
描述
 description string

返回

Body
DepartmentDto

删除主题上的一个测验问题

操作 ID:
deleteTopicQuizQuestion

幂等 — 204（即使已删除）

参数

名称 密钥 必需 类型 说明
主题 ID
 topicId True uuid

主题 ID
问题 ID
 questionId True uuid

问题 ID

删除主题简介

操作 ID:
removeTopicIntro

幂等 — 204，即使未设置任何简介

参数

名称 密钥 必需 类型 说明
主题 ID
 topicId True uuid

主题 ID

删除主题（软）

操作 ID:
deleteTopic

幂等 - 即使主题已删除，也会返回 204

参数

名称 密钥 必需 类型 说明
主题 ID
 topicId True uuid

主题 ID

删除学习字节（软）

操作 ID:
deleteLearningByte

幂等 — 204（即使已删除）

参数

名称 密钥 必需 类型 说明
Lb Id
 lbId True uuid

Lb Id

删除模块上的一个测验问题

操作 ID:
deleteModuleQuizQuestion

幂等 — 204（即使已删除）

参数

名称 密钥 必需 类型 说明
模块 ID
 moduleId True uuid

模块 ID
问题 ID
 questionId True uuid

问题 ID

删除模块简介

操作 ID:
removeModuleIntro

幂等 — 204，即使未设置任何简介

参数

名称 密钥 必需 类型 说明
模块 ID
 moduleId True uuid

模块 ID

删除模块（软）

操作 ID:
deleteModule

幂等 - 即使模块已删除，也会返回 204

参数

名称 密钥 必需 类型 说明
模块 ID
 moduleId True uuid

模块 ID

删除演示训练

操作 ID:
deleteDemoTraining

幂等 - 即使演示训练不存在或已消失，也会返回 204

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id

删除练习

操作 ID:
deleteExercise

幂等 — 204（即使已删除）

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id

删除课程内问题

操作 ID:
deleteLessonQuestion

幂等 — 204（即使已删除）

参数

名称 密钥 必需 类型 说明
课程 ID
 lessonId True uuid

课程 ID
问题 ID
 questionId True uuid

问题 ID

删除课程（软）

操作 ID:
deleteLesson

幂等 — 204（即使已删除）

参数

名称 密钥 必需 类型 说明
课程 ID
 lessonId True uuid

课程 ID

删除（停用）媒体项

操作 ID:
deleteMedia

幂等 - 即使项已被删除或缺失，也会返回 204

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id

删除（停用）文档

操作 ID:
deleteDocument

幂等 - 即使文档已被删除或缺失，也会返回 204

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id

删除（停用）部门

操作 ID:
deleteDepartment

幂等 - 即使已停用，也会返回 204。 级联到角色分配。

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id

删除（软）课程

操作 ID:
deleteCourse

幂等 - 即使课程已删除，也会返回 204

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id

发布课程

操作 ID:
publishCourse

发布课程;如果它没有可发布内容，则失败并出现 400

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id

返回

Body
CourseDetailDto

向专家提问

操作 ID:
askExpert

流式处理 AI 聊天周围的同步包装器。 返回组合的答案。

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id
问题
 question True string

返回

Body
AskResponse

向主题添加ILE_TEXT练习

操作 ID:
addIleTextExercise

在给定主题中创建一个新的ILE_TEXT练习。

参数

名称 密钥 必需 类型 说明
主题 ID
 topicId True uuid

主题 ID
提示
 prompt string

返回

Body
ExerciseDto

向主题添加RPE_VIDEO练习

操作 ID:
addRpeVideoExercise

在给定的主题中创建一个新的RPE_VIDEO角色扮演练习。

参数

名称 密钥 必需 类型 说明
主题 ID
 topicId True uuid

主题 ID
提示
 prompt string
avatarPictureId
 avatarPictureId uuid
avatarCharacteristics
 avatarCharacteristics string
reverseRolePlayEnabled
 reverseRolePlayEnabled boolean
reverseRolePlayMandatory
 reverseRolePlayMandatory boolean

返回

Body
ExerciseDto

向主题添加RPE_VOICE练习

操作 ID:
addRpeVoiceExercise

在给定主题中创建一个新的RPE_VOICE角色扮演练习。

参数

名称 密钥 必需 类型 说明
主题 ID
 topicId True uuid

主题 ID
提示
 prompt string
avatarPictureId
 avatarPictureId uuid
avatarCharacteristics
 avatarCharacteristics string
reverseRolePlayEnabled
 reverseRolePlayEnabled boolean
reverseRolePlayMandatory
 reverseRolePlayMandatory boolean

返回

Body
ExerciseDto

向主题添加学习字节

操作 ID:
addLearningByteToTopic

在给定的主题中创建一个新的学习字节。

参数

名称 密钥 必需 类型 说明
主题 ID
 topicId True uuid

主题 ID
名字
 name True string
描述
 description string

返回

Body
LearningByteDetailDto

向主题添加测验问题

操作 ID:
addTopicQuizQuestion

在给定的主题中创建一个新的测验问题。

参数

名称 密钥 必需 类型 说明
主题 ID
 topicId True uuid

主题 ID
类型
 type True string
文本消息
 text True string
ordinalNumber
 ordinalNumber integer
文本消息
 text True string
isCorrect
 isCorrect boolean
expectedAnswer
 expectedAnswer string

返回

Body
QuestionDto

向模块添加测验问题

操作 ID:
addModuleQuizQuestion

在给定模块中创建一个新的测验问题。

参数

名称 密钥 必需 类型 说明
模块 ID
 moduleId True uuid

模块 ID
类型
 type True string
文本消息
 text True string
ordinalNumber
 ordinalNumber integer
文本消息
 text True string
isCorrect
 isCorrect boolean
expectedAnswer
 expectedAnswer string

返回

Body
QuestionDto

向课程分配角色

操作 ID:
assignRolesToCourse

累加 - 已分配的角色将被跳过。 返回更新的课程详细信息

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id
roleIds
 roleIds True array of uuid

返回

Body
CourseDetailDto

在模块中重新排序主题

操作 ID:
reorderTopicsInModule

topicIds 必须完全按新顺序包含每个活动主题一次

参数

名称 密钥 必需 类型 说明
模块 ID
 moduleId True uuid

模块 ID
topicIds
 topicIds True array of uuid

返回

Body
TopicListResponse

在课程中重新排序模块

操作 ID:
reorderModulesInCourse

moduleIds 必须按新顺序完全包含每个活动模块一次

参数

名称 密钥 必需 类型 说明
课程 ID
 courseId True uuid

课程 ID
moduleIds
 moduleIds True array of uuid

返回

Body
ModuleListResponse

在部门中创建角色

操作 ID:
createRoleInDepartment

创建范围限定为给定部门的新角色。

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id
名字
 name True string
fullName
 fullName string
描述
 description string

返回

Body
DepartmentDto

对主题重新排序测验问题

操作 ID:
reorderTopicQuizQuestions

questionIds 必须按新顺序包含主题的每个活动测验问题。

参数

名称 密钥 必需 类型 说明
主题 ID
 topicId True uuid

主题 ID
questionIds
 questionIds True array of uuid

返回

Body
QuestionListResponse

对模块重新排序测验问题

操作 ID:
reorderModuleQuizQuestions

questionIds 必须按新顺序包括模块的每个活动测验问题。

参数

名称 密钥 必需 类型 说明
模块 ID
 moduleId True uuid

模块 ID
questionIds
 questionIds True array of uuid

返回

Body
QuestionListResponse

将主题添加到模块

操作 ID:
addTopicToModule

在给定模块中创建一个新主题。

参数

名称 密钥 必需 类型 说明
模块 ID
 moduleId True uuid

模块 ID
名字
 name True string
描述
 description string

返回

Body
TopicDto

将主题移动到另一个模块

操作 ID:
moveTopic

targetOrdinalNumber 是可选的;如果省略了主题，则追加到目标模块

参数

名称 密钥 必需 类型 说明
主题 ID
 topicId True uuid

主题 ID
targetModuleId
 targetModuleId True uuid
targetOrdinalNumber
 targetOrdinalNumber integer

返回

Body
TopicDto

将可用性切换给学生

操作 ID:
updateDemoTrainingAvailability

设置演示培训是否发布到学生。 幂等。

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id
available
 available True boolean

返回

Body
DemoTrainingDto

将文档分配给专家

操作 ID:
assignDocumentsToExpert

将文档批量链接到专家。 幂等。

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id
documentIds
 documentIds True array of uuid

返回

Body
ExpertDetailDto

将文档链接到主题

操作 ID:
linkDocumentsToTopic

已添加 — 跳过已链接的文档

参数

名称 密钥 必需 类型 说明
主题 ID
 topicId True uuid

主题 ID
documentIds
 documentIds True array of uuid

将模块添加到课程

操作 ID:
addModuleToCourse

在给定的课程中创建一个新模块。

参数

名称 密钥 必需 类型 说明
课程 ID
 courseId True uuid

课程 ID
名字
 name True string
描述
 description string

返回

Body
ModuleDetailDto

将用户分配到角色

操作 ID:
assignUserToRole

幂等

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id
角色 ID
 roleId True uuid

角色 ID
userId
 userId True uuid

返回

Body
DepartmentDto

将角色分配给专家

操作 ID:
assignRolesToExpert

累加 - 已分配的角色保留;追加的新项。 返回更新的专家

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id
roleIds
 roleIds True array of uuid

返回

Body
ExpertDetailDto

将课程添加到学习字节

操作 ID:
addLessonToLearningByte

在给定学习字节内创建新课程。

参数

名称 密钥 必需 类型 说明
Lb Id
 lbId True uuid

Lb Id
内容
 content True string

返回

Body
LessonDetailDto

更新主题上的一个测验问题

操作 ID:
updateTopicQuizQuestion

提供与存储类型匹配的字段;忽略不相关的字段。

参数

名称 密钥 必需 类型 说明
主题 ID
 topicId True uuid

主题 ID
问题 ID
 questionId True uuid

问题 ID
文本消息
 text string
文本消息
 text True string
isCorrect
 isCorrect boolean
expectedAnswer
 expectedAnswer string

返回

Body
QuestionDto

更新主题元数据

操作 ID:
updateTopic

更新名称和/或说明。 省略的字段保留当前值

参数

名称 密钥 必需 类型 说明
主题 ID
 topicId True uuid

主题 ID
名字
 name string
描述
 description string

返回

Body
TopicDto

更新媒体元数据

操作 ID:
updateMediaMetadata

更新名称和/或说明

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id
名字
 name string
描述
 description string

返回

Body
MediaDetailDto

更新学习字节元数据

操作 ID:
updateLearningByte

省略的字段保留当前值

参数

名称 密钥 必需 类型 说明
Lb Id
 lbId True uuid

Lb Id
名字
 name string
描述
 description string

返回

Body
LearningByteDetailDto

更新文档元数据

操作 ID:
updateDocumentMetadata

更新名称和/或说明

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id
名字
 name string
描述
 description string

返回

Body
DocumentDetailDto

更新模块上的一个测验问题

操作 ID:
updateModuleQuizQuestion

提供与存储类型匹配的字段;忽略不相关的字段。

参数

名称 密钥 必需 类型 说明
模块 ID
 moduleId True uuid

模块 ID
问题 ID
 questionId True uuid

问题 ID
文本消息
 text string
文本消息
 text True string
isCorrect
 isCorrect boolean
expectedAnswer
 expectedAnswer string

返回

Body
QuestionDto

更新模块元数据

操作 ID:
updateModule

更新名称和/或说明。 省略的字段保留当前值

参数

名称 密钥 必需 类型 说明
模块 ID
 moduleId True uuid

模块 ID
名字
 name string
描述
 description string

返回

Body
ModuleDetailDto

更新演示培训

操作 ID:
updateDemoTraining

部分更新。 仅传递要更改的字段。 assignedRoleIds 替换当前集。

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id
名字
 name string
描述
 description string
trainingType
 trainingType string
departmentId
 departmentId uuid
assignedRoleIds
 assignedRoleIds array of uuid

返回

Body
DemoTrainingDto

更新用户

操作 ID:
updateUser

更新 firstName、lastName、isAdmin 和角色分配。 电子邮件在 v1 中不可编辑。

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id
firstName
 firstName string
lastName
 lastName string
isAdmin
 isAdmin boolean
departmentRoleIds
 departmentRoleIds array of uuid

返回

Body
UserDto

更新练习

操作 ID:
updateExercise

类型感知：ILE_TEXT仅使用 prompt + generatedContent.scenario;RPE_* 使用所有 RPE 字段。 省略的字段保留当前值。

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id
提示
 prompt string
avatarPictureId
 avatarPictureId uuid
avatarCharacteristics
 avatarCharacteristics string
reverseRolePlayEnabled
 reverseRolePlayEnabled boolean
reverseRolePlayMandatory
 reverseRolePlayMandatory boolean
方案
 scenario string
traineeRole
 traineeRole string
avatarName
 avatarName string
avatarDescription
 avatarDescription string
operationalChallenge
 operationalChallenge string
successMetric
 successMetric string

返回

Body
ExerciseDto

更新课程元数据

操作 ID:
updateCourse

更新课程名称

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id
名字
 name string

返回

Body
CourseDetailDto

更新课程内容

操作 ID:
updateLesson

省略的内容保留当前值

参数

名称 密钥 必需 类型 说明
课程 ID
 lessonId True uuid

课程 ID
内容
 content string

返回

Body
LessonDetailDto

更新课程内问题

操作 ID:
updateLessonQuestion

提供与存储类型匹配的字段;忽略不相关的字段

参数

名称 密钥 必需 类型 说明
课程 ID
 lessonId True uuid

课程 ID
问题 ID
 questionId True uuid

问题 ID
文本消息
 text string
文本消息
 text True string
isCorrect
 isCorrect boolean
expectedAnswer
 expectedAnswer string

返回

Body
QuestionDto

更新部门

操作 ID:
updateDepartment

更新名称和/或说明

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id
名字
 name string
描述
 description string

返回

Body
DepartmentDto

替换媒体二进制文件

操作 ID:
replaceMediaFile

替换现有媒体项的文件二进制文件;元数据保留

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id
文件
 file True file

文件

返回

Body
MediaDetailDto

替换文档二进制文件

操作 ID:
replaceDocumentFile

替换现有文档的文件二进制文件;元数据保留

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id
文件
 file True file

文件

返回

Body
DocumentDetailDto

每学生活动事件

操作 ID:
listStudentEvents

分页仅向前事件流

参数

名称 密钥 必需 类型 说明
用户 ID
 userId True uuid

用户 ID
Page
 page integer

Page
大小
 size integer

大小

返回

Body
EventListResponse

每学生见解

操作 ID:
getStudentInsights

给定窗口的聚合摘要和每课程明细

参数

名称 密钥 必需 类型 说明
用户 ID
 userId True uuid

用户 ID
窗口
 window string

窗口

返回

Body
StudentInsightsDto

添加课程内问题

操作 ID:
addLessonQuestion

类型必须MULTIPLE_CHOICE（需要选项）或OPEN_ENDED

参数

名称 密钥 必需 类型 说明
课程 ID
 lessonId True uuid

课程 ID
类型
 type True string
文本消息
 text True string
ordinalNumber
 ordinalNumber integer
文本消息
 text True string
isCorrect
 isCorrect boolean
expectedAnswer
 expectedAnswer string

返回

Body
QuestionDto

获取一个课程内问题

操作 ID:
getLessonQuestion

按其 ID 返回单个课内问题。

参数

名称 密钥 必需 类型 说明
课程 ID
 lessonId True uuid

课程 ID
问题 ID
 questionId True uuid

问题 ID

返回

Body
QuestionDto

获取专家

操作 ID:
getExpert

返回专家元数据、链接文档和分配的角色/部门

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id

返回

Body
ExpertDetailDto

获取主题

操作 ID:
getTopic

返回给定 ID 的主题详细信息。

参数

名称 密钥 必需 类型 说明
主题 ID
 topicId True uuid

主题 ID

返回

Body
TopicDto

获取主题上的一个测验问题

操作 ID:
getTopicQuizQuestion

返回附加到给定主题的单个测验问题。

参数

名称 密钥 必需 类型 说明
主题 ID
 topicId True uuid

主题 ID
问题 ID
 questionId True uuid

问题 ID

返回

Body
QuestionDto

获取主题简介

操作 ID:
getTopicIntro

返回给定主题上设置的简介文本。

参数

名称 密钥 必需 类型 说明
主题 ID
 topicId True uuid

主题 ID

返回

Body
IntroDto

获取媒体项

操作 ID:
getMediaItem

返回媒体元数据和生存期较短的已签名下载 URL

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id

返回

Body
MediaDetailDto

获取学习字节

操作 ID:
getLearningByte

返回元数据和嵌套课程

参数

名称 密钥 必需 类型 说明
Lb Id
 lbId True uuid

Lb Id

返回

Body
LearningByteDetailDto

获取文档

操作 ID:
getDocument

返回文档元数据和生存期较短的已签名下载 URL

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id

返回

Body
DocumentDetailDto

获取模块

操作 ID:
getModule

返回给定 ID 的模块详细信息。

参数

名称 密钥 必需 类型 说明
模块 ID
 moduleId True uuid

模块 ID

返回

Body
ModuleDetailDto

获取模块上的一个测验问题

操作 ID:
getModuleQuizQuestion

返回附加到给定模块的单个测验问题。

参数

名称 密钥 必需 类型 说明
模块 ID
 moduleId True uuid

模块 ID
问题 ID
 questionId True uuid

问题 ID

返回

Body
QuestionDto

获取模块简介

操作 ID:
getModuleIntro

返回给定模块上设置的简介文本。

参数

名称 密钥 必需 类型 说明
模块 ID
 moduleId True uuid

模块 ID

返回

Body
IntroDto

获取演示培训

操作 ID:
getDemoTraining

返回包含细分的完整演示训练

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id

返回

Body
DemoTrainingDto

获取用户

操作 ID:
getUser

返回用户元数据和部门/角色分配

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id

返回

Body
UserDto

获取练习

操作 ID:
getExercise

返回给定 ID 的练习详细信息。

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id

返回

Body
ExerciseDto

获取课程

操作 ID:
getCourse

返回包含模块摘要和已分配角色/部门的课程元数据

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id

返回

Body
CourseDetailDto

获取课程

操作 ID:
getLesson

返回课程内容、媒体和课程内问题

参数

名称 密钥 必需 类型 说明
课程 ID
 lessonId True uuid

课程 ID

返回

Body
LessonDetailDto

获取课程版本快照

操作 ID:
getCourseVersion

返回给定版本的完整内容树（模块、主题、课程、练习、问题）

参数

名称 密钥 必需 类型 说明
课程 ID
 courseId True uuid

课程 ID
版本号
 versionNumber True integer

版本号

返回

Body
CourseVersionSnapshotDto

获取课程的 AI 生成状态

操作 ID:
getCourseGenerationStatus

返回具有进度和目标信息的课程的活动 AI 生成请求列表

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id

返回

Body
GenerationStatusResponse

触发主题的 AI 内容生成

操作 ID:
generateCourseContent

在课程中排队指定主题的 AI 内容生成

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id
topicIds
 topicIds True array of uuid

返回

Body
GenerationRequestResponse

设置或替换主题简介

操作 ID:
setTopicIntro

Upsert - 如果缺少，则创建替换（如果存在）

参数

名称 密钥 必需 类型 说明
主题 ID
 topicId True uuid

主题 ID
简介
 introduction string

返回

Body
IntroDto

设置或替换模块简介

操作 ID:
setModuleIntro

Upsert - 如果缺少，则创建替换（如果存在）

参数

名称 密钥 必需 类型 说明
模块 ID
 moduleId True uuid

模块 ID
简介
 introduction string

返回

Body
IntroDto

证书详细信息

操作 ID:
getCertificate

返回一个限定为调用方公司的证书

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id

返回

Body
CertificateDto

通过 AI 重新生成特定项

操作 ID:
regenerateCourseItem

重新生成单个课程、课程问题、测验、简介或练习

参数

名称 密钥 必需 类型 说明
目标
 target True string
targetId
 targetId True uuid
父类型
 parentType string

返回

Body
GenerationRequestResponse

重新排序课内问题

操作 ID:
reorderLessonQuestions

questionIds 必须以新顺序包含课程的每个活动问题

参数

名称 密钥 必需 类型 说明
课程 ID
 lessonId True uuid

课程 ID
questionIds
 questionIds True array of uuid

返回

Body
QuestionListResponse

重新激活用户

操作 ID:
reactivateUser

幂等 - 即使用户已处于活动状态，也会返回用户

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id

返回

Body
UserDto

重新运行视频处理

操作 ID:
reprocessDemoTraining

重新提交 AI 分段视频。 （可选）重写处理提示。

参数

名称 密钥 必需 类型 说明
Id
 id True uuid

Id
processingPrompt
 processingPrompt string

返回

Body
DemoTrainingDto

定义

QuizSettingDto

名称 路径 类型 说明
questionType
 questionType string
计数
 count integer

TopicDto

名称 路径 类型 说明
id
 id uuid
moduleId
 moduleId uuid
名字
 name string
描述
 description string
ordinalNumber
 ordinalNumber integer
hasContent
 hasContent boolean
quizSettings
 quizSettings array of QuizSettingDto

IntroDto

名称 路径 类型 说明
id
 id uuid
组件 ID
 componentId uuid
componentType
 componentType string
简介
 introduction string
源
 source string
createdAt
 createdAt date-time
updatedAt
 updatedAt date-time

ModuleDetailDto

名称 路径 类型 说明
id
 id uuid
courseId
 courseId uuid
名字
 name string
描述
 description string
productId
 productId uuid
ordinalNumber
 ordinalNumber integer
lockedForGeneration
 lockedForGeneration boolean
quizSettings
 quizSettings array of QuizSettingDto
topics
 topics array of TopicDto

MediaDetailDto

名称 路径 类型 说明
id
 id uuid
名字
 name string
描述
 description string
kind
 kind string
MIME类型
 mimeType string
sizeBytes
 sizeBytes integer
状态
 status string
processingStatus
 processingStatus string
createdAt
 createdAt date-time
uploadedBy
 uploadedBy UploadedByDto
downloadUrl 的
 downloadUrl string

UploadedByDto

名称 路径 类型 说明
id
 id uuid
kind
 kind string
名字
 name string

DocumentDetailDto

名称 路径 类型 说明
id
 id uuid
名字
 name string
描述
 description string
MIME类型
 mimeType string
sizeBytes
 sizeBytes integer
状态
 status string
createdAt
 createdAt date-time
uploadedBy
 uploadedBy UploadedByDto
downloadUrl 的
 downloadUrl string

DepartmentRoleDto

名称 路径 类型 说明
departmentId
 departmentId uuid
部门名称
 departmentName string
roleId
 roleId uuid
角色名称
 roleName string

UserDto

名称 路径 类型 说明
id
 id uuid
电子邮件
 email string
firstName
 firstName string
lastName
 lastName string
状态
 status string
kind
 kind string
isAdmin
 isAdmin boolean
createdAt
 createdAt date-time
departmentRoles
 departmentRoles array of DepartmentRoleDto

QuestionDto

名称 路径 类型 说明
id
 id uuid
类型
 type string
parentId
 parentId uuid
父类型
 parentType string
文本消息
 text string
ordinalNumber
 ordinalNumber integer
源
 source string
expectedAnswer
 expectedAnswer string
选项
 options array of QuestionOptionDto
createdAt
 createdAt date-time
updatedAt
 updatedAt date-time

QuestionOptionDto

名称 路径 类型 说明
文本消息
 text string
isCorrect
 isCorrect boolean
ordinalNumber
 ordinalNumber integer

QuestionListResponse

名称 路径 类型 说明
items
 items array of QuestionDto

LearningByteDetailDto

名称 路径 类型 说明
id
 id uuid
topicId
 topicId uuid
名字
 name string
描述
 description string
ordinalNumber
 ordinalNumber integer
源
 source string
createdAt
 createdAt date-time
updatedAt
 updatedAt date-time
课程
 lessons array of LessonDto

LessonDto

名称 路径 类型 说明
id
 id uuid
learningByteId
 learningByteId uuid
内容
 content string
ordinalNumber
 ordinalNumber integer
源
 source string
questionCount
 questionCount integer
mediaCount
 mediaCount integer
createdAt
 createdAt date-time
updatedAt
 updatedAt date-time

ExerciseDto

名称 路径 类型 说明
id
 id uuid
topicId
 topicId uuid
类型
 type string
提示
 prompt string
ordinalNumber
 ordinalNumber integer
源
 source string
isGenerated
 isGenerated boolean
avatarPictureId
 avatarPictureId uuid
avatarCharacteristics
 avatarCharacteristics string
reverseRolePlayEnabled
 reverseRolePlayEnabled boolean
reverseRolePlayMandatory
 reverseRolePlayMandatory boolean
generatedContent
 generatedContent ExerciseGeneratedContentDto
createdAt
 createdAt date-time
updatedAt
 updatedAt date-time

ExerciseGeneratedContentDto

名称 路径 类型 说明
id
 id uuid
regenerationId
 regenerationId uuid
方案
 scenario string
traineeRole
 traineeRole string
avatarName
 avatarName string
avatarDescription
 avatarDescription string
operationalChallenge
 operationalChallenge string
successMetric
 successMetric string
指令
 instruction string
instructionReverse
 instructionReverse string
exerciseKnowledgeBase
 exerciseKnowledgeBase string
topicKnowledgeBase
 topicKnowledgeBase string

TopicListResponse

名称 路径 类型 说明
items
 items array of TopicDto

LessonDetailDto

名称 路径 类型 说明
id
 id uuid
learningByteId
 learningByteId uuid
内容
 content string
ordinalNumber
 ordinalNumber integer
源
 source string
createdAt
 createdAt date-time
updatedAt
 updatedAt date-time
介质
 media array of MediaLinkDto
问题
 questions array of QuestionDto

MediaLinkDto

名称 路径 类型 说明
id
 id uuid
fileId
 fileId uuid
ordinalNumber
 ordinalNumber integer
源
 source string

ExpertDetailDto

名称 路径 类型 说明
id
 id uuid
名字
 name string
描述
 description string
状态
 status string
linkedDocumentCount
 linkedDocumentCount integer
createdAt
 createdAt date-time
updatedAt
 updatedAt date-time
assignedRoleIds
 assignedRoleIds array of uuid
assignedDepartmentIds
 assignedDepartmentIds array of uuid
linkedDocuments
 linkedDocuments array of LinkedDocumentDto

LinkedDocumentDto

名称 路径 类型 说明
id
 id uuid
名字
 name string
扩展
 extension string
sizeBytes
 sizeBytes integer
描述
 description string
linkedAt
 linkedAt date-time

AskResponse

名称 路径 类型 说明
答案
 answer string
durationMs
 durationMs integer

DepartmentDto

名称 路径 类型 说明
id
 id uuid
名字
 name string
描述
 description string
状态
 status string
createdAt
 createdAt date-time
roles
 roles array of DepartmentRoleDto

DemoTrainingDto

名称 路径 类型 说明
id
 id uuid
companyId
 companyId uuid
departmentId
 departmentId uuid
名字
 name string
描述
 description string
trainingType
 trainingType string
状态
 status string
是否可用
 isAvailable boolean
videoFileId
 videoFileId uuid
processingPrompt
 processingPrompt string
errorMessage
 errorMessage string
assignedRoleIds
 assignedRoleIds array of uuid
segments
 segments array of DemoTrainingSegmentDto
createdAt
 createdAt date-time
updatedAt
 updatedAt date-time

DemoTrainingSegmentDto

名称 路径 类型 说明
id
 id uuid
ordinalNumber
 ordinalNumber integer
名字
 name string
脚本
 transcript string
持续时间秒
 durationSeconds integer

CourseDetailDto

名称 路径 类型 说明
id
 id uuid
名字
 name string
状态
 status string
moduleCount
 moduleCount integer
topicCount
 topicCount integer
hasUnpublishedChanges
 hasUnpublishedChanges boolean
currentVersionNumber
 currentVersionNumber integer
createdAt
 createdAt date-time
updatedAt
 updatedAt date-time
assignedRoleIds
 assignedRoleIds array of uuid
assignedDepartmentIds
 assignedDepartmentIds array of uuid
modules
 modules array of ModuleSummaryDto

ModuleSummaryDto

名称 路径 类型 说明
id
 id uuid
名字
 name string
ordinalNumber
 ordinalNumber integer
topicCount
 topicCount integer

GenerationRequestResponse

名称 路径 类型 说明
id
 id uuid
状态
 status string

ModuleDto

名称 路径 类型 说明
id
 id uuid
courseId
 courseId uuid
名字
 name string
描述
 description string
productId
 productId uuid
ordinalNumber
 ordinalNumber integer
lockedForGeneration
 lockedForGeneration boolean
topicCount
 topicCount integer
quizSettings
 quizSettings array of QuizSettingDto

ModuleListResponse

名称 路径 类型 说明
items
 items array of ModuleDto

GenerateCourseResponse

名称 路径 类型 说明
courseId
 courseId uuid
generationRequestId
 generationRequestId uuid

PageInfo

名称 路径 类型 说明
size
 size integer
number
 number integer
totalElements
 totalElements integer
总页数
 totalPages integer

UserListResponse

名称 路径 类型 说明
items
 items array of UserDto
页面
 page PageInfo

TopicLinkedDocumentDto

名称 路径 类型 说明
id
 id uuid
名字
 name string
扩展
 extension string
size
 size integer
processingStatus
 processingStatus string
描述
 description string
源
 source string
linkType
 linkType string
linkedAt
 linkedAt date-time

TopicLinkedDocumentListResponse

名称 路径 类型 说明
items
 items array of TopicLinkedDocumentDto
页面
 page PageInfo

LearningByteDto

名称 路径 类型 说明
id
 id uuid
topicId
 topicId uuid
名字
 name string
描述
 description string
ordinalNumber
 ordinalNumber integer
源
 source string
lessonCount
 lessonCount integer
createdAt
 createdAt date-time
updatedAt
 updatedAt date-time

LearningByteListResponse

名称 路径 类型 说明
items
 items array of LearningByteDto

ExerciseListResponse

名称 路径 类型 说明
items
 items array of ExerciseDto

CertificateDto

名称 路径 类型 说明
id
 id uuid
enrollmentId
 enrollmentId uuid
studentId
 studentId uuid
companyId
 companyId uuid
courseId
 courseId uuid
courseVersionId
 courseVersionId uuid
studentName
 studentName string
companyName
 companyName string
courseName
 courseName string
serialNumber
 serialNumber string
completedAt
 completedAt date-time
发布时间
 issuedAt date-time
pdfFileId
 pdfFileId uuid
pdfAvailable
 pdfAvailable boolean

CertificateListResponse

名称 路径 类型 说明
items
 items array of CertificateDto

MediaDto

名称 路径 类型 说明
id
 id uuid
名字
 name string
描述
 description string
kind
 kind string
MIME类型
 mimeType string
sizeBytes
 sizeBytes integer
状态
 status string
processingStatus
 processingStatus string
createdAt
 createdAt date-time
uploadedBy
 uploadedBy UploadedByDto

MediaListResponse

名称 路径 类型 说明
items
 items array of MediaDto
页面
 page PageInfo

LessonListResponse

名称 路径 类型 说明
items
 items array of LessonDto

CourseBreakdownDto

名称 路径 类型 说明
courseId
 courseId uuid
courseName
 courseName string
progressPercent
 progressPercent integer
hoursSpent
 hoursSpent double
startedAt
 startedAt date-time
completedAt
 completedAt date-time

StudentInsightsDto

名称 路径 类型 说明
userId
 userId uuid
窗口
 window WindowDto
摘要
 summary StudentSummaryDto
byCourse
 byCourse array of CourseBreakdownDto

StudentSummaryDto

名称 路径 类型 说明
activeDays
 activeDays integer
lessonsCompleted
 lessonsCompleted integer
exercisesCompleted
 exercisesCompleted integer
quizzesPassed
 quizzesPassed integer
hoursSpent
 hoursSpent double

WindowDto

名称 路径 类型 说明
kind
 kind string
从
 from date-time
to
 to date-time

EventItemDto

名称 路径 类型 说明
id
 id uuid
kind
 kind string
操作
 action string
courseId
 courseId uuid
courseName
 courseName string
occurredAt
 occurredAt date-time

EventListResponse

名称 路径 类型 说明
items
 items array of EventItemDto
页面
 page PageInfo

CompanyInsightsDto

名称 路径 类型 说明
companyId
 companyId uuid
摘要
 summary CompanySummaryDto

CompanySummaryDto

名称 路径 类型 说明
totalStudents
 totalStudents integer
averageProgressPercent
 averageProgressPercent integer
activeThisWeekCount
 activeThisWeekCount integer
completedCount
 completedCount integer
completionRatePercent
 completionRatePercent integer

ExpertDto

名称 路径 类型 说明
id
 id uuid
名字
 name string
描述
 description string
状态
 status string
linkedDocumentCount
 linkedDocumentCount integer
createdAt
 createdAt date-time
updatedAt
 updatedAt date-time

ExpertListResponse

名称 路径 类型 说明
items
 items array of ExpertDto
页面
 page PageInfo

DocumentDto

名称 路径 类型 说明
id
 id uuid
名字
 name string
描述
 description string
MIME类型
 mimeType string
sizeBytes
 sizeBytes integer
状态
 status string
createdAt
 createdAt date-time
uploadedBy
 uploadedBy UploadedByDto

DocumentListResponse

名称 路径 类型 说明
items
 items array of DocumentDto
页面
 page PageInfo

DepartmentListResponse

名称 路径 类型 说明
items
 items array of DepartmentDto

DemoTrainingListItemDto

名称 路径 类型 说明
id
 id uuid
departmentId
 departmentId uuid
videoFileId
 videoFileId uuid
名字
 name string
描述
 description string
trainingType
 trainingType string
状态
 status string
是否可用
 isAvailable boolean
assignedRoleIds
 assignedRoleIds array of uuid
segmentCount
 segmentCount integer
持续时间秒
 durationSeconds integer
createdAt
 createdAt date-time

DemoTrainingListResponse

名称 路径 类型 说明
items
 items array of DemoTrainingListItemDto
页面
 page PageInfo

CourseDto

名称 路径 类型 说明
id
 id uuid
名字
 name string
状态
 status string
moduleCount
 moduleCount integer
topicCount
 topicCount integer
hasUnpublishedChanges
 hasUnpublishedChanges boolean
currentVersionNumber
 currentVersionNumber integer
latestPublishedAt
 latestPublishedAt date-time
createdAt
 createdAt date-time

CourseListResponse

名称 路径 类型 说明
items
 items array of CourseDto
页面
 page PageInfo

GenerationProgressDto

名称 路径 类型 说明
totalTasks
 totalTasks integer
completedTasks
 completedTasks integer
failedTasks
 failedTasks integer

GenerationRequestInfoDto

名称 路径 类型 说明
id
 id uuid
状态
 status string
createdAt
 createdAt string
completedAt
 completedAt string
错误
 error string
progress
 progress GenerationProgressDto
目标
 target string
targetId
 targetId uuid
父类型
 parentType string
topicIds
 topicIds array of uuid
moduleIds
 moduleIds array of uuid

GenerationStatusResponse

名称 路径 类型 说明
activeRequests
 activeRequests array of GenerationRequestInfoDto

CourseVersionDto

名称 路径 类型 说明
id
 id uuid
courseId
 courseId uuid
versionNumber
 versionNumber integer
publishedAt
 publishedAt date-time
publishedBy
 publishedBy uuid
moduleCount
 moduleCount integer
topicCount
 topicCount integer
lessonCount
 lessonCount integer
exerciseCount
 exerciseCount integer
questionCount
 questionCount integer
estimatedTimeSeconds
 estimatedTimeSeconds integer

CourseVersionListResponse

名称 路径 类型 说明
items
 items array of CourseVersionDto

AuditSnapshot

名称 路径 类型 说明
createdAt
 createdAt date-time
createdBy
 createdBy uuid
updatedAt
 updatedAt date-time
updatedBy （更新者）
 updatedBy uuid

CourseSnapshot

名称 路径 类型 说明
名字
 name string
coverImageId
 coverImageId uuid
prerequisiteCourseId
 prerequisiteCourseId uuid
courseGuideline
 courseGuideline string
lessonsGuideline
 lessonsGuideline string
questionsGuideline
 questionsGuideline string
exercisesGuideline
 exercisesGuideline string
modules
 modules array of ModuleSnapshot

CourseVersionSnapshotDto

名称 路径 类型 说明
id
 id uuid
courseId
 courseId uuid
versionNumber
 versionNumber integer
快照
 snapshot CourseSnapshot

ExerciseSnapshot

名称 路径 类型 说明
id
 id uuid
topicId
 topicId uuid
exerciseType
 exerciseType string
提示
 prompt string
ordinalNumber
 ordinalNumber integer
isGenerated
 isGenerated boolean
源
 source string
审核
 audit AuditSnapshot
avatarCharacteristics
 avatarCharacteristics string
avatarPictureId
 avatarPictureId uuid
reverseRolePlayEnabled
 reverseRolePlayEnabled boolean
reverseRolePlayMandatory
 reverseRolePlayMandatory boolean
方案
 scenario string
traineeRole
 traineeRole string
avatarName
 avatarName string
avatarDescription
 avatarDescription string
operationalChallenge
 operationalChallenge string
successMetric
 successMetric string
指令
 instruction string
instructionReverse
 instructionReverse string
exerciseKnowledgeBase
 exerciseKnowledgeBase string

LearningByteSnapshot

名称 路径 类型 说明
id
 id uuid
topicId
 topicId uuid
名字
 name string
描述
 description string
ordinalNumber
 ordinalNumber integer
源
 source string
审核
 audit AuditSnapshot
课程
 lessons array of LessonSnapshot

LessonSnapshot

名称 路径 类型 说明
id
 id uuid
learningByteId
 learningByteId uuid
内容
 content string
ordinalNumber
 ordinalNumber integer
源
 source string
审核
 audit AuditSnapshot
介质
 media array of MediaSnapshot
问题
 questions array of QuestionSnapshot

LinkedDocumentSnapshot

名称 路径 类型 说明
id
 id uuid
fileId
 fileId uuid
linkType
 linkType string
isSupplement
 isSupplement boolean
名字
 name string
扩展
 extension string
size
 size integer
描述
 description string

MediaSnapshot

名称 路径 类型 说明
id
 id uuid
fileId
 fileId uuid
ordinalNumber
 ordinalNumber integer
mediaType
 mediaType string
源
 source string

ModuleSnapshot

名称 路径 类型 说明
id
 id uuid
courseId
 courseId uuid
productId
 productId uuid
名字
 name string
描述
 description string
介绍
 intro string
ordinalNumber
 ordinalNumber integer
quizSettings
 quizSettings array of QuizSettingSnapshot
quizQuestions
 quizQuestions array of QuestionSnapshot
topics
 topics array of TopicSnapshot

OptionSnapshot

名称 路径 类型 说明
id
 id uuid
optionText
 optionText string
isCorrect
 isCorrect boolean
ordinalNumber
 ordinalNumber integer

QuestionSnapshot

名称 路径 类型 说明
id
 id uuid
questionType
 questionType string
questionText
 questionText string
expectedAnswer
 expectedAnswer string
ordinalNumber
 ordinalNumber integer
源
 source string
审核
 audit AuditSnapshot
选项
 options array of OptionSnapshot

QuizSettingSnapshot

名称 路径 类型 说明
questionType
 questionType string
计数
 count integer

TopicSnapshot

名称 路径 类型 说明
id
 id uuid
moduleId
 moduleId uuid
名字
 name string
描述
 description string
介绍
 intro string
ordinalNumber
 ordinalNumber integer
quizSettings
 quizSettings array of QuizSettingSnapshot
quizQuestions
 quizQuestions array of QuestionSnapshot
learningBytes
 learningBytes array of LearningByteSnapshot
练习
 exercises array of ExerciseSnapshot
linkedDocuments
 linkedDocuments array of LinkedDocumentSnapshot
topicKnowledgeBase
 topicKnowledgeBase string

StreamingResponseBody