時光機（預覽）

Time Machine 是一個由 AI 驅動的企業學習平台。它將公司文件、影片和專家知識轉化為結構化課程，包含模組、主題、測驗和角色扮演練習，並追蹤學習者的進度。專為大規模入職、培訓及認證員工的人力資源與學習與發展團隊打造。連接器自動化整個學習生命週期：管理課程、使用者、部門與角色;從文件產生測驗;並閱讀完成分析。

此連接器適用於以下產品和區域：

Service	Class	Regions
Copilot Studio	進階	除以下部分外，所有Power Automate區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
邏輯應用程式	標準	所有 Logic Apps 區域，但下列區域除外： - Azure Government regions - Azure中國地區 - 美國國防部（DoD）
Power Apps	進階	除以下部分外，所有Power Apps區域 - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
Power Automate（自動化服務）	進階	除以下部分外，所有Power Automate區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）

聯絡方式
名稱	時光機支援
URL	https://timeml.ai

連接器中繼資料
發行者	時光機人工智慧
網站	https://timeml.ai
隱私策略	https://timeml.ai/privacy-policy
類別	生產力;人工智慧

Time Machine — Power Automate 連接器

什麼是時間機器

Time Machine 是一個由 AI 驅動的組織學習平台，協助企業建立、營運並持續改進現代團隊所需的自適應學習系統。組織利用 Time Machine 將現有知識、文件、錄音與工作流程轉化為可擴展的培訓體驗，加速新員工入職、提升員工準備度，並在組織內複製頂尖專業技術。

租戶管理員透過 Time Machine REST API 管理使用者、學習內容、組織資源及平台設定。此連接器將公開的 REST API 以 Power Automate 動作形式揭露，讓您能自動化使用者配置、內容擷取、知識同步及生命週期管理，而無需撰寫程式碼。

Prerequisites

一個具有管理員權限的活躍 Time Machine 租戶
一組時間機器 API 金鑰，從管理面板https://web.timeml.ai的設定→ API 金鑰（）中發出。鍵值以開頭 tm_live_。

Authentication

每個動作都用標頭中的 Authorization API 金鑰進行驗證。在 Power Automate 建立連線時：

欄位：API key
值：貼上 Bearer tm_live_<your-token> （完整字串，包含 Bearer 前綴及標記前的空格）

可用的動作

這個連接器是 Time Machine 公共 REST API（116 個端點）的鏡像。行動依資源分組：

課程 — 列出/建立/更新/刪除/發布課程，分配角色，生成 AI 撰寫的內容
使用者 — 列出/建立/更新/停用/重新啟用使用者
文件 — 列出/上傳/更新/刪除文件
媒體 — 列出/上傳/更新/刪除媒體項目
部門 — 列出 /建立/更新/刪除部門、管理角色、指派使用者角色
專家 — 列出/建立專家檔案、向專家提問、指派文件與角色
示範訓練 — 列出/建立/更新/刪除示範訓練
課程內容 — 模組、主題、課程、練習、測驗題目
洞察 — 按學生、按課程及公司層級分析
證書 — 列出 學生證書，下載 PDF 證書

完整終點參考資料可於 https://api.timeml.ai/api/v1/docs。

工作流程範例

Confluence 版本 → Time Machine 版本：當 Confluence 發布版本頁面時，將其上傳為 Time Machine 文件，使其流入學習位元庫。
人力資源入職流程：當您的 HRIS 中出現新員工列時，建立一個 Time Machine 使用者，並列出他們的部門與角色分配，觸發魔法連結邀請。
課程完成通知：學生完成課程後，請將證書 PDF 傳送至 Slack，並記錄在 Google 試算表。

已知的限制

API 金鑰輪換：當 API 金鑰被輪換時，連線必須手動更新。沒有自動刷新機制。
多階段上傳：檔案上傳操作（上傳文件、上傳媒體）可接受最高 50 MB 的檔案。對於較大的媒體，請分成多個上傳，或聯絡 Time Machine 客服。
批次操作：API 一次只處理一個記錄。對於批量操作，請使用 Power Automate 內建的「套用到每個控制項」。

Support

如對接頭有任何疑問或問題，請聯絡你的 Time Machine 帳號團隊或寄信至 support@timeml.ai。

正在建立連線

連接器支援下列驗證類型：


預設值	建立連線的參數。	所有地區	不可共享

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

名稱	類型	Description	Required
Time Machine API 金鑰（格式：Bearer tm_live_...）	安全字串	此 API 的 Time Machine API 金鑰（格式：Bearer tm_live_...）	沒錯

動作

上傳媒體項目	多部分上傳（檔案+可選描述）。圖片最多 50MB，影片 500MB。
上傳文件	多部分上傳（檔案+可選描述）。最多 50MB。
下載證書 PDF	可串流證書PDF。如果證明還沒有 PDF，請回 404
主題的清單測驗題目	返回與指定主題相關的小考題目。
以學習位元組列出課程	回傳屬於該學習位元組的課程內容。
做個運動	申報表執行該身分證的詳細資料。
停用使用者	冪固位 — 即使使用者已被停用，也會返回
先有個主題介紹	回傳該主題的開頭文字集合。
公司層級洞察	來電者公司的主要關鍵績效指標（KPI）
列出主題中的學習位元組	回傳屬於該主題的學習位元組。
列出主題中的練習題	混合型態（ILE_TEXT / RPE_VOICE / RPE_VIDEO）依序數排序
列出使用者	來電者公司用戶分頁列表
列出學生的證書	該學生在來電者公司內獲得的回傳證書
列出文件	來電者公司文件分頁列表
列出與主題相關的文件	頁碼;可選擇性以文件名稱搜尋
列出課堂題目	返回與課程相關的知識檢查題目。
列出課程中的模組	回傳依序數排序的活躍模組
列表媒體	來電者公司媒體項目分頁列表
列表課程版本	回傳已發佈版本的元資料（計數 + 發佈資訊），依版本號排序
刪除一個主題的小考題目	冪등 — 即使已移除，也有204
刪除主題（軟性）	冪등 — 即使主題已被移除，仍回傳 204
刪除學習位元組（軟式）	冪등 — 即使已移除，也有204
刪除模組中的一個小考題目	冪등 — 即使已移除，也有204
刪除模組（軟體）	冪能 — 即使模組已被移除，仍返回 204
刪除示範訓練	冪能 — 即使示範訓練不存在或已消失，也會回傳 204
刪除練習	冪등 — 即使已移除，也有204
刪除課堂問題	冪등 — 即使已移除，也有204
刪除課程（軟）	冪등 — 即使已移除，也有204
刪除（停用）一個部門	冪能——即使已停用，也會回傳204。角色分配如瀑布般分配。
刪除（停用）媒體項目	冪등 — 即使項目已被刪除或遺失，仍回傳 204
刪除（停用）文件	冪등 — 即使文件已被刪除或遺失，仍回傳 204
刪除（軟處理）賽道	冪等等 — 即使該課程已被移除，仍返回 204
去上課吧	回傳課程內容、媒體及課中問題
去做示範訓練	回傳完整的示範訓練與片段
取得使用者	回傳使用者元資料及部門/角色分配
取得媒體物品	回傳媒體元資料及短暫簽署的下載網址
取得學習位元組	回傳元資料與巢狀課程
取得文件	回傳文件元資料及短暫簽署的下載網址
取得模組介紹	回傳給定模組的開頭文字集。
取得課程	回傳課程中繼資料，包含模組摘要及分配的角色/部門
取得課程版本快照	回傳給定版本的完整內容樹（模組、主題、課程、練習、問題）
取得課程的 AI 生成狀態	回傳課程中進行中的 AI 生成請求清單，並附有進度與目標資訊
取消指派使用者的角色	冪能 — 即使未被指定 204
向專家提問	同步包裝器繞過串流 AI 聊天。回傳組合好的答案。
在主題中加入學習字節	在給定主題中建立新的學習位元組。
在主題中加入小考題	在指定主題內新增一個小考題目。
在學習位元中加入一堂課	在給定的學習位元組內創造一個新的課程內容。
在模組中加入小考題目	在指定模組內建立新的測驗題目。
在模組中選擇一題小考題	回傳一個附帶於該模組的小考題目。
在部門內建立一個角色	建立一個針對該部門的新角色。
學生可使用次數切換	設定示範訓練是否公開給學生。自尊。
將一份文件從主題中解連結	冪等
將主題移到其他模組	targetOrdinalNumber 為可選;若省略，主題會附加於目標模組
將文件指派給專家	將文件批量連結給專家。自尊。
將文件連結到主題	附加性 — 已連結的文件會被跳過
將角色分配給專家	加法性——已分配的角色會被保留;新增的。回報更新專家
專家名單	來電者公司專家分頁列表
建立一個空的課程	建立一個帶有原名的新課程殼
建立使用者	建立使用者並觸發魔法連結邀請流程
建立示範訓練	從先前上傳的影片檔案建立示範訓練，並開始處理
從課程中移除一個角色分配	冪等
成立一個部門	在來電者公司中新增一個部門。
找個主題	回傳給定ID的主題細節。
找專家	回傳專家元資料、連結文件及分配的角色/部門
拿一個課堂題	會以 ID 回傳一個課堂題目。
指派使用者角色	冪等
新增模組到	在該課程內建立一個新模組。
新增課堂問題	類型必須是MULTIPLE_CHOICE（需要選項）或OPEN_ENDED
更新一個主題的小考題目	提供與儲存型別相符的欄位;不相關領域則被忽略。
更新一個模組的小考題	提供與儲存型別相符的欄位;不相關領域則被忽略。
更新主題元資料	更新名稱和/或描述。省略欄位保留當前值
更新使用者	更新名字、姓氏、isAdmin 和角色分配。在 v1 中，電子郵件是無法編輯的。
更新媒體元資料	更新名稱和/或說明
更新學習位元組元資料	省略欄位保留當前值
更新文件元資料	更新名稱和/或說明
更新模組元資料	更新名稱和/或描述。省略欄位保留當前值
更新示範訓練	部分更新。只通過你想改變的欄位。 assignedRoleIds 會取代目前的集合。
更新練習	類型感知：ILE_TEXT 僅使用 prompt + generatedContent.scenario;RPE_* 使用所有 RPE 欄位。省略欄位保留當前值。
更新課堂問題	提供與儲存型別相符的欄位;忽略無關欄位
更新課程元資料	更新課程名稱
更新課程內容	省略內容可保留當前價值
更新部門	更新名稱和/或說明
替換媒體二進位	替換現有媒體項目的檔案二進位;元資料會被保留
替換文件二進位	取代現有文件的檔案二進位;元資料會被保留
模組中的主題列表	回傳依序數排序的活躍主題
模組中的小考題目列表	返回與所給模組相關的測驗題目。
模組中的小考題目重新排序	questionIds 必須包含該模組中所有正在進行的測驗題目，並依新順序排列。
模組內的主題重排序	topicIds 必須以新順序，精確包含每個活躍主題一次
每位學生的活動活動	分頁的僅向前事件串流
每位學生的見解	該時段的彙整摘要與各課程分布
清單示範訓練	分頁清單依照來電者公司範圍
為一種題型設定主題測驗次數	替換給定問題類型（MULTIPLE_CHOICE 或 OPEN_ENDED）的計數。其他類型的數量則被保留
為一種題型設定模組測驗數量	替換給定問題類型（MULTIPLE_CHOICE 或 OPEN_ENDED）的計數。其他類型的數量則被保留
為主題加入ILE_TEXT練習	在指定主題內建立新的ILE_TEXT練習。
為主題加入RPE_VIDEO練習題	在指定主題內建立新的RPE_VIDEO角色扮演練習。
為主題加入RPE_VOICE練習題	在指定主題內創建新的RPE_VOICE角色扮演練習。
為模組新增主題	在給定模組內建立一個新主題。
為課程指派角色	附加性——已分配的角色會被跳過。返回更新後的課程細節
生成包含 AI 內容的完整課程	建立課程外殼、所有模組、所有主題，並為每個主題加入 AI 內容生成
發佈課程	出版課程;如果沒有可發表的內容，則在400分中失敗
省份列表	來電者公司內所有有巢狀角色的部門
移除主題引言	冪位 — 即使沒有設定引言，也要204
移除專家的一項角色分配	冪等
移除專家的所有角色分配	冪等
移除模組介紹	冪位 — 即使沒有設定引言，也要204
移除課程中所有角色分配	冪等
解除專家的文件指派	冪等
觸發 AI 主題內容生成	為課程中指定主題的 AI 內容生成進行排隊
設定或替換主題引言	Upsert — 若缺則創建，若有則替換
設定或替換模組開場	Upsert — 若缺則創建，若有則替換
課中問題重新排序	questionIds 必須包含該課程中所有活躍的問題，且以新順序呈現
課程中的模組重排序	moduleId 必須在新順序中恰好包含每個活躍模組一次
課程列表	來電者公司課程分頁列表
證書細節	將一份指定範圍的證書回傳給來電者公司
買模組	回報該 ID 的模組細節。
透過 AI 重新生成特定物品	重建單一課程、課程問題、測驗、入門或練習
重播影像處理	重新提交影片進行 AI 分割。可選擇覆蓋處理提示。
重新啟用使用者	冪固態 — 即使使用者已啟動，也會回傳
重新排序某主題的小考題目	questionIds 必須以新順序包含該主題的所有活動測驗題目。
針對某個主題，做一題小考題	回傳一個與該主題相關的小測題目。

上傳媒體項目

作業識別碼：: uploadMedia

多部分上傳（檔案+可選描述）。圖片最多 50MB，影片 500MB。

參數

名稱	機碼	必要	類型	Description
檔案	file	True	file	檔案
Description	description		string	Description

傳回

身體: MediaDetailDto

上傳文件

作業識別碼：: uploadDocument

多部分上傳（檔案+可選描述）。最多 50MB。

參數

名稱	機碼	必要	類型	Description
檔案	file	True	file	檔案
Description	description		string	Description

傳回

身體: DocumentDetailDto

下載證書 PDF

作業識別碼：: downloadCertificatePdf

可串流證書PDF。如果證明還沒有 PDF，請回 404

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id

傳回

response: StreamingResponseBody

主題的清單測驗題目

作業識別碼：: listTopicQuizQuestions

返回與指定主題相關的小考題目。

參數

名稱	機碼	必要	類型	Description
主題編號	topicId	True	uuid	主題編號

傳回

身體: QuestionListResponse

以學習位元組列出課程

作業識別碼：: listLessonsInLearningByte

回傳屬於該學習位元組的課程內容。

參數

名稱	機碼	必要	類型	Description
Lb Id	lbId	True	uuid	Lb Id

傳回

身體: LessonListResponse

做個運動

作業識別碼：: getExercise

申報表執行該身分證的詳細資料。

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id

傳回

身體: ExerciseDto

停用使用者

作業識別碼：: deactivateUser

冪固位 — 即使使用者已被停用，也會返回

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id

傳回

身體: UserDto

先有個主題介紹

作業識別碼：: getTopicIntro

回傳該主題的開頭文字集合。

參數

名稱	機碼	必要	類型	Description
主題編號	topicId	True	uuid	主題編號

傳回

身體: IntroDto

公司層級洞察

作業識別碼：: getCompanyInsights

來電者公司的主要關鍵績效指標（KPI）

傳回

身體: CompanyInsightsDto

列出主題中的學習位元組

作業識別碼：: listLearningBytesInTopic

回傳屬於該主題的學習位元組。

參數

名稱	機碼	必要	類型	Description
主題編號	topicId	True	uuid	主題編號

傳回

身體: LearningByteListResponse

列出主題中的練習題

作業識別碼：: listExercisesInTopic

混合型態（ILE_TEXT / RPE_VOICE / RPE_VIDEO）依序數排序

參數

名稱	機碼	必要	類型	Description
主題編號	topicId	True	uuid	主題編號

傳回

身體: ExerciseListResponse

列出使用者

作業識別碼：: listUsers

來電者公司用戶分頁列表

參數

名稱	機碼	類型	Description
頁面	page	integer	頁面
Size	size	integer	Size
搜尋	search	string	搜尋
Status	status	string	Status
部門識別	departmentIds	string	部門識別
角色識別碼	roleIds	string	角色識別碼
種類	kind	string	種類

傳回

身體: UserListResponse

列出學生的證書

作業識別碼：: listStudentCertificates

該學生在來電者公司內獲得的回傳證書

參數

名稱	機碼	必要	類型	Description
使用者 ID	userId	True	uuid	使用者 ID

傳回

身體: CertificateListResponse

列出文件

作業識別碼：: listDocuments

來電者公司文件分頁列表

參數

名稱	機碼	類型	Description
頁面	page	integer	頁面
Size	size	integer	Size
搜尋	search	string	搜尋
默劇類型	mimeTypes	string	默劇類型
Status	status	string	Status

傳回

身體: DocumentListResponse

列出與主題相關的文件

作業識別碼：: listTopicLinkedDocuments

頁碼;可選擇性以文件名稱搜尋

參數

名稱	機碼	必要	類型	Description
主題編號	topicId	True	uuid	主題編號
頁面	page		integer	頁面
Size	size		integer	Size
搜尋	search		string	搜尋

傳回

身體: TopicLinkedDocumentListResponse

列出課堂題目

作業識別碼：: listLessonQuestions

返回與課程相關的知識檢查題目。

參數

名稱	機碼	必要	類型	Description
課程第一	lessonId	True	uuid	課程第一

傳回

身體: QuestionListResponse

列出課程中的模組

作業識別碼：: listModulesInCourse

回傳依序數排序的活躍模組

參數

名稱	機碼	必要	類型	Description
課程標識碼	courseId	True	uuid	課程標識碼

傳回

身體: ModuleListResponse

列表媒體

作業識別碼：: listMedia

來電者公司媒體項目分頁列表

參數

名稱	機碼	類型	Description
頁面	page	integer	頁面
Size	size	integer	Size
搜尋	search	string	搜尋
種類	kind	string	種類
Status	status	string	Status

傳回

身體: MediaListResponse

列表課程版本

作業識別碼：: listCourseVersions

回傳已發佈版本的元資料（計數 + 發佈資訊），依版本號排序

參數

名稱	機碼	必要	類型	Description
課程標識碼	courseId	True	uuid	課程標識碼

傳回

身體: CourseVersionListResponse

刪除一個主題的小考題目

作業識別碼：: deleteTopicQuizQuestion

冪등 — 即使已移除，也有204

參數

名稱	機碼	必要	類型	Description
主題編號	topicId	True	uuid	主題編號
問題編號	questionId	True	uuid	問題編號

刪除主題（軟性）

作業識別碼：: deleteTopic

冪등 — 即使主題已被移除，仍回傳 204

參數

名稱	機碼	必要	類型	Description
主題編號	topicId	True	uuid	主題編號

刪除學習位元組（軟式）

作業識別碼：: deleteLearningByte

冪등 — 即使已移除，也有204

參數

名稱	機碼	必要	類型	Description
Lb Id	lbId	True	uuid	Lb Id

刪除模組中的一個小考題目

作業識別碼：: deleteModuleQuizQuestion

冪등 — 即使已移除，也有204

參數

名稱	機碼	必要	類型	Description
課程模組識別碼	moduleId	True	uuid	課程模組識別碼
問題編號	questionId	True	uuid	問題編號

刪除模組（軟體）

作業識別碼：: deleteModule

冪能 — 即使模組已被移除，仍返回 204

參數

名稱	機碼	必要	類型	Description
課程模組識別碼	moduleId	True	uuid	課程模組識別碼

刪除示範訓練

作業識別碼：: deleteDemoTraining

冪能 — 即使示範訓練不存在或已消失，也會回傳 204

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id

刪除練習

作業識別碼：: deleteExercise

冪등 — 即使已移除，也有204

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id

刪除課堂問題

作業識別碼：: deleteLessonQuestion

冪등 — 即使已移除，也有204

參數

名稱	機碼	必要	類型	Description
課程第一	lessonId	True	uuid	課程第一
問題編號	questionId	True	uuid	問題編號

刪除課程（軟）

作業識別碼：: deleteLesson

冪등 — 即使已移除，也有204

參數

名稱	機碼	必要	類型	Description
課程第一	lessonId	True	uuid	課程第一

刪除（停用）一個部門

作業識別碼：: deleteDepartment

冪能——即使已停用，也會回傳204。角色分配如瀑布般分配。

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id

刪除（停用）媒體項目

作業識別碼：: deleteMedia

冪등 — 即使項目已被刪除或遺失，仍回傳 204

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id

刪除（停用）文件

作業識別碼：: deleteDocument

冪등 — 即使文件已被刪除或遺失，仍回傳 204

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id

刪除（軟處理）賽道

作業識別碼：: deleteCourse

冪等等 — 即使該課程已被移除，仍返回 204

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id

去上課吧

作業識別碼：: getLesson

回傳課程內容、媒體及課中問題

參數

名稱	機碼	必要	類型	Description
課程第一	lessonId	True	uuid	課程第一

傳回

身體: LessonDetailDto

去做示範訓練

作業識別碼：: getDemoTraining

回傳完整的示範訓練與片段

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id

傳回

身體: DemoTrainingDto

取得使用者

作業識別碼：: getUser

回傳使用者元資料及部門/角色分配

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id

傳回

身體: UserDto

取得媒體物品

作業識別碼：: getMediaItem

回傳媒體元資料及短暫簽署的下載網址

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id

傳回

身體: MediaDetailDto

取得學習位元組

作業識別碼：: getLearningByte

回傳元資料與巢狀課程

參數

名稱	機碼	必要	類型	Description
Lb Id	lbId	True	uuid	Lb Id

傳回

身體: LearningByteDetailDto

取得文件

作業識別碼：: getDocument

回傳文件元資料及短暫簽署的下載網址

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id

傳回

身體: DocumentDetailDto

取得模組介紹

作業識別碼：: getModuleIntro

回傳給定模組的開頭文字集。

參數

名稱	機碼	必要	類型	Description
課程模組識別碼	moduleId	True	uuid	課程模組識別碼

傳回

身體: IntroDto

取得課程

作業識別碼：: getCourse

回傳課程中繼資料，包含模組摘要及分配的角色/部門

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id

傳回

身體: CourseDetailDto

取得課程版本快照

作業識別碼：: getCourseVersion

回傳給定版本的完整內容樹（模組、主題、課程、練習、問題）

參數

名稱	機碼	必要	類型	Description
課程標識碼	courseId	True	uuid	課程標識碼
版本號碼	versionNumber	True	integer	版本號碼

傳回

身體: CourseVersionSnapshotDto

取得課程的 AI 生成狀態

作業識別碼：: getCourseGenerationStatus

回傳課程中進行中的 AI 生成請求清單，並附有進度與目標資訊

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id

傳回

身體: GenerationStatusResponse

取消指派使用者的角色

作業識別碼：: unassignUserFromRole

冪能 — 即使未被指定 204

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id
角色識別碼	roleId	True	uuid	角色識別碼
使用者 ID	userId	True	uuid	使用者 ID

向專家提問

作業識別碼：: askExpert

同步包裝器繞過串流 AI 聊天。回傳組合好的答案。

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id
問題	question	True	string

傳回

身體: AskResponse

在主題中加入學習字節

作業識別碼：: addLearningByteToTopic

在給定主題中建立新的學習位元組。

參數

名稱	機碼	必要	類型	Description
主題編號	topicId	True	uuid	主題編號
名字	name	True	string
描述	description		string

傳回

身體: LearningByteDetailDto

在主題中加入小考題

作業識別碼：: addTopicQuizQuestion

在指定主題內新增一個小考題目。

參數

名稱	機碼	必要	類型	Description
主題編號	topicId	True	uuid	主題編號
型別	type	True	string
收發簡訊	text	True	string
序數	ordinalNumber		integer
收發簡訊	text	True	string
是正確的	isCorrect		boolean
預期答案	expectedAnswer		string

傳回

身體: QuestionDto

在學習位元中加入一堂課

作業識別碼：: addLessonToLearningByte

在給定的學習位元組內創造一個新的課程內容。

參數

名稱	機碼	必要	類型	Description
Lb Id	lbId	True	uuid	Lb Id
內容	content	True	string

傳回

身體: LessonDetailDto

在模組中加入小考題目

作業識別碼：: addModuleQuizQuestion

在指定模組內建立新的測驗題目。

參數

名稱	機碼	必要	類型	Description
課程模組識別碼	moduleId	True	uuid	課程模組識別碼
型別	type	True	string
收發簡訊	text	True	string
序數	ordinalNumber		integer
收發簡訊	text	True	string
是正確的	isCorrect		boolean
預期答案	expectedAnswer		string

傳回

身體: QuestionDto

在模組中選擇一題小考題

作業識別碼：: getModuleQuizQuestion

回傳一個附帶於該模組的小考題目。

參數

名稱	機碼	必要	類型	Description
課程模組識別碼	moduleId	True	uuid	課程模組識別碼
問題編號	questionId	True	uuid	問題編號

傳回

身體: QuestionDto

在部門內建立一個角色

作業識別碼：: createRoleInDepartment

建立一個針對該部門的新角色。

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id
名字	name	True	string
全名	fullName		string
描述	description		string

傳回

身體: DepartmentDto

學生可使用次數切換

作業識別碼：: updateDemoTrainingAvailability

設定示範訓練是否公開給學生。自尊。

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id
available	available	True	boolean

傳回

身體: DemoTrainingDto

將一份文件從主題中解連結

作業識別碼：: unlinkDocumentFromTopic

冪等

參數

名稱	機碼	必要	類型	Description
主題編號	topicId	True	uuid	主題編號
文件識別碼	documentId	True	uuid	文件識別碼

將主題移到其他模組

作業識別碼：: moveTopic

targetOrdinalNumber 為可選;若省略，主題會附加於目標模組

參數

名稱	機碼	必要	類型	Description
主題編號	topicId	True	uuid	主題編號
目標模組ID	targetModuleId	True	uuid
targetOrdinalNumber	targetOrdinalNumber		integer

傳回

身體: TopicDto

將文件指派給專家

作業識別碼：: assignDocumentsToExpert

將文件批量連結給專家。自尊。

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id
文件標識符	documentIds	True	array of uuid

傳回

身體: ExpertDetailDto

將文件連結到主題

作業識別碼：: linkDocumentsToTopic

附加性 — 已連結的文件會被跳過

參數

名稱	機碼	必要	類型	Description
主題編號	topicId	True	uuid	主題編號
文件標識符	documentIds	True	array of uuid

將角色分配給專家

作業識別碼：: assignRolesToExpert

加法性——已分配的角色會被保留;新增的。回報更新專家

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id
roleIds	roleIds	True	array of uuid

傳回

身體: ExpertDetailDto

專家名單

作業識別碼：: listExperts

來電者公司專家分頁列表

參數

名稱	機碼	類型	Description
頁面	page	integer	頁面
Size	size	integer	Size
搜尋	search	string	搜尋

傳回

身體: ExpertListResponse

建立一個空的課程

作業識別碼：: createCourse

建立一個帶有原名的新課程殼

參數

名稱	機碼	必要	類型	Description
名字	name	True	string

傳回

身體: CourseDetailDto

建立使用者

作業識別碼：: createUser

建立使用者並觸發魔法連結邀請流程

參數

名稱	機碼	必要	類型
電子郵件	email	True	email
firstName	firstName		string
lastName	lastName		string
是管理員	isAdmin		boolean
部門角色識別碼	departmentRoleIds		array of uuid

傳回

身體: UserDto

建立示範訓練

作業識別碼：: createDemoTraining

從先前上傳的影片檔案建立示範訓練，並開始處理

參數

名稱	機碼	必要	類型
名字	name	True	string
描述	description		string
培訓類型	trainingType	True	string
videoFileId	videoFileId	True	uuid
部門標識符	departmentId		uuid
處理提示詞	processingPrompt		string

傳回

身體: DemoTrainingDto

從課程中移除一個角色分配

作業識別碼：: removeRoleFromCourse

冪等

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id
角色識別碼	roleId	True	uuid	角色識別碼

成立一個部門

作業識別碼：: createDepartment

在來電者公司中新增一個部門。

參數

名稱	機碼	必要	類型	Description
名字	name	True	string
描述	description		string

傳回

身體: DepartmentDto

找個主題

作業識別碼：: getTopic

回傳給定ID的主題細節。

參數

名稱	機碼	必要	類型	Description
主題編號	topicId	True	uuid	主題編號

傳回

身體: TopicDto

找專家

作業識別碼：: getExpert

回傳專家元資料、連結文件及分配的角色/部門

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id

傳回

身體: ExpertDetailDto

拿一個課堂題

作業識別碼：: getLessonQuestion

會以 ID 回傳一個課堂題目。

參數

名稱	機碼	必要	類型	Description
課程第一	lessonId	True	uuid	課程第一
問題編號	questionId	True	uuid	問題編號

傳回

身體: QuestionDto

指派使用者角色

作業識別碼：: assignUserToRole

冪等

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id
角色識別碼	roleId	True	uuid	角色識別碼
userId	userId	True	uuid

傳回

身體: DepartmentDto

新增模組到

作業識別碼：: addModuleToCourse

在該課程內建立一個新模組。

參數

名稱	機碼	必要	類型	Description
課程標識碼	courseId	True	uuid	課程標識碼
名字	name	True	string
描述	description		string

傳回

身體: ModuleDetailDto

新增課堂問題

作業識別碼：: addLessonQuestion

類型必須是MULTIPLE_CHOICE（需要選項）或OPEN_ENDED

參數

名稱	機碼	必要	類型	Description
課程第一	lessonId	True	uuid	課程第一
型別	type	True	string
收發簡訊	text	True	string
序數	ordinalNumber		integer
收發簡訊	text	True	string
是正確的	isCorrect		boolean
預期答案	expectedAnswer		string

傳回

身體: QuestionDto

更新一個主題的小考題目

作業識別碼：: updateTopicQuizQuestion

提供與儲存型別相符的欄位;不相關領域則被忽略。

參數

名稱	機碼	必要	類型	Description
主題編號	topicId	True	uuid	主題編號
問題編號	questionId	True	uuid	問題編號
收發簡訊	text		string
收發簡訊	text	True	string
是正確的	isCorrect		boolean
預期答案	expectedAnswer		string

傳回

身體: QuestionDto

更新一個模組的小考題

作業識別碼：: updateModuleQuizQuestion

提供與儲存型別相符的欄位;不相關領域則被忽略。

參數

名稱	機碼	必要	類型	Description
課程模組識別碼	moduleId	True	uuid	課程模組識別碼
問題編號	questionId	True	uuid	問題編號
收發簡訊	text		string
收發簡訊	text	True	string
是正確的	isCorrect		boolean
預期答案	expectedAnswer		string

傳回

身體: QuestionDto

更新主題元資料

作業識別碼：: updateTopic

更新名稱和/或描述。省略欄位保留當前值

參數

名稱	機碼	必要	類型	Description
主題編號	topicId	True	uuid	主題編號
名字	name		string
描述	description		string

傳回

身體: TopicDto

更新使用者

作業識別碼：: updateUser

更新名字、姓氏、isAdmin 和角色分配。在 v1 中，電子郵件是無法編輯的。

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id
firstName	firstName		string
lastName	lastName		string
是管理員	isAdmin		boolean
部門角色識別碼	departmentRoleIds		array of uuid

傳回

身體: UserDto

更新媒體元資料

作業識別碼：: updateMediaMetadata

更新名稱和/或說明

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id
名字	name		string
描述	description		string

傳回

身體: MediaDetailDto

更新學習位元組元資料

作業識別碼：: updateLearningByte

省略欄位保留當前值

參數

名稱	機碼	必要	類型	Description
Lb Id	lbId	True	uuid	Lb Id
名字	name		string
描述	description		string

傳回

身體: LearningByteDetailDto

更新文件元資料

作業識別碼：: updateDocumentMetadata

更新名稱和/或說明

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id
名字	name		string
描述	description		string

傳回

身體: DocumentDetailDto

更新模組元資料

作業識別碼：: updateModule

更新名稱和/或描述。省略欄位保留當前值

參數

名稱	機碼	必要	類型	Description
課程模組識別碼	moduleId	True	uuid	課程模組識別碼
名字	name		string
描述	description		string

傳回

身體: ModuleDetailDto

更新示範訓練

作業識別碼：: updateDemoTraining

部分更新。只通過你想改變的欄位。 assignedRoleIds 會取代目前的集合。

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id
名字	name		string
描述	description		string
培訓類型	trainingType		string
部門標識符	departmentId		uuid
assignedRoleIds	assignedRoleIds		array of uuid

傳回

身體: DemoTrainingDto

更新練習

作業識別碼：: updateExercise

類型感知：ILE_TEXT 僅使用 prompt + generatedContent.scenario;RPE_* 使用所有 RPE 欄位。省略欄位保留當前值。

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id
提示	prompt		string
avatarPictureId	avatarPictureId		uuid
avatar特徵	avatarCharacteristics		string
reverseRolePlayEnabled	reverseRolePlayEnabled		boolean
反向角色扮演強制	reverseRolePlayMandatory		boolean
情節	scenario		string
實習生角色	traineeRole		string
化身名稱	avatarName		string
阿凡達描述	avatarDescription		string
作戰挑戰	operationalChallenge		string
成功指標	successMetric		string

傳回

身體: ExerciseDto

更新課堂問題

作業識別碼：: updateLessonQuestion

提供與儲存型別相符的欄位;忽略無關欄位

參數

名稱	機碼	必要	類型	Description
課程第一	lessonId	True	uuid	課程第一
問題編號	questionId	True	uuid	問題編號
收發簡訊	text		string
收發簡訊	text	True	string
是正確的	isCorrect		boolean
預期答案	expectedAnswer		string

傳回

身體: QuestionDto

更新課程元資料

作業識別碼：: updateCourse

更新課程名稱

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id
名字	name		string

傳回

身體: CourseDetailDto

更新課程內容

作業識別碼：: updateLesson

省略內容可保留當前價值

參數

名稱	機碼	必要	類型	Description
課程第一	lessonId	True	uuid	課程第一
內容	content		string

傳回

身體: LessonDetailDto

更新部門

作業識別碼：: updateDepartment

更新名稱和/或說明

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id
名字	name		string
描述	description		string

傳回

身體: DepartmentDto

替換媒體二進位

作業識別碼：: replaceMediaFile

替換現有媒體項目的檔案二進位;元資料會被保留

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id
檔案	file	True	file	檔案

傳回

身體: MediaDetailDto

替換文件二進位

作業識別碼：: replaceDocumentFile

取代現有文件的檔案二進位;元資料會被保留

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id
檔案	file	True	file	檔案

傳回

身體: DocumentDetailDto

模組中的主題列表

作業識別碼：: listTopicsInModule

回傳依序數排序的活躍主題

參數

名稱	機碼	必要	類型	Description
課程模組識別碼	moduleId	True	uuid	課程模組識別碼

傳回

身體: TopicListResponse

模組中的小考題目列表

作業識別碼：: listModuleQuizQuestions

返回與所給模組相關的測驗題目。

參數

名稱	機碼	必要	類型	Description
課程模組識別碼	moduleId	True	uuid	課程模組識別碼

傳回

身體: QuestionListResponse

模組中的小考題目重新排序

作業識別碼：: reorderModuleQuizQuestions

questionIds 必須包含該模組中所有正在進行的測驗題目，並依新順序排列。

參數

名稱	機碼	必要	類型	Description
課程模組識別碼	moduleId	True	uuid	課程模組識別碼
問Ids	questionIds	True	array of uuid

傳回

身體: QuestionListResponse

模組內的主題重排序

作業識別碼：: reorderTopicsInModule

topicIds 必須以新順序，精確包含每個活躍主題一次

參數

名稱	機碼	必要	類型	Description
課程模組識別碼	moduleId	True	uuid	課程模組識別碼
topicIds	topicIds	True	array of uuid

傳回

身體: TopicListResponse

每位學生的活動活動

作業識別碼：: listStudentEvents

分頁的僅向前事件串流

參數

名稱	機碼	必要	類型	Description
使用者 ID	userId	True	uuid	使用者 ID
頁面	page		integer	頁面
Size	size		integer	Size

傳回

身體: EventListResponse

每位學生的見解

作業識別碼：: getStudentInsights

該時段的彙整摘要與各課程分布

參數

名稱	機碼	必要	類型	Description
使用者 ID	userId	True	uuid	使用者 ID
Window	window		string	Window

傳回

身體: StudentInsightsDto

清單示範訓練

作業識別碼：: listDemoTrainings

分頁清單依照來電者公司範圍

參數

名稱	機碼	類型	Description
頁面	page	integer	頁面
Size	size	integer	Size
搜尋	search	string	搜尋
訓練類型	trainingTypes	string	訓練類型
狀態	statuses	string	狀態
部門識別	departmentIds	string	部門識別
可用	isAvailable	boolean	可用

傳回

身體: DemoTrainingListResponse

為一種題型設定主題測驗次數

作業識別碼：: setTopicQuizSettings

替換給定問題類型（MULTIPLE_CHOICE 或 OPEN_ENDED）的計數。其他類型的數量則被保留

參數

名稱	機碼	必要	類型	Description
主題編號	topicId	True	uuid	主題編號
問題類型	questionType	True	string
計數	count		integer

傳回

身體: TopicDto

為一種題型設定模組測驗數量

作業識別碼：: setModuleQuizSettings

替換給定問題類型（MULTIPLE_CHOICE 或 OPEN_ENDED）的計數。其他類型的數量則被保留

參數

名稱	機碼	必要	類型	Description
課程模組識別碼	moduleId	True	uuid	課程模組識別碼
問題類型	questionType	True	string
計數	count		integer

傳回

身體: ModuleDetailDto

為主題加入ILE_TEXT練習

作業識別碼：: addIleTextExercise

在指定主題內建立新的ILE_TEXT練習。

參數

名稱	機碼	必要	類型	Description
主題編號	topicId	True	uuid	主題編號
提示	prompt		string

傳回

身體: ExerciseDto

為主題加入RPE_VIDEO練習題

作業識別碼：: addRpeVideoExercise

在指定主題內建立新的RPE_VIDEO角色扮演練習。

參數

名稱	機碼	必要	類型	Description
主題編號	topicId	True	uuid	主題編號
提示	prompt		string
avatarPictureId	avatarPictureId		uuid
avatar特徵	avatarCharacteristics		string
reverseRolePlayEnabled	reverseRolePlayEnabled		boolean
反向角色扮演強制	reverseRolePlayMandatory		boolean

傳回

身體: ExerciseDto

為主題加入RPE_VOICE練習題

作業識別碼：: addRpeVoiceExercise

在指定主題內創建新的RPE_VOICE角色扮演練習。

參數

名稱	機碼	必要	類型	Description
主題編號	topicId	True	uuid	主題編號
提示	prompt		string
avatarPictureId	avatarPictureId		uuid
avatar特徵	avatarCharacteristics		string
reverseRolePlayEnabled	reverseRolePlayEnabled		boolean
反向角色扮演強制	reverseRolePlayMandatory		boolean

傳回

身體: ExerciseDto

為模組新增主題

作業識別碼：: addTopicToModule

在給定模組內建立一個新主題。

參數

名稱	機碼	必要	類型	Description
課程模組識別碼	moduleId	True	uuid	課程模組識別碼
名字	name	True	string
描述	description		string

傳回

身體: TopicDto

為課程指派角色

作業識別碼：: assignRolesToCourse

附加性——已分配的角色會被跳過。返回更新後的課程細節

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id
roleIds	roleIds	True	array of uuid

傳回

身體: CourseDetailDto

生成包含 AI 內容的完整課程

作業識別碼：: generateCourse

建立課程外殼、所有模組、所有主題，並為每個主題加入 AI 內容生成

參數

名稱	機碼	必要	類型
名字	name	True	string
描述	description		string
名字	name	True	string
描述	description		string
名字	name	True	string
描述	description		string

傳回

身體: GenerateCourseResponse

發佈課程

作業識別碼：: publishCourse

出版課程;如果沒有可發表的內容，則在400分中失敗

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id

傳回

身體: CourseDetailDto

省份列表

作業識別碼：: listDepartments

來電者公司內所有有巢狀角色的部門

傳回

身體: DepartmentListResponse

移除主題引言

作業識別碼：: removeTopicIntro

冪位 — 即使沒有設定引言，也要204

參數

名稱	機碼	必要	類型	Description
主題編號	topicId	True	uuid	主題編號

移除專家的一項角色分配

作業識別碼：: removeRoleFromExpert

冪等

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id
角色識別碼	roleId	True	uuid	角色識別碼

移除專家的所有角色分配

作業識別碼：: removeAllRolesFromExpert

冪等

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id

移除模組介紹

作業識別碼：: removeModuleIntro

冪位 — 即使沒有設定引言，也要204

參數

名稱	機碼	必要	類型	Description
課程模組識別碼	moduleId	True	uuid	課程模組識別碼

移除課程中所有角色分配

作業識別碼：: removeAllRolesFromCourse

冪等

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id

解除專家的文件指派

作業識別碼：: unassignDocumentFromExpert

冪等

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id
文件識別碼	documentId	True	uuid	文件識別碼

觸發 AI 主題內容生成

作業識別碼：: generateCourseContent

為課程中指定主題的 AI 內容生成進行排隊

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id
topicIds	topicIds	True	array of uuid

傳回

身體: GenerationRequestResponse

設定或替換主題引言

作業識別碼：: setTopicIntro

Upsert — 若缺則創建，若有則替換

參數

名稱	機碼	必要	類型	Description
主題編號	topicId	True	uuid	主題編號
簡介	introduction		string

傳回

身體: IntroDto

設定或替換模組開場

作業識別碼：: setModuleIntro

Upsert — 若缺則創建，若有則替換

參數

名稱	機碼	必要	類型	Description
課程模組識別碼	moduleId	True	uuid	課程模組識別碼
簡介	introduction		string

傳回

身體: IntroDto

課中問題重新排序

作業識別碼：: reorderLessonQuestions

questionIds 必須包含該課程中所有活躍的問題，且以新順序呈現

參數

名稱	機碼	必要	類型	Description
課程第一	lessonId	True	uuid	課程第一
問Ids	questionIds	True	array of uuid

傳回

身體: QuestionListResponse

課程中的模組重排序

作業識別碼：: reorderModulesInCourse

moduleId 必須在新順序中恰好包含每個活躍模組一次

參數

名稱	機碼	必要	類型	Description
課程標識碼	courseId	True	uuid	課程標識碼
moduleIds	moduleIds	True	array of uuid

傳回

身體: ModuleListResponse

課程列表

作業識別碼：: listCourses

來電者公司課程分頁列表

參數

名稱	機碼	類型	Description
頁面	page	integer	頁面
Size	size	integer	Size
搜尋	search	string	搜尋
Status	status	string	Status
部門角色識別碼	departmentRoleIds	string	部門角色識別碼

傳回

身體: CourseListResponse

證書細節

作業識別碼：: getCertificate

將一份指定範圍的證書回傳給來電者公司

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id

傳回

身體: CertificateDto

買模組

作業識別碼：: getModule

回報該 ID 的模組細節。

參數

名稱	機碼	必要	類型	Description
課程模組識別碼	moduleId	True	uuid	課程模組識別碼

傳回

身體: ModuleDetailDto

透過 AI 重新生成特定物品

作業識別碼：: regenerateCourseItem

重建單一課程、課程問題、測驗、入門或練習

參數

名稱	機碼	必要	類型
目標	target	True	string
目標識別	targetId	True	uuid
parentType	parentType		string

傳回

身體: GenerationRequestResponse

重播影像處理

作業識別碼：: reprocessDemoTraining

重新提交影片進行 AI 分割。可選擇覆蓋處理提示。

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id
處理提示詞	processingPrompt		string

傳回

身體: DemoTrainingDto

重新啟用使用者

作業識別碼：: reactivateUser

冪固態 — 即使使用者已啟動，也會回傳

參數

名稱	機碼	必要	類型	Description
Id	id	True	uuid	Id

傳回

身體: UserDto

重新排序某主題的小考題目

作業識別碼：: reorderTopicQuizQuestions

questionIds 必須以新順序包含該主題的所有活動測驗題目。

參數

名稱	機碼	必要	類型	Description
主題編號	topicId	True	uuid	主題編號
問Ids	questionIds	True	array of uuid

傳回

身體: QuestionListResponse

針對某個主題，做一題小考題

作業識別碼：: getTopicQuizQuestion

回傳一個與該主題相關的小測題目。

參數

名稱	機碼	必要	類型	Description
主題編號	topicId	True	uuid	主題編號
問題編號	questionId	True	uuid	問題編號

傳回

身體: QuestionDto

定義

QuizSettingDTO

名稱	路徑	類型	Description
問題類型	questionType	string
計數	count	integer

TopicDto

名稱	路徑	類型
id	id	uuid
moduleId	moduleId	uuid
名字	name	string
描述	description	string
序數	ordinalNumber	integer
hasContent	hasContent	boolean
quiz設定	quizSettings	array of QuizSettingDto

導言

名稱	路徑	類型
id	id	uuid
元件ID	componentId	uuid
componentType	componentType	string
簡介	introduction	string
來源	source	string
createdAt	createdAt	date-time
updatedAt	updatedAt	date-time

模組詳細 DTO

名稱	路徑	類型
id	id	uuid
courseId	courseId	uuid
名字	name	string
描述	description	string
產品ID	productId	uuid
序數	ordinalNumber	integer
lockedForGeneration	lockedForGeneration	boolean
quiz設定	quizSettings	array of QuizSettingDto
主題	topics	array of TopicDto

媒體資料 DTO

名稱	路徑	類型
id	id	uuid
名字	name	string
描述	description	string
kind	kind	string
mime類型	mimeType	string
sizeBytes	sizeBytes	integer
狀態	status	string
處理狀態	processingStatus	string
createdAt	createdAt	date-time
上傳者	uploadedBy	UploadedByDto
downloadUrl 的	downloadUrl	string

由Dto上傳

名稱	路徑	類型
id	id	uuid
kind	kind	string
名字	name	string

文件詳細 DTO

名稱	路徑	類型
id	id	uuid
名字	name	string
描述	description	string
mime類型	mimeType	string
sizeBytes	sizeBytes	integer
狀態	status	string
createdAt	createdAt	date-time
上傳者	uploadedBy	UploadedByDto
downloadUrl 的	downloadUrl	string

部門角色 DTO

名稱	路徑	類型
部門標識符	departmentId	uuid
部門名稱	departmentName	string
角色ID	roleId	uuid
角色名稱	roleName	string

UserDto

名稱	路徑	類型
id	id	uuid
電子郵件	email	string
firstName	firstName	string
lastName	lastName	string
狀態	status	string
kind	kind	string
是管理員	isAdmin	boolean
createdAt	createdAt	date-time
部門角色	departmentRoles	array of DepartmentRoleDto

問題：Dto

名稱	路徑	類型
id	id	uuid
型別	type	string
parentId	parentId	uuid
parentType	parentType	string
收發簡訊	text	string
序數	ordinalNumber	integer
來源	source	string
預期答案	expectedAnswer	string
options	options	array of QuestionOptionDto
createdAt	createdAt	date-time
updatedAt	updatedAt	date-time

問題選擇 DTO

名稱	路徑	類型
收發簡訊	text	string
是正確的	isCorrect	boolean
序數	ordinalNumber	integer

問題清單回應

名稱	路徑	類型	Description
項目	items	array of QuestionDto

LearningByteDetailDto

名稱	路徑	類型
id	id	uuid
topicId	topicId	uuid
名字	name	string
描述	description	string
序數	ordinalNumber	integer
來源	source	string
createdAt	createdAt	date-time
updatedAt	updatedAt	date-time
課程	lessons	array of LessonDto

課堂

名稱	路徑	類型
id	id	uuid
learningByteId	learningByteId	uuid
內容	content	string
序數	ordinalNumber	integer
來源	source	string
問題計數	questionCount	integer
媒體計數	mediaCount	integer
createdAt	createdAt	date-time
updatedAt	updatedAt	date-time

演習Dto

名稱	路徑	類型
id	id	uuid
topicId	topicId	uuid
型別	type	string
提示	prompt	string
序數	ordinalNumber	integer
來源	source	string
isGenerated	isGenerated	boolean
avatarPictureId	avatarPictureId	uuid
avatar特徵	avatarCharacteristics	string
reverseRolePlayEnabled	reverseRolePlayEnabled	boolean
反向角色扮演強制	reverseRolePlayMandatory	boolean
生成內容	generatedContent	ExerciseGeneratedContentDto
createdAt	createdAt	date-time
updatedAt	updatedAt	date-time

ExerciseGeneratedContentDto

名稱	路徑	類型
id	id	uuid
再生本體	regenerationId	uuid
情節	scenario	string
實習生角色	traineeRole	string
化身名稱	avatarName	string
阿凡達描述	avatarDescription	string
作戰挑戰	operationalChallenge	string
成功指標	successMetric	string
指令	instruction	string
指令反向	instructionReverse	string
練習知識庫	exerciseKnowledgeBase	string
topicKnowledgeBase	topicKnowledgeBase	string

主題清單回應

名稱	路徑	類型	Description
項目	items	array of TopicDto

課程詳細 DTO

名稱	路徑	類型
id	id	uuid
learningByteId	learningByteId	uuid
內容	content	string
序數	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	uuid
序數	ordinalNumber	integer
來源	source	string

專家詳細多托

名稱	路徑	類型
id	id	uuid
名字	name	string
描述	description	string
狀態	status	string
連結文件計數	linkedDocumentCount	integer
createdAt	createdAt	date-time
updatedAt	updatedAt	date-time
assignedRoleIds	assignedRoleIds	array of uuid
assignedDepartmentIDs	assignedDepartmentIds	array of uuid
連結文件	linkedDocuments	array of LinkedDocumentDto

LinkedDocumentDto

名稱	路徑	類型
id	id	uuid
名字	name	string
副檔名	extension	string
sizeBytes	sizeBytes	integer
描述	description	string
連結	linkedAt	date-time

AskResponse

名稱	路徑	類型	Description
答案	answer	string
持續時間女士	durationMs	integer

部門Dto

名稱	路徑	類型
id	id	uuid
名字	name	string
描述	description	string
狀態	status	string
createdAt	createdAt	date-time
roles	roles	array of DepartmentRoleDto

示範訓練 DTO

名稱	路徑	類型
id	id	uuid
companyId	companyId	uuid
部門標識符	departmentId	uuid
名字	name	string
描述	description	string
培訓類型	trainingType	string
狀態	status	string
可用	isAvailable	boolean
videoFileId	videoFileId	uuid
處理提示詞	processingPrompt	string
errorMessage	errorMessage	string
assignedRoleIds	assignedRoleIds	array of uuid
單元	segments	array of DemoTrainingSegmentDto
createdAt	createdAt	date-time
updatedAt	updatedAt	date-time

示範訓練段 DTO

名稱	路徑	類型
id	id	uuid
序數	ordinalNumber	integer
名字	name	string
文字記錄	transcript	string
持續時間秒	durationSeconds	integer

課程詳情 DTO

名稱	路徑	類型
id	id	uuid
名字	name	string
狀態	status	string
模組計數	moduleCount	integer
主題計數	topicCount	integer
has未發表變更	hasUnpublishedChanges	boolean
目前版本編號	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

模組摘要 DTO

名稱	路徑	類型
id	id	uuid
名字	name	string
序數	ordinalNumber	integer
主題計數	topicCount	integer

世代請求回應

名稱	路徑	類型	Description
id	id	uuid
狀態	status	string

模組Dto

名稱	路徑	類型
id	id	uuid
courseId	courseId	uuid
名字	name	string
描述	description	string
產品ID	productId	uuid
序數	ordinalNumber	integer
lockedForGeneration	lockedForGeneration	boolean
主題計數	topicCount	integer
quiz設定	quizSettings	array of QuizSettingDto

模組列表回應

名稱	路徑	類型	Description
項目	items	array of ModuleDto

生成課程回應

名稱	路徑	類型	Description
courseId	courseId	uuid
generationRequestId	generationRequestId	uuid

頁面資訊

名稱	路徑	類型
size	size	integer
number	number	integer
總元素	totalElements	integer
總頁數	totalPages	integer

UserList回應

名稱	路徑	類型	Description
項目	items	array of UserDto
頁面	page	PageInfo

主題連結文件 DTO

名稱	路徑	類型
id	id	uuid
名字	name	string
副檔名	extension	string
size	size	integer
處理狀態	processingStatus	string
描述	description	string
來源	source	string
linkType	linkType	string
連結	linkedAt	date-time

主題連結文件清單回應

名稱	路徑	類型	Description
項目	items	array of TopicLinkedDocumentDto
頁面	page	PageInfo

LearningByteDto

名稱	路徑	類型
id	id	uuid
topicId	topicId	uuid
名字	name	string
描述	description	string
序數	ordinalNumber	integer
來源	source	string
課程計數	lessonCount	integer
createdAt	createdAt	date-time
updatedAt	updatedAt	date-time

LearningByteListResponse

名稱	路徑	類型	Description
項目	items	array of LearningByteDto

運動清單回應

名稱	路徑	類型	Description
項目	items	array of ExerciseDto

證書Dto

名稱	路徑	類型
id	id	uuid
enrollmentId	enrollmentId	uuid
學生識別	studentId	uuid
companyId	companyId	uuid
courseId	courseId	uuid
courseVersionID	courseVersionId	uuid
學生姓名	studentName	string
companyName	companyName	string
課程名稱	courseName	string
serialNumber	serialNumber	string
完成於	completedAt	date-time
發佈時間	issuedAt	date-time
pdfFileID	pdfFileId	uuid
PDF 可取得	pdfAvailable	boolean

憑證清單回應

名稱	路徑	類型	Description
項目	items	array of CertificateDto

MediaDto

名稱	路徑	類型
id	id	uuid
名字	name	string
描述	description	string
kind	kind	string
mime類型	mimeType	string
sizeBytes	sizeBytes	integer
狀態	status	string
處理狀態	processingStatus	string
createdAt	createdAt	date-time
上傳者	uploadedBy	UploadedByDto

MediaListResponse

名稱	路徑	類型	Description
項目	items	array of MediaDto
頁面	page	PageInfo

課程清單回應

名稱	路徑	類型	Description
項目	items	array of LessonDto

航道分解 Dto

名稱	路徑	類型
courseId	courseId	uuid
課程名稱	courseName	string
進步百分比	progressPercent	integer
花費時數	hoursSpent	double
開始時間	startedAt	date-time
完成於	completedAt	date-time

StudentInsightsDto

名稱	路徑	類型
userId	userId	uuid
視窗	window	WindowDto
摘要	summary	StudentSummaryDto
沿線	byCourse	array of CourseBreakdownDto

學生摘要 DTO

名稱	路徑	類型
活動日	activeDays	integer
課程已完成	lessonsCompleted	integer
演習完成	exercisesCompleted	integer
測驗通過	quizzesPassed	integer
花費時數	hoursSpent	double

WindowDto

名稱	路徑	類型
kind	kind	string
寄件者	from	date-time
至	to	date-time

事件項目

名稱	路徑	類型
id	id	uuid
kind	kind	string
動作	action	string
courseId	courseId	uuid
課程名稱	courseName	string
發生於	occurredAt	date-time

事件清單回應

名稱	路徑	類型	Description
項目	items	array of EventItemDto
頁面	page	PageInfo

公司洞察 Dto

名稱	路徑	類型	Description
companyId	companyId	uuid
摘要	summary	CompanySummaryDto

公司摘要 DTO

名稱	路徑	類型
學生總數	totalStudents	integer
平均進步百分比	averageProgressPercent	integer
activeThisWeekCount	activeThisWeekCount	integer
完成伯爵	completedCount	integer
完成率百分比	completionRatePercent	integer

ExpertDto

名稱	路徑	類型
id	id	uuid
名字	name	string
描述	description	string
狀態	status	string
連結文件計數	linkedDocumentCount	integer
createdAt	createdAt	date-time
updatedAt	updatedAt	date-time

專家清單回應

名稱	路徑	類型	Description
項目	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	UploadedByDto

DocumentList回應

名稱	路徑	類型	Description
項目	items	array of DocumentDto
頁面	page	PageInfo

部門列表回應

名稱	路徑	類型	Description
項目	items	array of DepartmentDto

DemoTrainingListItemDTO

名稱	路徑	類型
id	id	uuid
部門標識符	departmentId	uuid
videoFileId	videoFileId	uuid
名字	name	string
描述	description	string
培訓類型	trainingType	string
狀態	status	string
可用	isAvailable	boolean
assignedRoleIds	assignedRoleIds	array of uuid
segmentCount	segmentCount	integer
持續時間秒	durationSeconds	integer
createdAt	createdAt	date-time

示範訓練清單回應

名稱	路徑	類型	Description
項目	items	array of DemoTrainingListItemDto
頁面	page	PageInfo

CourseDto

名稱	路徑	類型
id	id	uuid
名字	name	string
狀態	status	string
模組計數	moduleCount	integer
主題計數	topicCount	integer
has未發表變更	hasUnpublishedChanges	boolean
目前版本編號	currentVersionNumber	integer
最新發表於	latestPublishedAt	date-time
createdAt	createdAt	date-time

課程清單回應

名稱	路徑	類型	Description
項目	items	array of CourseDto
頁面	page	PageInfo

世代進步多

名稱	路徑	類型
全任務	totalTasks	integer
completedTasks	completedTasks	integer
失敗任務	failedTasks	integer

GenerationRequestInfoDto

名稱	路徑	類型
id	id	uuid
狀態	status	string
createdAt	createdAt	string
完成於	completedAt	string
錯誤	error	string
進展	progress	GenerationProgressDto
目標	target	string
目標識別	targetId	uuid
parentType	parentType	string
topicIds	topicIds	array of uuid
moduleIds	moduleIds	array of uuid

世代狀態回應

名稱	路徑	類型	Description
activeRequests	activeRequests	array of GenerationRequestInfoDto

CourseVersionDto

名稱	路徑	類型
id	id	uuid
courseId	courseId	uuid
版本編號	versionNumber	integer
發表於	publishedAt	date-time
出版人	publishedBy	uuid
模組計數	moduleCount	integer
主題計數	topicCount	integer
課程計數	lessonCount	integer
練習計數	exerciseCount	integer
問題計數	questionCount	integer
估計時間秒	estimatedTimeSeconds	integer

課程版本列表回應

名稱	路徑	類型	Description
項目	items	array of CourseVersionDto

審計快照

名稱	路徑	類型
createdAt	createdAt	date-time
由...創建	createdBy	uuid
updatedAt	updatedAt	date-time
updatedBy （更新者）	updatedBy	uuid

課程快照

名稱	路徑	類型
名字	name	string
coverImageId（封面圖片ID）	coverImageId	uuid
prerequisiteCourseId	prerequisiteCourseId	uuid
課程指導方針	courseGuideline	string
課程指引	lessonsGuideline	string
questions指引	questionsGuideline	string
演習指導方針	exercisesGuideline	string
modules	modules	array of ModuleSnapshot

CourseVersionSnapshotDto

名稱	路徑	類型
id	id	uuid
courseId	courseId	uuid
版本編號	versionNumber	integer
快照集	snapshot	CourseSnapshot

ExerciseSnapshot

名稱	路徑	類型
id	id	uuid
topicId	topicId	uuid
exerciseType	exerciseType	string
提示	prompt	string
序數	ordinalNumber	integer
isGenerated	isGenerated	boolean
來源	source	string
稽核	audit	AuditSnapshot
avatar特徵	avatarCharacteristics	string
avatarPictureId	avatarPictureId	uuid
reverseRolePlayEnabled	reverseRolePlayEnabled	boolean
反向角色扮演強制	reverseRolePlayMandatory	boolean
情節	scenario	string
實習生角色	traineeRole	string
化身名稱	avatarName	string
阿凡達描述	avatarDescription	string
作戰挑戰	operationalChallenge	string
成功指標	successMetric	string
指令	instruction	string
指令反向	instructionReverse	string
練習知識庫	exerciseKnowledgeBase	string

LearningByteSnapshot

名稱	路徑	類型
id	id	uuid
topicId	topicId	uuid
名字	name	string
描述	description	string
序數	ordinalNumber	integer
來源	source	string
稽核	audit	AuditSnapshot
課程	lessons	array of LessonSnapshot

課程快照

名稱	路徑	類型
id	id	uuid
learningByteId	learningByteId	uuid
內容	content	string
序數	ordinalNumber	integer
來源	source	string
稽核	audit	AuditSnapshot
媒體	media	array of MediaSnapshot
問題	questions	array of QuestionSnapshot

連結文件快照

名稱	路徑	類型
id	id	uuid
檔案識別	fileId	uuid
linkType	linkType	string
isSupplement	isSupplement	boolean
名字	name	string
副檔名	extension	string
size	size	integer
描述	description	string

媒體快照

名稱	路徑	類型
id	id	uuid
檔案識別	fileId	uuid
序數	ordinalNumber	integer
mediaType	mediaType	string
來源	source	string

模組快照

名稱	路徑	類型
id	id	uuid
courseId	courseId	uuid
產品ID	productId	uuid
名字	name	string
描述	description	string
簡介	intro	string
序數	ordinalNumber	integer
quiz設定	quizSettings	array of QuizSettingSnapshot
測驗題目	quizQuestions	array of QuestionSnapshot
主題	topics	array of TopicSnapshot

選項快照

名稱	路徑	類型
id	id	uuid
選項文字	optionText	string
是正確的	isCorrect	boolean
序數	ordinalNumber	integer

問題快照

名稱	路徑	類型
id	id	uuid
問題類型	questionType	string
問題文本	questionText	string
預期答案	expectedAnswer	string
序數	ordinalNumber	integer
來源	source	string
稽核	audit	AuditSnapshot
options	options	array of OptionSnapshot

QuizSetting快照

名稱	路徑	類型	Description
問題類型	questionType	string
計數	count	integer

主題快照

名稱	路徑	類型
id	id	uuid
moduleId	moduleId	uuid
名字	name	string
描述	description	string
簡介	intro	string
序數	ordinalNumber	integer
quiz設定	quizSettings	array of QuizSettingSnapshot
測驗題目	quizQuestions	array of QuestionSnapshot
learningBytes	learningBytes	array of LearningByteSnapshot
演習	exercises	array of ExerciseSnapshot
連結文件	linkedDocuments	array of LinkedDocumentSnapshot
topicKnowledgeBase	topicKnowledgeBase	string

串流回應體