AI
AI
Holarch 中的每項 AI 功能、預覽與核准的運作方式、AI 金鑰與使用哪個金鑰、Individual 和 Team 方案內含的 AI、用量與限制、AI 權限,以及傳送給供應商的內容。
本頁內容
使用 AI 加快例行的系統工程工作。它可以:
- 回答關於開啟專案的問題;
- 改寫和產生需求;
- 建議功能和流程;
- 建議追溯關聯;
- 草擬風險、測試案例、權衡研究準則和決策理由;
- 繪製美工圖案。
AI 是選用的。Holarch 的其他所有功能不需要 AI 也能運作。
每項 AI 變更都會先以預覽顯示。在您確認之前,模型不會有任何變更。復原一次(⌘Z / Ctrl+Z)即可撤銷整個變更。
概念
| 條件 | 意義 |
|---|---|
| ✦ AI 控制項 | 頂端列中唯一的 AI 控制項。✦ AI 會開啟詢問 AI;其 ▾ 會列出目前頁面的 AI 工具,接著是 AI 設定…。 |
| 詢問 AI | 回答關於開啟專案和 Holarch 問題的聊天面板。 |
| AI 工具 | 頁面專屬的動作,例如新增可量測的標準…或審查關聯。 |
| 預覽 | 在套用任何內容之前顯示 AI 提案的對話方塊:目前文字、建議文字和逐字變更,或可勾選的項目清單。 |
| AI 金鑰 | 來自 AI 服務商的 API 金鑰。Holarch 會將其加密儲存在伺服器上,且不會再次顯示。目前不支援其他供應商;請參閱Holarch 如何選擇 AI 模型。 |
| 使用中的金鑰 | 伺服器為您的請求所使用的金鑰:您自己的、您組織的,或包含的 AI(Holarch 的金鑰)。 |
| 權杖 | AI 供應商計數的單位。一個權杖約為一個英文單字的四分之三。每個請求會計入傳送的權杖和寫回的權杖。 |
| 每月限制 | 金鑰擁有者為金鑰設定的每月權杖上限。 |
| 成員限制 | 由管理員設定、針對組織(或自行託管伺服器)付費之 AI 的每人每月上限:適用於所有人的預設值,以及每人的自訂限制。 |
| AI 參考檔案 | 您附加到專案的檔案,其文字會加入部分 AI 提示中。 |
使用方式
使用時機與原因
AI 在生命週期的每個階段都能提供協助,但絕不取代審查:
- 需求:將模糊的陳述轉換為單一、可量測的「shall」陳述;分割複合需求;草擬理由;產生子需求;判斷 Correct、Feasible 和 Necessary,並找出規則遺漏的模稜兩可或無法驗證的措辭(Unambiguous、Verifiable)。
- 行為:從需求集擷取功能並建議功能流程(在需求之後、分配之前)。
- 可追溯性:在可追溯性矩陣中建議遺漏的關聯並標記可疑的關聯。
- 驗證:為需求草擬測試案例。
- 風險和決策:為項目草擬風險、依需求和 MOE 建議權衡研究準則,以及草擬決策理由。
- 文件和白板:摘要或翻譯文件、改寫豐富文字,以及將便利貼轉換為需求。
- 問題:詢問關於專案的問題(「哪些需求沒有測試案例驗證?」)或關於 Holarch 的問題(「如何從 CSV 檔案匯入需求?」)。
設定 AI
在 Individual 和 Team 方案中,AI 功能不需要金鑰即可使用,這些方案每月包含 AI 請求(請參閱包含的 AI)。若需要更多,請新增您自己的 AI 服務商 API 金鑰,或使用您組織的金鑰。Free 方案沒有包含的 AI,也不能使用自己的金鑰,但使用學術電子郵件地址的帳戶和作用中班級組織的成員除外。
- 在 AI 服務商的主控台中建立 API 金鑰。
- 在 Holarch 中,開啟 ✦ AI ▾ → AI 設定…。(或按一下您的姓名縮寫 → 帳戶設定,然後捲動到 AI 金鑰。)
- 按一下+ 新增金鑰。
- 供應商會顯示 AI 服務商 API,這是目前唯一提供的供應商。
- 將金鑰貼到 API 金鑰中。
- 選用:輸入至少 1,000 的每月限制(權杖)。留空表示不限制。
- 按一下測試並儲存。
- 若開啟確認您的密碼,請輸入您的密碼。此驗證持續 10 分鐘。
您會看到快顯通知「已新增 AI 金鑰(AI 服務商 API,…abcd)。」Holarch 會先傳送一個簡短的測試請求。若測試失敗,金鑰不會被儲存,訊息會說明原因。
- 檢查使用中的金鑰。
您會看到您的金鑰:AI 服務商 API(…abcd)。
使用 AI 工具
對所選項目執行頁面專屬的 AI 工具,審查其提案,然後套用。
- 開啟頁面並選取項目,例如文件中的需求。
- 按一下頂端列中 ✦ AI 旁的 ▾。(或按 ⌘K / Ctrl+K 並輸入工具名稱。)
- 選擇工具,例如新增可量測的標準…。
您會看到一個忙碌對話方塊「正在詢問 <provider>…」,並有計時器在執行。取消會停止請求。
- 審查預覽。
預覽的影響清單會顯示追溯到 AI 將變更項目的內容:需求、測試、介面、文件、圖以及其他專案中的項目,每項標示為受影響或檢查(影響)。按一下其標題可開啟它,按一下某列可在不關閉預覽的情況下查看該項目。
- 在對話方塊允許的地方編輯建議。
- 取消勾選任何您不想要的內容。
- 按一下套用按鈕,例如套用、新增所選項、建立測試案例或套用所選項。
您會看到簡短的快顯通知,例如「已套用新增可量測的標準」。一次復原即可撤回整個變更。
提出問題
詢問 AI 會回答關於開啟專案和 Holarch 的問題。它不會變更任何內容。
- 按一下頂端列中的 ✦ AI。(或按 ⌘K / Ctrl+K 並選擇詢問 AI…。)
- 輸入問題,或按一下其中一個範例。
- 按 Enter 傳送。Shift+Enter 則會新增一行。
您會在面板中看到答案。項目名稱和說明主題是連結。部分答案包含可開啟答案所指頁面的按鈕。答案中的程式碼會顯示在可橫向捲動的方塊中。
- 視需要提出後續問題。最近的對話會隨每個問題一起傳送。
在 app.holarch.app 上,操作方法問題也會依據 holarch.app 上的指南、文章、訓練、影片逐字稿和變更記錄來回答。這些頁面的連結會在新分頁中開啟。
詢問 AI 會以您書寫的語言回答。說明和 Docs 是英文的,因此答案中的選單、按鈕和欄位名稱會依英文介面顯示的樣子呈現。詢問 AI 能為任何語言的問題找到說明主題和 Docs 章節;當答案不是英文時,它會以答案的語言將每個說明和 Docs 連結標示為英文頁面,例如(auf Englisch)或(英語)。
詢問 AI 從專案讀取的內容:
- 操作方法和功能問題(「如何匯入 CSV 檔案?」、「Holarch 可以匯出成 Word 嗎?」):不讀取專案資料。詢問 AI 會依據說明、Docs 和 Holarch 功能清單回答。
- 小型專案:每個項目和關係,隨每個問題完整傳送。
- 較大型專案:整個專案的摘要(依類別列出的項目、其 Status、Priority 和其他清單值、標籤、依類型列出的關係,以及文件和圖的名稱)。詢問 AI 接著會分步驟只讀取問題所需的內容:依字詞搜尋項目(與搜尋相同的純文字比對)、讀取單一項目及其關係,並依類別、屬性值、標籤、文字或項目具有或缺少的關係來計數或列出項目(例如沒有 verified by 的需求)。使用 Holarch 的預設模型時,可能會先以快速模型進行快速分類步驟;這屬於同一個問題的一部分。清單被截斷時,答案下方的一行會說明其依據,例如「依據 9,812 個類別為 Requirement 且沒有 verified by 的項目中的 200 個(共 100,000 個項目),加上專案摘要。」需要過多文字的問題會停止並說明原因;請提出範圍較小的問題。
- 若要縮小大型專案上的問題範圍,請使用項目中出現的字詞或數字、先開啟項目,或選取項目後按一下右鍵 → ✦ 就這些詢問 AI。
面板按鈕:
- 展開按鈕會讓面板填滿視窗的大部分。再按一次可恢復大小。
- ⚙ 會開啟 AI 設定。
- ⟲ 會清除對話。
- × 會關閉面板。
若要變更面板大小:
- 拖曳面板左緣使其變寬或變窄。
- 使用鍵盤:按 Tab 移到邊緣,然後按 ←(變寬)或 →(變窄)。按住 Shift 可加大步幅。Home 設為最小尺寸,End 設為最大尺寸。
- 按兩下邊緣可恢復預設大小。
此瀏覽器會保留您選擇的大小。在窄視窗中,面板會填滿寬度。
附加參考檔案
參考檔案會將背景資料(例如標準或工作說明書)加入 AI 提示中。每個專案有一份檔案清單,每個檔案都有自己的在 AI 中使用開關。
- 開啟 ✦ AI ▾ → AI 設定…。
- 在供 AI 使用的專案參考檔案下方,按一下+ 檔案並選擇檔案。
您會看到該檔案及其大小,且在 AI 中使用已勾選。清單下方的一行會顯示使用中的檔案數量及其增加的文字量,例如「使用中:3 個檔案中的 2 個,48k 個字元」。
- 重複上述步驟以新增更多檔案。
- 取消勾選檔案的在 AI 中使用,可將其保留在清單中而不傳送;或按一下 × 將其移除。
- 按一下儲存。
參考檔案保存在此瀏覽器中,不會與其他成員共用。舊版本儲存在套件中的檔案會出現在同一份清單中;當時作用中套件的檔案為使用中。檔案類型和限制請參閱AI 參考檔案。
實作範例:精煉 EO-1 需求
CubeSat EO-1 示範有三個 Draft 需求,審查者會將其退回:
- 2.5 Safe Mode Recovery:「The spacecraft should recover from safe mode quickly and resume imaging as appropriate」
- 3.5 Battery Thermal Control:「The thermal design shall keep the battery warm enough (TBD).」
- 6.4 Operator Interface:「The operator interface shall be user friendly and/or easy to use.」
使用 AI 修正它們:
- 建立示範:管理專案 → 專案檔案 ▾ → 新增示範專案。
- 開啟 EO-1 System Requirements Specification。
- 選取 2.5 Safe Mode Recovery。
- 選擇 ✦ AI ▾ → 新增可量測的標準…。
您會看到目前、變更和建議(套用前可編輯)。建議內容例如「The spacecraft shall exit safe mode and resume imaging within 24 hours of the fault being cleared.」說明會指出 24 小時是建議值。
- 若您的任務分析另有結論,請變更此值。
- 按一下套用。
- 選取 6.4 Operator Interface 並選擇拆分複合需求…。
您會看到每個單一需求。項目 1 取代 6.4;其他項目則新增在其後。
- 按一下拆分需求。
- 選取 3.5 並選擇草擬理由…。
- 審查理由並按一下套用。
- 開啟需要與需求 → 品質。
- 選擇 ✦ AI ▾ → 用 AI 檢查(n 項需求)…。
您會看到每個需求的 Correct、Feasible、Necessary、Unambiguous 和 Verifiable 判斷結果及原因。判定下方的核取方塊會說明套用後的變更(「No → Yes」、「新增一個發現事項」);「無變更」表示儲存的值已經相符。改寫和已核准的需求一開始不勾選。按鈕上方的一行會計算要套用的內容,例如「將 7 個值和 2 個改寫套用到 5 個需求。」
- 按一下套用所選項。
- 回到文件,選取 2.5 並選擇產生測試案例…。
- 審查步驟(依序)、設定、預期結果和 Verification Method。
- 按一下建立測試案例。
您會看到新的測試案例,已關聯到 2.5。
每項套用的變更都能以一次復原撤回。按 ⌘Z / Ctrl+Z 可撤回其中任何一項。
提示與良好做法
- 將 AI 輸出視為草稿。套用前,請依據您的分析檢查數字、單位和假設。AI 提出的值會在其說明中標示。
- 先選取。只有選取需求(或其他陳述)時,需求工具才會出現在 ▾ 中。
- 勾選即表示套用。請閱讀每一列預覽。對 Approved、已納入基準線或已鎖定項目的變更、關聯移除以及含有網址的建議,一開始不勾選且會醒目標示;請在檢查後再勾選。
- 留意輸入橫幅。當輸入包含匯入檔案的文字、其他人的變更、AI 參考檔案或隱藏文字時,預覽會顯示橫幅。請仔細檢查這些建議。
- 讓使用中的檔案保持精簡。參考檔案會加入許多提示中,並消耗更多權杖。對目前工作不需要的檔案,請取消勾選在 AI 中使用。
- 為您與組織共用的金鑰設定每月限制。
常見錯誤:
- ✦ AI 開啟「沒有 AI 金鑰」。沒有可用的金鑰。按一下開啟 AI 金鑰並新增一個,或請您的組織管理員提供組織金鑰。
- ✦ AI 呈灰色。將游標指向它可查看原因:
- 「僅檢視:AI 工具需要編輯權限」:您只有檢視權限。
- 「此組織的 AI 已由其管理員關閉。」:組織已關閉 AI。
- ▾ 中沒有頁面的工具。請選取該工具作用的項目,或開啟提供該工具的頁面。請參閱每項 AI 功能。
- 「勾選此方塊以將變更套用到此項目。」目標為 Approved、已納入基準線或已鎖定。若您確實要進行此變更,請勾選選擇加入方塊。
- 金鑰測試失敗。請確認金鑰完整、有效且有餘額。
與其他功能的關聯
- AI 變更會經過一般模型流程:可以復原、會被儲存、即時與協作者共用,並記錄在版本歷程中。
- 需求工具會提供資料給其他功能:
- 品質頁面:附有「AI:…」原因的手動 Yes/No 值;
- 可追溯性:產生的需求會追溯到其目標;
- 驗證:產生的測試案例附有驗證方法標籤;
- 風險登錄表:產生的風險與其原因建立關係。
- 詢問 AI 使用說明主題和執行中應用程式的功能清單,因此會告訴您某項功能何時不可用。
- 組織管理員可控制其專案的 AI(請參閱管理)。
✦ AI 控制項
此控制項位於每個專案頁面的頂端列。
- ✦ AI 會開啟詢問 AI。
- ▾ 會列出目前頁面的 AI 工具,接著是 AI 設定…。
沒有 AI 工具的頁面只會顯示 ✦ AI。在窄視窗中,控制項會顯示為閃光圖示和 ▾。相同的工具也位於 ⌘K / Ctrl+K 的此頁面的 AI 工具之下。
符合下列任一情況時,控制項會關閉。其工具提示會說明原因。
- 您只有檢視權限:「僅檢視:AI 工具需要編輯權限」;
- 專案的組織已關閉 AI:「此組織的 AI 已由其管理員關閉。」
- 安裝環境的管理員已關閉 AI:「此安裝的 AI 已關閉。」(請參閱安裝環境關閉 AI)。
沒有金鑰時,控制項仍保持開啟:✦ AI 會開啟沒有 AI 金鑰(「在『帳戶 → AI 金鑰』中新增 AI 服務商 API 金鑰。」)並提供開啟 AI 金鑰,▾ 中的 AI 工具也會開啟同一個對話方塊。
在右鍵選單中
資料庫列、文件項目或大綱項目,以及品質、TBD/TBR 或待審查關聯列的右鍵選單,開頭會有最多三個建議動作(非 AI 動作如檢查連結…或解決 TBD…優先),每個動作右側附有原因。這些動作來自實體的狀態,不需呼叫 AI,因此選單會立即開啟:修正未通過品質準則的改寫(例如✦ 新增可量測的標準…,「未通過:Unambiguous」)、沒有 verified by 關係的需求的✦ 產生測試案例…、沒有子項的需求的✦ 產生子需求…,以及子 Action 沒有流程的 Action 的✦ 建議流程…。沒有適用的動作時,選單會建議✦ 用 AI 檢查…(需求)和✦ 就此詢問 AI…,後者會以實體為內容脈絡開啟詢問 AI,並預先帶入問題。✦ 更多 AI ▸會列出該實體的每個 AI 動作。✦ AI 控制項關閉時,AI 部分會是一列變暗的✦ AI 動作:,附有相同的原因。規則和完整清單請參閱模型和資料庫。
在多個所選項目上
選取多列或多個文件項目(⌘ / Ctrl-按一下或 ⇧ / Shift-按一下;在 Windows 和 Linux 上為 Ctrl-按一下),然後在其中一個上按一下右鍵,或使用資料庫大量操作列開頭的 ✦ AI ▾。選單的 ✦ 群組會作用於整個選取範圍;每個標籤會顯示其適用的項目數量,不適用於任何項目的動作會變暗並附上原因(例如「未選擇需求」)。
| 動作 | 功能 | 預覽 |
|---|---|---|
| ✦ 用 AI 檢查(n 項需求)… | 審查所選的需求,每個請求 20 個。 | 每項 AI 功能中所述的審查表格。 |
| ✦ 改寫 (n) ▸ | 對所選的需求和陳述執行一個改寫工具,每個工具都標示其數量(改寫得更清楚、新增可量測的標準(僅限需求)、簡化、拆分複合需求、草擬理由、建議名稱),每個請求 10 個(拆分為 5 個)。 | 一份清單,每個項目有一個核取方塊,並顯示每項變更的逐字差異。拆分會在項目下方顯示其各部分;第 1 部分取代該項目,其他部分新增在其後。沒有建議變更的項目會顯示「未建議任何變更。」 |
| ✦ 產生測試案例 (n)… | 為每個所選需求撰寫一個測試案例,每個請求 10 個。 | 一份清單,每個需求有一個核取方塊:測試案例名稱(可編輯)、方法、步驟、設定和預期結果。已有 verified by 測試案例的需求會被排除,除非您勾選包含已驗證的 (n)。每個建立的測試案例狀態為 Not Run,並 verifies 其需求;其方法會作為標籤加到需求上(已鎖定、已核准或已納入基準線的需求除外)。 |
| ✦ 就這些詢問 AI (n)… | 以所選項目為內容脈絡開啟詢問 AI,並預先帶入問題「關於這 n 個項目:」。 | 僅回答。最多傳送 50 個項目;面板會顯示數量。 |
| ✦ 建議追溯 (n)… | 在所選項目之間建議遺漏的關係,只使用結構描述允許其類別之間的關係(satisfied by、verified by、traced to、decomposed by、specified by、performed by)。最多 150 個項目。 | 一份建議關係清單,每項附有原因。連到已鎖定、已核准或已納入基準線項目的關聯一開始不勾選。 |
套用所選項會將勾選的列套用為一個復原步驟。已鎖定、已核准和已納入基準線的項目,以及含有網址的建議,一開始不勾選。
最多同時執行 3 個請求,因此 50 個需求約只需三分之一的時間。超過 50 個項目時會先要求確認,因為執行需要多個請求。進度對話方塊會顯示已完成的項目和批次數量;取消會停止所有請求,預覽會顯示目前為止的結果。若某個請求失敗,預覽會顯示其他結果,並列出未處理的項目(例如「項目 21–40 未審查」)。
每項 AI 功能
| 位置 | 特性 | 套用前您會審查的內容 |
|---|---|---|
| 頂端列,每個專案頁面 | 詢問 AI | 僅回答;不會變更任何內容。 |
| 文件、資料庫和項目檢視,選取需求時(▾) | 改寫得更清楚…、新增可量測的標準…、簡化…、草擬理由…、建議名稱… | 目前、變更(逐字差異)、建議(套用前可編輯)和 AI 的說明。套用。 |
| 同上,需求或陳述 | 拆分複合需求… | 每個部分附名稱和文字;項目 1 取代原項目,其餘新增在其後。拆分需求。不需拆分的陳述會顯示無可拆分內容。 |
| 同上,需求 | 用 AI 檢查(此需求)… | Correct、Feasible、Necessary、Unambiguous 和 Verifiable,附原因和選用的改寫。Unambiguous 和 Verifiable 只報告規則檢查遺漏的部分;接受的 No 會在品質頁面列為 AI 發現事項。只有在值會變更處才有核取方塊,每個都標示其效果;改寫一開始不勾選。套用所選項。 |
| 同上,陳述或需求 | 產生子需求… | 模式(子項(向下一層)或同層項(同一層))、數量(1–20)、內容脈絡;接著是可編輯的卡片。新增所選項。 |
| 同上,需求 | 產生測試案例… | 編號、名稱、步驟(依序)、設定、預期結果、驗證方法(為需求新增標籤)。建立測試案例。 |
| 同上,任何所選項目 | 產生風險… | 挑選最多 3 個候選風險(下一步:詳細資料),然後編輯編號、名稱、類別(專案的風險類別)、說明、後果描述、後果 %和機率 %。新增所選風險;每個風險會與該項目建立關係(caused by)。 |
| 文件和項目檢視(▾) | 產生需求… | 使用目標項目、內容脈絡、父需求(1–20)、每個父項的子項數(0–10)、需求類型(Environmental、Functional、Interface、Performance、Reliability、Safety、Verification)、指引、將新需求與目標建立關係 (traced to);接著是可編輯的卡片。新增所選項(建立為 Draft)。 |
| 文件(▾) | 摘要文件… | 區段、詳細程度(低、中或高,約 1–3 段)、語言;接著是審查重點,然後是摘要預覽。儲存為文件開頭的陳述Document Summary(S.0)。 |
| 文件(▾) | 翻譯文件… | 語言(18 種語言或自訂…)、新的編號、名稱和說明;接著是並排預覽。另存為新文件會建立副本;原文件不變。 |
| 文件(▾) | 用 AI 檢查(n 項需求)… | 同上,適用於文件中的每個需求。 |
| 文件撰寫 ▾ | ✦ 產生子需求…、✦ 產生需求…、✦ 產生風險…、✦ 產生測試案例…、✦ 摘要…、✦ 翻譯… | 同上。 |
| 文件分割對話方塊 | ✦ 建議分割 | 填入分割列;您可以編輯後按套用。 |
| 品質(▾) | 用 AI 檢查(n 項需求)… | 同上,適用於清單中的需求。 |
| 首頁(▾) | ✦ 撰寫專案摘要 | 專案摘要中的簡報(自最新基準線以來的變更、有風險的內容、接下來的三個動作,附連結)。保留在首頁上會將其保留在專案摘要面板中,在那裡重新撰寫會取代它。 |
| 匯入,對應步驟(▾) | 建議對應 | 建議的對應:每個變更的欄一列已勾選的列,附原因。套用已勾選項目。 |
| 貢獻(▾) | ✦ 彙總此小組的工作…、✦ 彙總此成員的工作… | 記錄活動的摘要;模型中不會有任何變更。請參閱貢獻。 |
| 功能分析(▾,當集合有功能時) | 使用 AI 審查和擴充功能… | ✦ 審查和擴充功能:發現事項,接著是現有功能(Keep、Changed)以及編號接在最高編號之後的新功能(New);建議的重新命名、分割、合併和移動(Suggested)只有在勾選時才會套用。一次復原即可全部撤回。 |
| 功能分析(▾) | 使用 AI 擷取功能… | ✦ AI 提出的功能:每個需求的功能,套用前可編輯。 |
| 功能分析(▾) | 使用 AI 建議流程… | ✦ AI 建議的流程:建議的流程和理由。取代受保護的流程需要選擇加入。 |
| 可追溯性矩陣(▾) | 審查關聯 | 關聯審查清單:遺漏的關聯(儲存格中的 +)和可疑的現有關聯(儲存格中的 ?),每項附有信心度和原因。在清單中勾選或按一下已標記的儲存格;套用 N 項變更會建立和移除關聯,一次復原即可全部撤回。低於 50 % 的建議和涉及受保護項目的建議一開始不勾選。 |
| 權衡研究(▾) | 根據需求和 MOE 建議準則…、草擬決策理由… | 建議的準則;記錄對話方塊中的草擬理由(那裡也有草擬按鈕)。 |
| Risk 圖工具列(以及 ▾),和矩陣儲存格面板中的 ✦ 產生風險 | ✦ 產生風險 | 目標實體、內容脈絡和風險數量(1–10,預設 5),使用專案的風險類別,針對根或所選儲存格;接著是檢視建議的風險,然後是建立所選項目。 |
| 白板(▾,或選取便利貼時的選取工具列) | 收集需求… | 勾選使用 AI 草擬「shall」陳述,新增選用的指引,草擬陳述;編輯每個名稱和陳述。建立需求。 |
| 白板美工圖案面板 | ✦ 使用 AI 產生… | 說明、樣式、色彩配置、檢視、變體(1–8);挑選一個變體,然後新增到圖庫或新增並插入。也可使用重新產生、調整…和停止。 |
| 豐富文字編輯器的 ✦ 按鈕 | 改善措辭、簡化、修正拼字和文法、縮短、新增詳細資訊、完成句子、以某種語氣改寫…、翻譯…、翻譯全文…、使用 AI 撰寫… | 目前、建議、變更;重試、捨棄或取代。使用 AI 撰寫…會要求輸入提示和語氣,然後建立預覽和插入。 |
以某種語氣改寫…和使用 AI 撰寫…的語氣:學術、果斷、隨性、自信、建設性、同理、振奮、流暢、正式、友善、激勵、專業。
頁面專屬的詳細資訊請參閱說明:功能分析、可追溯性矩陣、權衡研究、風險登錄表、白板和白板美工圖案。
預覽和核准
- 在您確認之前不會套用任何內容。關閉或取消預覽不會變更任何內容。
- 一次復原即可全部撤回。每項套用的 AI 變更都能以一次復原撤回,不論涉及多少項目。
- 受保護項目需選擇加入。某些變更會醒目標示且一開始不勾選:
- 對 Approved、已納入基準線(在文件基準線中)或已鎖定項目的變更;
- 關聯移除(功能分析的重新指派);
- 含有網址的建議。
此類的單一變更會顯示如「仍然套用此變更(…)」的方塊。
- 輸入橫幅。當輸入包含匯入檔案的文字、其他人的變更、AI 參考檔案或隱藏文字時,預覽會顯示橫幅。
- 經過檢查的回覆。每個回覆在您看到之前都會經過檢查。格式錯誤、文字過多或含有請求中沒有的 ID 的回覆會被拒絕(「AI 回應被拒絕…」)。不會有任何變更。文字會依其去處進行清理:不含指令碼、影像、框架或連到其他網站的連結。
- 需求文字遵循品質檢查。撰寫需求文字的請求(改寫得更清楚、新增可量測的標準、簡化、拆分、產生和產生子需求、AI 需求檢查中的改寫、文件中的 AI 分割,以及白板上的收集需求)會列出品質檢查的措辭規則及其字詞清單。仍違反規則的建議會連同檢查器的發現事項退回一次,並顯示較佳的回覆。預覽會在每個建議陳述下方顯示檢查器的結果:「✔ 通過品質檢查器的措辭規則。」或「品質檢查器:…」及其發現事項;它會隨您編輯而更新。需要關聯或審查者的規則(驗證用的測試案例、重複項、Correct、Feasible)不屬於此檢查。
- 詢問 AI 顯示文字。只有連到 Holarch 頁面和說明主題的連結可以按一下;網址保持為純文字。
專案文字如何與指示分開,請參閱AI 如何處理不受信任的內容。
AI 金鑰
供應商
| 供應商 | 欄位 |
|---|---|
| AI 服務商 API | API 金鑰 |
| Kimi API | API 金鑰、區域(請參閱使用您自己金鑰的 Kimi K3) |
| GLM API | API 金鑰(請參閱使用您自己金鑰的 GLM 5.3) |
Holarch 的 AI 使用其預設模型;在託管服務上,來自中國大陸、香港、澳門和台灣的請求使用 GLM 5.3(中國大陸的 AI)。Kimi K3 與 GLM 5.3 是您可以開啟的選項。在組織中,它們在組織管理員逐一開啟之前都是關閉的(請參閱組織中的 Kimi K3 與 GLM 5.3)。
自行託管的安裝環境也可以提供 雲端平台託管的 AI(您的 AWS 帳戶)(請參閱透過雲端平台託管的 AI(您的 AWS 帳戶))。app.holarch.app 的託管服務則不提供。
多個金鑰:標示為偏好的金鑰會回應每個請求。另一個金鑰旁的使用此金鑰會切換到該金鑰;當清單中已有金鑰時,新增金鑰會詢問新金鑰是否用於 AI 請求(將此金鑰用於 AI 請求,預設為開啟)。
目前不支援 OpenAI、Gemini 和 Azure OpenAI 金鑰(原因)。先前為其中之一新增的金鑰會保留在清單中,並標示「目前不支援 Name 金鑰。您的金鑰已保留;如不再需要,請將其刪除。」該金鑰不會被使用;移除會刪除它。
每個金鑰表單也有每月限制(權杖)(留空表示不限制;至少 1,000,最多 10,000,000,000)。
您的金鑰
您的金鑰會在帳戶設定 → AI 金鑰和 AI 設定中列出您的金鑰。每個金鑰會顯示:
- 供應商,當您有多個供應商的金鑰時會標示偏好。
- 金鑰:最後 4 個字元。供應商拒絕時會出現上次使用時被拒絕。
- 新增者和上次使用。
- 本月:已使用的權杖、限制的「of」,以及已達限制。
按鈕:
- 測試會傳送一個簡短的請求:「✓ 正常(1.2 秒)」或「✕」及原因。
- 移除會詢問「移除末碼為 … 的 … 金鑰?之後您的請求將使用組織金鑰(如有),否則使用您方案中包含的 AI。」並需要最近的密碼驗證。快顯通知:「已移除 AI 金鑰。」
每個供應商可以有一個金鑰。為已有金鑰的供應商新增金鑰會取代原有的金鑰。您的第一個金鑰是偏好的金鑰。
沒有金鑰時:「您沒有自己的金鑰。」
組織金鑰
組織金鑰讓成員不需要自己的金鑰即可使用 AI。組織管理員可在帳戶頁面的組織 → 組織金鑰下新增、測試和移除這些金鑰。表單與您自己的金鑰相同。頁面會註明:「… 中沒有自己金鑰的成員會使用此金鑰。」
成員只會看到有哪些組織金鑰:「組織金鑰:AI 服務商 API(…abcd)。在您沒有自己的金鑰時使用。」沒有組織金鑰時,他們會看到「沒有組織金鑰。沒有自己金鑰的成員使用其方案中包含的 AI。」
本月依成員統計的使用情況會列出成員、請求、權杖、費用(估算)和限制,並有總計列,位於每位成員每月限制的控制項下方(請參閱成員限制)。
使用哪一個金鑰
伺服器會依下列順序為每個請求挑選一個金鑰:
- 您自己的金鑰,若您已新增。
- 您組織的金鑰。在屬於您所屬組織的專案中,會使用該組織的金鑰。在此類專案之外,若您恰好只屬於一個組織,會使用該組織的金鑰。已關閉 AI 的組織不會將其金鑰借給任何人。
- 包含的 AI:Holarch 自己的金鑰,含本月包含的請求(請見下方)。
- 無:AI 功能關閉。
在 Free 方案中,步驟 1 和 3 只適用於使用學術電子郵件地址的帳戶以及作用中班級組織的成員。其他 Free 帳戶無法新增自己的金鑰,AI 功能會要求他們選擇方案(請參閱包含的 AI)。使用中的金鑰會顯示「無。新增金鑰前 AI 功能會關閉。」
AI 設定和帳戶頁面中的使用中的金鑰會顯示結果,例如您的金鑰:AI 服務商 API(…abcd)、SYSE 682 的組織金鑰:AI 服務商 API(…wxyz)或包含的 AI:快速模型。
包含的 AI
Individual 和 Team 方案每月包含一定數量的 AI 請求,由 Holarch 的 AI 透過 Holarch 自己的 AI 服務商 API 金鑰回答。不需要金鑰。來自中國大陸、香港、澳門和台灣的請求則由 GLM 5.3 透過 Holarch 自己的 Z.ai 金鑰回答,請求數量相同(中國大陸的 AI)。
| 方案 | 包含的 AI |
|---|---|
| Free | 無;也無法使用您自己的金鑰 |
| 使用學術電子郵件地址的 Free,或作為作用中班級組織的成員 | 每月最多 75 個 AI 請求,快速模型;可新增您自己的金鑰 |
| Individual | 每月最多 150 個 AI 請求,標準模型 |
| Team | 每個席位每月最多 300 個 AI 請求,標準模型;繁重工作使用進階模型(一個請求計為 2 個) |
- Free 方案上的 AI:AI 功能會顯示「AI 隨 Individual 和 Team 方案提供。開始 30 天免費的 Individual 試用,或選擇方案。」並提供開始試用和選擇方案…。若您已使用過試用:「AI 隨 Individual 和 Team 方案提供。在『帳戶設定 → 方案與帳單』中選擇方案。」在 Individual 試用期間,適用 Individual 方案包含的 AI。
- 學術電子郵件地址:已驗證地址結尾為 .edu、.edu.country 或 .ac.country,或屬於列名大學的 Free 帳戶,可保留包含的 AI 和自己的金鑰。透過其組織單一登入的帳戶則依循其組織。帳戶設定 → 方案與帳單會顯示「學術電子郵件:Free 方案包含 AI,每個專案可有擁有者和最多 6 名受邀編輯者」。
- MCP 用戶端和 REST API 隨 Individual 和 Team 方案提供,在 Free 方案中則適用於使用學術電子郵件地址或屬於作用中班級組織的帳戶(與保留 AI 的帳戶相同):它們使用您自己用戶端的 AI,而非 Holarch 的 AI。請參閱 API 和 MCP。
- 一個請求是使用一次 AI 功能:一個詢問 AI 問題、草擬需求、建議流程、對所選項目的批次動作。一個問題就是一個請求,即使詢問 AI 分多個步驟讀取專案也一樣;分成多個部分傳送的批次,以及 Holarch 因回覆格式錯誤而再次詢問,也只計一次。失敗的請求不計入。
- PDF 規格匯入:依檔案長度計算,在每個方案上(包括具有包含 AI 的 Free 帳戶)都以標準模型回答,因為遺漏一個需求的代價高於兩者的差價。Holarch 每次讀取檔案 5 頁,每個部分都會再次讀取整個檔案,因此檔案越長計數越多:約 30 頁以內每 5 頁一個請求(10 頁:2 個請求;25 頁:5 個),之後每 5 頁更多(100 頁:30 個請求;200 頁:90 個)。執行前,Holarch 會顯示將使用的數量,例如「此匯入會使用您本月剩餘 140 個包含的 AI 請求中的 30 個(檔案越長,每 5 頁計數越多)。」所需請求多於剩餘數量的 PDF 不會開始;請將其拆分為較短的檔案。請參閱匯入 PDF 規格。
- AI 需求檢查:每 100 個需求一個請求(無條件進位)。檢查超過 100 個需求前,Holarch 會顯示將使用的數量,例如「此審查會使用您本月剩餘 52 個包含的 AI 請求中的 3 個(每 100 個需求 1 個請求)。」所需請求多於剩餘數量的檢查不會開始。
- 使用 AI 產生美工圖案:每個變體一次請求(4 個變體:4 次請求),在每個方案上都以快速模型繪製。
- SysML v2 模型問題(Individual 和 Team):每個問題一個請求,以您選擇的模型回答(標準模型,或 Team 方案上的進階模型,計為 2 個)。
- 查看位置:帳戶設定 → AI 金鑰和 AI 設定會顯示包含的 AI:快速模型 · 本月剩餘 52 / 75 個請求 · 11 月 1 日重設。
- 用完時:「您已用完本月 75 個包含的 AI 請求。它們會在 11 月 1 日重設。若需要更多,請在『帳戶設定 → AI 金鑰』中新增您自己的 AI 服務商 API 金鑰。」付費方案開賣後,Free 方案的訊息為「… 它們會在 11 月 1 日重設。Individual 每月包含最多 150 個使用標準模型的 AI 請求。請在『帳戶設定 → AI 金鑰』中新增您自己的 AI 服務商 API 金鑰,或在『帳戶設定 → 方案與帳單』中選擇付費方案。」並提供選擇方案…。請求會在每月 1 日(UTC)重設,不會累積到下個月。
- 來自 Holarch 的額外請求:當 Holarch 為您的帳戶(或您的組織)提供額外 AI 請求時,它們會在每月請求之後使用,最先到期的優先,Free 方案也一樣。AI 設定接著會加上它們,例如… 11 月 1 日重設 · 40 個額外請求,而帳戶設定 → 方案與帳單會列出它們及其到期日。未使用的請求到期前 7 天會有電子郵件提醒您。
- Team:進階模型。在模型下方,於此瀏覽器中選擇進階模型,用於繁重工作(2 次請求);標準模型是預設值。
- 僅限 Holarch 的功能。包含的 AI 只回答 Holarch AI 功能的請求。詢問 AI 會回答關於 Holarch 和您模型的問題,對其他問題則以問題的語言用一個簡短句子婉拒,說明它只回答關於 Holarch 和您模型的問題。其他 AI 功能只執行各自的工作。若有其他用途,請新增您自己的金鑰。資料量超過功能允許上限的請求會被拒絕,並顯示「此 AI 請求對包含的 AI 而言太大。請一次處理較少的項目,或使用您自己的 AI 服務商 API 金鑰。」
- 限制。每項功能都有最大回覆長度,詢問 AI 的問題限制為 2,000 個字元。
- 付費方案不會暫停。Individual 和 Team 在每月請求數以內都保有包含的 AI。在 Free 方案和 Individual 試用期間,包含的 AI 可能會暫停:當本月的 Free 使用預算用完時(直到 1 日),或 Holarch 將其暫停時。請求接著會顯示「Free 帳戶的包含 AI 已暫停至 11 月 1 日:本月的 Free 使用預算已用完。請在『帳戶設定 → 方案與帳單』中選擇付費方案,或在『帳戶設定 → AI 金鑰』中新增您自己的 AI 服務商 API 金鑰。」或「Free 帳戶的包含 AI 已暫停。請選擇付費方案 …」。付費方案開賣前,訊息只會提到您自己的金鑰。班級組織的成員依其自己的方案計算。
- 組織:關閉 AI 的組織也會關閉其專案中包含的 AI。
使用您自己的金鑰或組織金鑰發出的請求不計入包含的請求;AI 服務商會向該金鑰的帳戶收費。Holarch 為何選用這些模型:Holarch 如何選擇 AI 模型。
AI 設定
以 ✦ AI ▾ → AI 設定…、詢問 AI 中的 ⚙、⌘K / Ctrl+K → AI 設定…,或您的姓名縮寫 → AI 設定…開啟。
| 組成 | 內容 |
|---|---|
| AI 金鑰 | 使用中的金鑰;包含的 AI:模型和本月剩餘的請求(Team:模型、標準模型(1 次請求)或進階模型,用於繁重工作(2 次請求));本月:使用您自己的金鑰時,為其權杖(相對於每月限制)、請求和依定價估算的成本;使用組織金鑰時,為請求數,以及金鑰有每月限制時的已用比例;並有量表(從 80 % 起呈琥珀色)。當專案的組織關閉 AI 時,此專案會加以說明。 |
| 您的金鑰 | 供應商清單和您的金鑰(請見上方)。 |
| 在工作階段之間保留詢問 AI 的歷史記錄 | 在此瀏覽器中保留詢問 AI 的對話。清除它會刪除儲存的對話。 |
| 供 AI 使用的專案參考檔案 | 一份清單:每個檔案附其大小、在 AI 中使用和 ×;+ 檔案;使用中的檔案和字元數。 |
| 連結 | 使用哪個 AI 金鑰、AI 用量和限制、組織金鑰位於「帳戶 → AI 金鑰」 |
儲存會保留設定(「AI 設定已儲存」)。
AI 參考檔案
參考檔案會將背景資料(例如標準或工作說明書)加入 AI 提示中。若要設定,請參閱附加參考檔案。
- 檔案類型:.txt .md .csv .json .xml .html .docx .reqif。每個檔案最多保留 200,000 個字元。
- 開啟在 AI 中使用的檔案會加入詢問 AI 以及產生、擴充、測試案例、風險、摘要、插入內容和豐富文字工具中。它們合計最多傳送 100,000 個字元;使用中的檔案較長時,清單下方的一行會加以說明。
- 參考檔案依專案保存在此瀏覽器中。它們不會與其他成員共用。
- 「參考檔案超出瀏覽器儲存空間。請移除一個檔案或附加更小的檔案。」表示瀏覽器拒絕儲存它們。請移除檔案。
使用量和限制
| 限制 | 值 | 訊息 |
|---|---|---|
| 每人每分鐘的請求數 | 30 | 「AI 請求過多。請一分鐘後再試。」 |
| 每人同時執行的請求數 | 3 | 「已有三個 AI 請求正在執行。請 5 秒後再試。」 |
| 伺服器上執行的請求 | 共用容量 | 「AI 服務忙碌中。請 10 秒後再試。」 |
| 每月包含的 AI | 您方案的請求數(請參閱方案和限制) | 「您已用完本月內含的 75 個 AI 請求。它們會在 11 月 1 日重設。如需更多,請在帳戶設定 → AI 金鑰中新增您自己的 AI 服務商 API 金鑰。」(數字依您的方案而定) |
| 每個金鑰的每月權杖數 | 由金鑰擁有者設定 | 「此金鑰已達每月 AI 限制。請在『帳戶 → AI 金鑰』中提高金鑰的限制,或等到下個月。」 |
| 每位成員的每月限制 | 由組織的管理員設定(請參閱成員限制) | 「您已達到在 Acme 的每月 AI 限制(40 個請求中已用 40 個)。Acme 的管理員可在『組織設定 → AI』中提高限制。限制將於 12 月 1 日重設。」 |
| 提示大小 | 600,000 個字元 | — |
| 回覆大小 | 400,000 個字元 | 「AI 回覆過長(超過 400,000 個字元)。」 |
月份是 UTC 的日曆月。組織管理員可在帳戶頁面查看依成員統計的使用量。當有多個限制適用時,最先達到的限制會停止請求:金鑰的每月限制、成員限制,以及內含 AI 的方案額度。
成員限制
管理員可以為他們付費使用 AI 的人員設定每月 AI 限制:適用於所有人的預設值,以及為需要更多、更少或不設限的人設定的自訂限制。
位置:組織管理員:組織設定 → AI → 本月依成員統計的使用情況,或帳戶頁面組織下的組織卡片。在自行託管的伺服器上,網站管理員也可以在管理員 → AI 支出與使用情況 → 每人每月 AI 限制中為組織以外的人員設定限制。
限制涵蓋的範圍:
- 組織的限制:透過其組織金鑰付費的 AI(任何提供者:AI 服務商、Kimi、GLM、雲端平台託管的 AI),在託管服務上還包括持有其 Team 席位之成員的內含 AI;在自行託管的伺服器上,也包括用於該組織工作的伺服器自有 AI 金鑰(其專案中,或只屬於該組織的人員在任何地方的使用);
- 自行託管伺服器自身的限制:在組織以外使用的伺服器 AI;
- 絕不包括個人自己的金鑰:那些由他們自己付費。
內含 AI 仍適用方案的每月額度。限制可以降低額度,但絕不會提高。
設定預設值:
- 選擇單位:請求(每個使用者動作算一次,與內含 AI 的計算方式相同)、權杖(輸入和輸出)或US$(成本估算)(依提供者的牌價計算)。
- 輸入每位成員的預設限制。留空表示不限制。
- 按一下儲存。通知會顯示「已儲存限制。」
變更單位會清除預設值和所有自訂限制(「將單位變更為 … 會清除預設限制和所有自訂限制。設為『無限制』的成員會保留該設定。」)。
設定某人的限制:在該人員的列中按一下編輯…,選擇使用預設值、無限制,或輸入數字並選擇自訂限制,然後按儲存。自訂限制會在限制欄中顯示自訂;使用預設值會將其移除。限制為 0 會停止該人員由組織付費的 AI。
尋找人員:依名稱或電子郵件篩選,並顯示所有人、已用 80% 以上的人、已達上限的人,或有自訂限制的人。限制欄會以「已用量 / 限制」並搭配長條顯示(80 % 起為琥珀色,達到限制時為紅色)。
成員可在帳戶設定 → AI & API(以及 AI 設定)中查看自己的使用量:每月限制(Acme):「40 個請求中已用 12 個 · 12 月 1 日重設」並搭配長條;用完後會顯示「已達限制。Acme 的管理員可以提高限制。」
通知:達到限制的 80 % 和 100 % 時,該人員會在鈴鐺中收到通知(位於您的帳戶下),除非其電子郵件通知為關閉,否則會立即寄出電子郵件;當有人達到限制時,組織的管理員(自行託管伺服器自身的限制則為網站管理員)會收到一則指出該人員的通知。每人每月每種通知各一則。
網站管理員不受限制。每次變更都會記錄在稽核記錄中(org.ai-limit;自行託管伺服器自身的限制為 admin.ai-limit),包含變更前後的值。
AI 使用記錄(時間、功能、模型、權杖和估算成本;絕不包含提示或回覆)會在 13 個月後刪除。
AI 權限
AI 權限決定 AI 可以做什麼,每種請求各有一個開關:
| 開關 | 允許的內容 | 傳送專案資料 |
|---|---|---|
| 說明與操作指南 | 詢問 AI 會依據說明、Docs 和功能清單回答關於使用 Holarch 的問題。 | 否 |
| 有關專案的提問 | 摘要、說明、品質和缺口檢查、關於專案的詢問 AI。不會變更任何內容。 | 是 |
| 建議與變更 | 每個提出編輯建議的工具:改寫、產生、翻譯、建議關聯、功能和流程、風險、測試案例。每項變更仍會先預覽。需要有關專案的提問。 | 是 |
| AI 中的參考檔案 | 專案的 AI 參考檔案會加入使用它們的提示中。 | 檔案 |
預設組合:關閉(無 AI)、僅說明、唯讀(說明和有關專案的提問)、完整(全部四項),以及用於其他任何組合的自訂。
唯讀仍會將專案內容傳送給 AI 供應商。它只會阻止 AI 提出變更。僅說明不會傳送任何專案資料。
由誰設定:
- 組織設定 → AI(組織管理員):組織的每個專案。請參閱管理。
- 管理員 → AI 設定 → AI 權限(自行託管安裝環境的管理員):安裝環境上的每個人。
- 帳戶 → AI 和 API → AI 權限(帳戶持有人):您自己的 AI 請求,以及不屬於任何組織的您的專案。
- 共用 → AI 權限(專案擁有者):單一專案。擁有者只能關閉更多項目。
請求在每個適用層級的開關都必須開啟,因此任何層級都無法重新開啟另一個層級已關閉的項目。編輯器會將此類開關顯示為關閉且停用,並註明是誰關閉的。
開關關閉時:
- 其在 ✦ AI ▾、右鍵選單和大量操作列中的工具會呈灰色並附上原因,例如「此組織的 AI 變更已由其管理員關閉。」;
- 被要求變更某些內容時,詢問 AI 會回答「此處已關閉 AI 變更。」;
- 只開啟說明與操作指南時,詢問 AI 會回答關於使用 Holarch 的問題,且不傳送任何專案內容;
- 伺服器也會拒絕此類請求,不論使用哪個金鑰。
受限的機密等級標示仍會為已標示的專案關閉 AI,不論開關如何設定。透過 MCP 連接的 AI 工具遵循相同的開關:其讀取工具需要有關專案的提問,其寫入和提案工具需要建議與變更。被拒絕的工具呼叫會傳回相同的訊息,例如「此組織的 AI 變更已由其管理員關閉。」一般 API 呼叫(指令碼和整合)不是 AI 請求,不受 AI 權限限制;組織的 API 存取開關涵蓋它們。對 AI 權限的每項變更都會記錄在稽核記錄中。
組織設為關閉時,任何人都不會使用該組織的金鑰,其專案中的 ✦ AI 控制項也會關閉,並顯示「此組織的 AI 已由其管理員關閉。」當專案的擁有者之一在共用 → 組織下選擇某個組織時,專案即屬於該組織。
透過雲端平台託管的 AI(您的 AWS 帳戶)
雲端平台託管的 AI 會在您自己的 AWS 帳戶中執行 Holarch 的預設模型,包括 AWS GovCloud (US)。自行託管的安裝環境在其管理員開啟時會提供此選項。託管服務不提供。
新增雲端平台金鑰:帳戶 → AI 金鑰 → 新增金鑰,供應商選 雲端平台託管的 AI:AWS 區域、存取金鑰 ID、秘密存取金鑰和選用的模型 ID。Holarch 會在儲存前測試金鑰。金鑰清單會顯示區域和存取金鑰 ID 的最後 4 個字元。管理員也可以為整個安裝環境提供自己的雲端平台 AI 存取;使用中的金鑰接著會顯示此安裝環境:雲端平台託管的 AI(us-gov-west-1)。您自己的金鑰和組織金鑰仍然優先。
在 AWS GovCloud 中,模型 ID 與商業區域不同:請輸入您的 AWS 帳戶為該模型列出的模型或推論設定檔 ID。
每項 AI 功能都可透過雲端平台託管的 AI 運作,包括 PDF 規格匯入。有一項功能無法使用:當模型拒絕請求時,Holarch 無法將其改送到另一個模型,工具會顯示「模型已拒絕」。
| 訊息 | 意義與修正方式 |
|---|---|
| 「雲端平台託管的 AI:存取遭拒(…)」 | AWS 憑證無法呼叫該模型。請檢查 IAM 權限,並確認該模型已在該區域為帳戶啟用。 |
| 「雲端平台託管的 AI:… 在此區域不適用於此 AWS 帳戶。」 | 請輸入帳戶在該區域列出的模型或推論設定檔 ID。 |
| 「雲端平台託管的 AI:找不到 AWS 憑證。…」 | 設定存取金鑰或 AWS 設定檔。 |
| 「輸入 AWS 區域,例如 us-east-1 或 us-gov-west-1。」 | 修正區域。 |
使用您自己金鑰的 Kimi K3
Holarch 的預設模型是 Holarch 的 AI,包含的 AI 也使用預設模型;在託管服務上,來自中國大陸、香港、澳門和台灣的請求則使用 GLM 5.3(中國大陸的 AI)。Kimi K3(Moonshot AI)是經驗證合格的選項,可搭配您自己或您組織的 Moonshot 金鑰使用,例如在無法使用預設模型的地方。適用與所有自備金鑰相同的方案規則。使用 Kimi 金鑰時,請求會以該金鑰傳送至 Moonshot,絕不會傳送至 Holarch 的預設 AI 服務商;詢問 AI 面板會顯示 Kimi K3(您的金鑰)或 Kimi K3(組織金鑰)。使用 Kimi 金鑰的請求會傳送至 Moonshot AI:您的提示及其中包含的專案內容會傳送至 Moonshot AI,並依您或您組織與 Moonshot AI 之間的協議處理。金鑰表單會顯示此通知,對 Kimi 金鑰按使用此金鑰時會要求您確認一次。在自行託管的安裝中,只有在管理員開啟 Kimi 時才能使用。
新增 Kimi 金鑰:帳戶 → AI 金鑰 → 新增金鑰(或 AI 設定…),提供者選 Kimi API:API 金鑰與區域:
- 在 platform.moonshot.ai 上建立的金鑰選 國際 (api.moonshot.ai);
- 在 platform.moonshot.cn 上建立的金鑰選 中國大陸 (api.moonshot.cn)。
金鑰只能在其建立的區域中使用。Holarch 會在儲存前測試金鑰;金鑰清單會顯示區域與最後 4 個字元。組織的金鑰在組織設定 → AI下以相同方式運作。在自行託管的安裝中,管理員也可以為整個安裝提供其自己的 Kimi 金鑰;使用中的金鑰接著會顯示 此安裝 · Kimi API (api.moonshot.cn)。您自己的金鑰與您組織的金鑰仍會優先使用。若要改回預設模型,請按一下您 AI 服務商 API 金鑰旁的使用此金鑰,或移除 Kimi 金鑰。
AI 權限、受限機密等級標示、預覽與一次復原在 Kimi 上的運作方式相同,其使用量會計入本月使用量。
模型為 Kimi K3。Kimi 會先推理再回答。Holarch 在 Kimi 撰寫新內容(新需求、測試案例、風險、功能與流程)時要求較多推理,而在詢問 AI、AI 需求檢查、可追溯性審查、改寫、翻譯與摘要時要求較少推理。回答所需時間比 Holarch 的預設模型長:通常為 10 到 60 秒。
新需求、改寫、測試案例與風險會以專案需求的語言撰寫,並使用該語言具約束力的情態動詞(例如中文的「应」)。
PDF 規格書匯入需要 Holarch 的預設模型(AI 服務商 API 或雲端平台託管的 AI)。
| 訊息 | 意義與修正方式 |
|---|---|
| 「Kimi API:API 金鑰遭拒(HTTP 401)。」 | 金鑰來自另一個區域,或已被撤銷。請檢查區域,或在該區域的平台上建立金鑰。 |
| 「選擇 Kimi 區域:國際或中國大陸。」 | 選擇一個區域。 |
| 「AI 回應時間過長。」 | 選取較少的需求,然後再次執行檢查。 |
使用您自己金鑰的 GLM 5.3
GLM 5.3(Z.ai)是 Kimi K3 之外的第二個經驗證合格的選項,可搭配您自己或您組織的金鑰使用。包含的 AI 仍使用 Holarch 的預設模型(來自中國大陸、香港、澳門和台灣的請求,包含的 AI 也是 GLM 5.3:中國大陸的 AI),並適用與所有自備金鑰相同的方案規則。使用 GLM 金鑰時,請求會以該金鑰傳送至 Z.ai,絕不會傳送至 Holarch 的預設 AI 服務商;詢問 AI 面板會顯示 GLM 5.3(您的金鑰)或 GLM 5.3(組織金鑰)。您的請求會依您與 Z.ai 之間的協議傳送至 Z.ai(新加坡):您的提示及其中包含的專案內容會傳送至 Z.ai,並在新加坡處理。金鑰表單會顯示此通知,對 GLM 金鑰按使用此金鑰時會要求您確認一次。在自行託管的安裝中,只有在管理員開啟 GLM 時才能使用。
新增 GLM 金鑰:帳戶 → AI 金鑰 → 新增金鑰(或 AI 設定…),提供者選 GLM API,並貼上來自 Z.ai 國際平台(z.ai)的 API 金鑰。請求會傳送至 api.z.ai。來自中國大陸服務(open.bigmodel.cn)的金鑰屬於另一項服務,無法使用。Holarch 會在儲存前測試金鑰;金鑰清單會顯示最後 4 個字元。組織的金鑰在組織設定 → AI下以相同方式運作。在自行託管的安裝中,管理員也可以為整個安裝提供其自己的 GLM 金鑰;使用中的金鑰接著會顯示 此安裝 · GLM API (api.z.ai)。若要改回預設模型,請按一下您 AI 服務商 API 金鑰旁的使用此金鑰,或移除 GLM 金鑰。
AI 權限、受限機密等級標示、預覽與一次復原在 GLM 上的運作方式相同,其使用量會計入本月使用量。
模型為 GLM 5.3。它一律會先推理再回答;Holarch 在它撰寫新內容(新需求、測試案例、風險、功能與流程)時要求較多推理,而在詢問 AI、AI 需求檢查、可追溯性審查、改寫、翻譯與摘要時要求較少推理。回答所需時間與 Holarch 的預設模型差不多。預設模型能將需求更深入地分解為子需求。新內容會以專案需求的語言撰寫,TBD 與 TBR 在每種語言中都維持原樣。
PDF 規格書匯入需要 Holarch 的預設模型(AI 服務商 API 或雲端平台託管的 AI)。
| 訊息 | 意義與修正方式 |
|---|---|
| 「GLM API:API 金鑰遭拒(HTTP 401)。」 | 金鑰已被撤銷,或是來自 open.bigmodel.cn 的金鑰。請在 z.ai 上建立金鑰。 |
組織中的 Kimi K3 與 GLM 5.3
Holarch 的 AI 使用其預設模型;在託管服務上,來自中國大陸、香港、澳門和台灣的請求使用 GLM 5.3。Kimi K3 與 GLM 5.3 是您可以開啟的選項。在組織中,兩者在組織管理員於組織設定 → AI → 選用的 AI 提供者下逐一開啟之前都是關閉的(請參閱在組織中允許 Kimi K3 或 GLM 5.3)。沒有組織時,您可在閱讀資料通知後自行決定。
- 為組織工作(其專案與其金鑰):由該組織的設定決定,無論使用誰的金鑰。
- 您自己的工作(個人專案、您自己的金鑰):您所屬的每個組織都必須已開啟該提供者。
- 新增金鑰仍會列出已關閉的提供者,並標示 (已由您的組織關閉)。選擇它會顯示「Organization 已關閉 provider,因此無法新增其金鑰。Organization 的管理員可在「組織設定 → AI」中開啟它。」,且測試並儲存保持停用。
- 您先前新增的金鑰在其提供者關閉期間會保留,並標示「未使用:Organization 已關閉此提供者。…」,且沒有測試或使用此金鑰。提供者一開啟,它就會再次運作。
當 Holarch 為組織設定 AI 時(請參閱下一節),改由該設定決定。
由 Kimi K3 為您的組織提供的 AI
對於某些組織,Holarch 會自行設定 AI,例如該公司無法使用 Holarch 的預設模型時。AI 設定與帳戶頁面中的使用中的金鑰,以及詢問 AI 面板,接著會顯示 您組織的 AI 由 Kimi K3 提供。組織管理員可在組織設定 → AI下看到此設定及其原因。
當您屬於這類組織時,您提出的每個 AI 請求都會使用 Kimi K3,在您的個人專案與其他組織的專案中也一樣:
- 透過 Holarch 使用 Kimi K3:由 Holarch 自己的 Kimi 金鑰回應。請求會計入您方案包含的 AI 請求與您的 AI 請求包,與包含的 AI 相同,且只執行 Holarch 的 AI 功能。
- 組織自己的 Kimi 或 GLM 金鑰:組織管理員在組織設定 → AI下新增 Kimi(Moonshot AI)或 GLM(Z.ai)金鑰(請參閱使用您自己金鑰的 Kimi K3與使用您自己金鑰的 GLM 5.3)。只有此選項時,使用中的金鑰會顯示 您組織的 AI 使用其自己的 Kimi(Moonshot AI)或 GLM(Z.ai)金鑰。在新增金鑰之前,AI 功能會要求您聯絡組織管理員。
- 關閉:AI 功能會顯示「Holarch 已為您的組織關閉 AI。」其他一切照常運作。
不使用預設模型:個人與組織的預設 AI 服務商金鑰及雲端平台金鑰不會被使用且無法新增,新增金鑰只在設定允許的情況下提供 Kimi(Moonshot AI)與 GLM(Z.ai)金鑰,PDF 規格書匯入(需要預設模型)無法使用,透過 MCP 連接的 AI 應用程式會被拒絕。AI 權限、受限機密等級標示、預覽與一次復原照常運作。
只有 Holarch 能變更此設定;組織管理員仍可在 AI 權限下關閉更多項目。具有此設定的組織無法由其管理員刪除。如有疑問,請寫信至 [email protected]。
安裝環境關閉 AI
自行託管安裝環境的管理員可以為所有人關閉 AI,例如在封閉網路上,方法是在管理員 → AI 設定下將 AI 權限設為關閉,或在伺服器設定中使用 HOLARCH_AI=off。HOLARCH_AI 也接受 help、read 或如 help,read,refs 的清單。關閉期間:
- ✦ AI 會關閉,並顯示「此安裝的 AI 已關閉。」;
- AI 工具、AI 設定…和詢問 AI 會開啟AI 已關閉,內容相同;
- 帳戶 → AI 金鑰會顯示相同的附註,且沒有新增金鑰;
- 不會傳送任何內容給 AI 供應商,伺服器也會拒絕 AI 請求。
Holarch 的其他所有功能照常運作。
隱私:傳送的內容
- 僅在請求時傳送。除非您啟動 AI 功能,否則不會傳送任何內容給 AI 供應商。
- 只傳送功能所需的內容。
- 需求工具會傳送需求、其父項、其驗證項和專案名稱。
- 詢問 AI 會傳送問題、Holarch 功能的說明、最多三個說明主題、專案的實體和關係(在較大型專案上:摘要加上問題所需的項目;操作方法問題不傳送專案資料)、目前頁面和最近的對話。
- 使用中的 AI 參考檔案會加入AI 參考檔案下所列的位置。
- 隱藏文字不會傳送。大小為零、不可見或白底白字的文字不會傳送。
- 傳送去處。請求會從 Holarch 伺服器傳送到 AI 服務商;使用 Kimi 金鑰時傳送到 Moonshot AI;使用 GLM 金鑰時,以及來自中國大陸、香港、澳門和台灣的包含 AI 請求,傳送到 Z.ai(新加坡)。適用該服務商的條款。請查看這些條款,包括供應商是否保留 API 資料或用其訓練。Holarch 不會使用您的內容訓練 AI 模型。
- Holarch 保留的內容。不保留提示文字或回覆。為了使用量和限制,它會為每個請求記錄時間、金鑰、工作、權杖數、估算成本和結果。只有在開啟在工作階段之間保留詢問 AI 的歷史記錄時,詢問 AI 的對話才會保留在您的瀏覽器中。
- 金鑰。金鑰在伺服器上加密,絕不會傳回瀏覽器,儲存後也不會再次顯示。
快速鍵
| 按鍵 | 動作 |
|---|---|
| ⌘K / Ctrl+K → 詢問 AI… | 開啟詢問 AI |
| ⌘K / Ctrl+K → 工具名稱 | 執行目前頁面的 AI 工具 |
| Enter | 在詢問 AI 中傳送問題 |
| Shift+Enter | 在詢問 AI 中換行 |
| ⌘Z / Ctrl+Z | 復原最後套用的 AI 變更 |
訊息
| 訊息 | 意義與修正方式 |
|---|---|
| 「未設定 AI 金鑰。在『帳戶 → AI 金鑰』中新增 AI 服務商 API 金鑰。」以及沒有 AI 金鑰對話方塊 | 沒有可用的金鑰。按一下開啟 AI 金鑰並新增一個,或請您的組織管理員提供組織金鑰。 |
| 「貼上 API 金鑰。」/「貼上完整的 API 金鑰。」 | 金鑰欄位是空的或被截斷。 |
| 「輸入至少 1,000 個權杖的每月限制,或留空表示不限制。」 | 修正限制。 |
| 「您已達到在 … 的每月 AI 限制(… 中已用 …)。… 的管理員可在『組織設定 → AI』中提高限制。限制將於 … 重設。」 | 您的組織為您設定的每月限制已用完。請組織管理員提高限制、使用您自己的金鑰,或等到月底。請參閱成員限制。 |
| 「您已達到在此伺服器上的每月 AI 限制(… 中已用 …)。網站管理員可在『管理員 → AI 支出與使用情況』中提高限制。限制將於 … 重設。」 | 自行託管伺服器為您設定的限制已用完。請詢問網站管理員。 |
| 「請輸入 0 或以上的數字作為限制。」/「請輸入請求或權杖的整數。」/「請輸入最多兩位小數的金額限制。」 | 修正成員限制。 |
| 「… 金鑰未儲存。請檢查金鑰,然後重試。」 | 測試請求失敗;原因會先顯示。 |
| 「輸入您的密碼以變更 AI 金鑰。」 | 金鑰變更需要在最近 10 分鐘內進行密碼驗證。 |
| 「密碼錯誤。請重試。」 | 確認您的密碼中的密碼不符。 |
| 「只有此組織的管理員可以變更其 AI 金鑰。」 | 請洽詢組織管理員。 |
| 「此伺服器無法讀取儲存的金鑰。請將其移除後重新新增。」 | 移除金鑰後重新新增。 |
| 「供應商拒絕了 API 金鑰。請在『帳戶 → AI 金鑰』中新增新的金鑰。」 | 金鑰無效、已撤銷或沒有餘額。 |
| 「AI 供應商發生錯誤。請重試,或在『帳戶 → AI 金鑰』中測試金鑰。」/「無法連線到 AI 供應商。」 | 供應商錯誤或服務中斷。請稍後再試。 |
| 「AI 回應時間過長。」 | 請求逾時。請重試,或減少輸入內容。 |
| 「AI 回覆不符合預期格式:…」/「AI 回應被拒絕…」 | 回覆未通過檢查;沒有任何變更。請重試。 |
| 「此組織的 AI 已由其管理員關閉。」 | 請洽詢組織管理員,或在組織之外使用該專案。 |
| 「此安裝的 AI 已關閉。」 | 此安裝環境的管理員已關閉 AI。其他所有功能皆可運作。 |
| 「Holarch 已為您的組織關閉 AI。」 | Holarch 已將您組織的 AI 設為關閉。請參閱由 Kimi K3 為您的組織提供的 AI。 |
| 「您的組織無法使用 Holarch 的預設模型,因此無法使用預設 AI 服務商的金鑰。請改為新增 Kimi(Moonshot AI)或 GLM(Z.ai)金鑰。」 | 您的組織不使用 Holarch 的預設模型。請在設定允許的情況下新增 Kimi 或 GLM 金鑰。 |
| 「您組織的 AI 使用其自己的 Kimi(Moonshot AI)或 GLM(Z.ai)金鑰。請要求組織管理員新增一個。」 | 組織尚無 Kimi 或 GLM 金鑰。請洽詢組織管理員。 |
| 「Kimi(Moonshot AI)已由您的組織 … 關閉。… 的管理員可在「組織設定 → AI」中開啟它。」(或 GLM(Z.ai)) | 組織尚未允許此提供者。請洽詢組織管理員,或使用預設 AI 服務商的金鑰。請參閱組織中的 Kimi K3 與 GLM 5.3。 |
| 「您的組織無法使用透過 MCP 連接的 AI 應用程式。請改用 Holarch 中的 AI。」 | 當您組織的 AI 由 Holarch 設定時,MCP 工具會被拒絕。 |
| 「此組織的 AI 變更已由其管理員關閉。」(或「有關專案的提問已…」、「AI 說明已…」、「AI 中的參考檔案已…」;「… 已由擁有者在此專案中關閉。」、「… 已在您的帳戶設定中關閉。」) | 該類 AI 請求已在 AI 權限下關閉。請洽詢訊息中所列的人員,或使用已開啟類別的工具。 |
| 「此處已關閉 AI 變更。」 | 在建議與變更關閉時要求詢問 AI 變更某些內容。在允許的情況下,它仍會回答問題。 |
| 此專案的 AI 已關閉 | 專案包含服務視為受限的機密等級標示:分類欄位或標題欄中的分類或 CUI 標示、文件名稱或文字中如 SECRET//NOFORN 的橫幅,或文件、專案或組織標示中的出口管制聲明(ITAR/EAR)。Company Proprietary、Company Confidential 和散發聲明不會關閉 AI。請移除這些標示或聯絡支援人員。沒有傳送任何內容。在 AI 供應商已核准處理此類資料的自行託管安裝環境上,網站管理員可以允許這些專案使用 AI(管理員 → AI → 受限的機密等級標示);託管服務一律保持 AI 關閉。 |
| 「僅檢視:AI 工具需要編輯權限」 | 請擁有者給予您編輯者角色。 |
| 「您的工作階段已結束。請重新登入。」 | 重新登入,然後重複請求。 |
| 「無法連線到伺服器。請檢查連線,然後重試。」 | 網路問題。 |
| 「沒有可審查的需求。請先選擇或開啟需求。」/「請選擇一項需求。」 | 選取工具作用的項目。 |
| 「<provider> 未傳回任何需求。」/「… 未建議任何風險。」 | 新增內容脈絡後重試。 |
| 「已取消翻譯;未做任何變更。」 | 您取消了翻譯。 |
限制
- 每個帳戶和每個組織每個供應商一個金鑰。
- 每月金鑰限制:1,000 到 10,000,000,000 個權杖。
- 成員限制:以組織的單位計,0 到 100,000,000,000(金額限制以美分計);每個組織一個單位。
- 每人每分鐘 30 個請求,同時 3 個。
- 提示最多 600,000 個字元;回覆最多 400,000 個字元。
- 參考檔案:每個最多 200,000 個字元,儲存在此瀏覽器中。
- 產生需求:1–20 個父項,每個父項 0–10 個子項。產生子需求:1–20 個。產生風險:每次執行最多 3 個(Risk 圖:1–10 個)。美工圖案:1–8 個變體。
- 檢視者無法使用 AI。