症狀：JASP 已開啟，但你不確定 AI 功能是否在目前版本內，也不知道 API 設定成功是否代表可以處理研究資料。
最快解法：先確認你使用的是包含 JASP AI 的正式版本，再設定機構允許的 API 提供方，最後用脫敏樣例驗收。遠端 Mac 提供 macOS 圖形操作環境，不能代替學校對資料處理或外部 API 的審批。
適合沒有本地 Mac、要完成 JASP AI 桌面端設定的研究生與博士生；也適合先用脫敏樣例評估功能邊界的科研人員，以及負責課題組軟體環境的高校技術支援人員。
最後更新於 2026 年 10 月 14 日；版本狀態與設定依據為 JASP 官方下載頁、發布說明、JASP AI 官方介紹及下文列出的 API 文件。正式發布前仍應重新核對，因下載頁、發布記錄與 nightly 頁面的更新時點可能不同。
01 配置前先判定 JASP AI 版本狀態
JASP AI 是 JASP 中的功能方向，不應被描述成只能在 Mac 使用。你需要確認的是：目前安裝的 JASP 版本是否包含該功能，以及你看到的功能屬於正式版本、預發布版本，還是 nightly 建置。官方提供的下載頁、發布說明與 nightly 頁面各自用途不同，不能只憑其中一頁判定正式版狀態。
| 核對位置 | 你要確認的事項 | 使用時的判斷 |
|---|---|---|
| JASP 下載頁 | 目前正式提供的下載項目及平台選擇 | 以頁面當下標示為準，不以舊安裝檔名稱推定 |
| JASP 發布說明 | 版本更新內容，以及 JASP AI 是否列於相關說明 | 對照你實際安裝的版本 |
| JASP nightly 頁面 | 是否正在檢視開發中的 nightly 建置 | 不把 nightly 功能視為正式版承諾 |
如果各頁面資訊不一致，先記下你安裝的版本和頁面標示日期，再以正式下載頁與發布記錄確認。不要為了看到 AI 選項，就把開發版當成課題組可長期使用的穩定環境。可在 JASP AI 官方介紹中核對功能與 API 設定方向；實際欄位名稱則以你當前版本的介面為準。
注意：JASP AI 選項出現在介面，只能證明該版本呈現相關功能入口；它不表示憑據已有效、服務端可用，或機構已批准傳送資料。
02 準備連線前先定 API 與資料界線
正式輸入憑據前，先確認你有權使用哪個 API 提供方、帳戶由誰管理，以及研究資料可否送往外部服務。不要把某一提供方的免費額度、可用性或合規狀態當成所有高校都適用的條件；這些都應以提供方當前文件和校內政策為準。
| 準備項目 | 你要做的確認 | 未確認時的處理 |
|---|---|---|
| API 提供方 | 是否獲學校或計畫負責人允許 | 暫不輸入真實資料 |
| API Key | 由誰建立、保存和撤銷 | 向帳戶管理者查明責任 |
| 模型或端點 | 與所選服務及 JASP 欄位相符 | 回查提供方文件 |
| 測試素材 | 公開、合成或已核准脫敏的樣例 | 不使用受限或可識別資料 |
API Key 是憑據，不是普通偏好設定。按照 API 官方參考文件核對憑據的使用要求；若採用其他提供方，改查該服務的官方文件。不要把金鑰寫進可共用的分析檔、截圖、電子郵件或支援工單。若憑據曾公開，依提供方程序撤銷並重新建立，不要反覆貼上同一金鑰試錯。
先用分支條件決定能否繼續
- 若目前使用的是正式發布版本，而且該版本的官方資料確認包含 JASP AI，進入 API 設定；否則先更新或等待正式版，不以 nightly 作為正式分析環境。
- 若你已獲准使用所選提供方，並且知道憑據與端點由誰負責，使用脫敏樣例繼續驗收；否則先聯絡課題組管理者或資訊單位。
- 若資料已獲准傳送至該服務，才評估真實工作流程；否則停留在公開或脫敏資料測試，不要因使用遠端 Mac 而跳過審批。
03 完成 JASP AI 設定並分開驗證三個狀態
設定入口和欄位可能隨版本改變。請先查看目前介面，再對照 JASP AI 官方介紹中的設定方向。若畫面名稱或欄位與舊說明不同，優先依目前正式版和官方資料操作，不要照搬過時截圖。
| 檢查點 | 核對內容 | 通過代表什麼 |
|---|---|---|
| 介面設定 | 提供方、模型或端點欄位是否依官方資料填寫 | 設定已輸入，不代表服務已回應 |
| 憑據有效 | API Key 是否由正確帳戶建立，且未撤銷或貼錯 | 憑據可能可用，不代表網路可達 |
| 服務回應 | 最小請求是否得到提供方回覆 | 該次呼叫有回應，不代表輸出正確 |
照以下順序操作，並保留不含秘密憑據的紀錄：
- 打開 JASP 的 AI 設定位置，先辨認版本和畫面欄位；不要在尚未確認版本時照舊教學輸入資料。
- 選定獲准的 API 提供方，依該提供方文件取得憑據；不要把 API Key 傳給其他使用者代填。
- 按 JASP 目前介面的欄位要求填入提供方、模型或端點資訊。欄位不明時先查官方資料，不要猜測端點格式。
- 儲存設定後，以不含真實研究資料的短請求測試。記下 JASP 提示、服務回應狀態與可重現的操作順序。
- 分別記錄介面設定、憑據驗證和服務回應結果。只有三者都符合預期，才把該環境標記為完成基本連線測試。
提醒：連線成功不等於統計分析正確。AI 回覆不能取代研究者對變數、篩選條件、模型設定和結果解讀的覆核。
04 依錯誤類型定位首次連線問題
如果測試失敗，不要一直重貼 API Key。先把現象歸入憑據錯誤、網路不可達、服務端拒絕或模型回應異常，再依對應文件處理。API 服務的錯誤分類可參考官方錯誤碼說明；不同提供方的錯誤格式可能不同，應查看你實際使用的服務文件。
| 觀察到的情況 | 優先檢查 | 下一步 |
|---|---|---|
| 憑據相關錯誤 | 是否使用正確帳戶、金鑰是否有效、是否有多餘字元 | 由憑據管理者確認，不在公開紀錄貼出金鑰 |
| 連線逾時或無法到達 | 網路政策、代理設定及服務端點是否可達 | 詢問校內網路管理者，不要先改用未核准服務 |
| 服務端拒絕請求 | 帳戶權限、模型或端點設定是否符合提供方要求 | 對照提供方回應和官方錯誤說明 |
| 有回覆但內容異常 | 請求是否清楚、模型或端點是否選對 | 用簡短、無敏感資料的請求重測，再人工核對 |
05 FAQ：API 金鑰、連線與研究資料
JASP AI 一定要另外設定 API Key 嗎？
是否需要 API Key，取決於你使用的 JASP AI 功能版本與所選提供方。先對照 JASP 官方說明和提供方文件；若學校統一管理帳戶，先向管理員確認取得及保管方式。不要借用他人的金鑰，也不要把憑據放入可共用的專案檔或測試紀錄。
怎樣確認 API 提供方已連線？
不能只看設定欄位已填妥。確認提供方、模型或端點與憑據相符，再以不含研究資料的短請求測試，記錄 JASP 提示和服務回應。這項測試只代表當次呼叫鏈有回應，不證明分析正確、資料安全或機構已批准。
遠端 Mac 首次測試應使用什麼資料？
選公開資料、合成資料，或依機構規範完成脫敏且獲准使用的樣例。先測試最小請求，再挑選可人工覆核的操作，逐項檢查變數、篩選條件和分析輸出。測試連線不需要真實個案資料；不要把可識別、受限或尚未獲批的資料放進請求。
可以直接把課題組的真實研究資料交給 JASP AI 嗎？
只有在資料分類、研究同意、機構政策和外部 API 使用條件都已核准時，才可按批准範圍評估。對受控資料，應先參考適用的資料管理規範，例如 NIH 受控存取資料安全最佳實務文件，並向本校資料管理負責人確認。遠端 Mac 不會替你完成審批。
06 以脫敏樣例完成分析閉環，再決定是否放行
API 有回應後，先用可公開或已核准脫敏的樣例完成一次端到端測試。讓 JASP AI 協助一項範圍清楚、能由你獨立檢查的操作；再逐項核對資料欄位、缺失值處理、篩選條件、分析設定及輸出。保留測試日期、版本、所用樣例類型和檢查結果，但不要記錄 API Key 或可識別個人資料。
NIH 的受控存取資料安全文件可協助你辨認受控資料的管理責任，但它不取代學校政策、研究倫理要求或計畫條款。若你的資料受到額外限制，應由資料管理者確認允許的處理位置和服務範圍；不要把「已脫敏」當作自動獲批的同義詞。
可用以下結果分流：
- 繼續測試：正式版本狀態已確認，API 呼叫可用，脫敏樣例的操作結果經你覆核，且測試不涉及未核准資料。
- 聯絡管理員：憑據由學校管理、網路策略不明，或無法判斷資料能否送往外部 API。
- 暫停資料接入：版本狀態不清、API 拒絕請求，或資料審批尚未完成。先保留脫敏測試環境，不要用真實研究資料反覆試錯。
如果你沒有本地 Mac，先從遠端 Mac 服務入口了解可選環境，再依研究週期查看方案與計費資料。遠端環境可免去先購置本機的需要，但仍有網路依賴、API 帳戶管理和機構審批等限制；若你長期持續重度使用、需要實體周邊設備，或必須在校內受控網路中處理資料，應先比較自有 Mac 或校內設備是否更合適。若只是短期設定、兼容性檢查或脫敏流程驗收，可再按專案時程評估 CALMVPS 租用方案；租用不會替代 API 金鑰，也不會替你取得資料使用批准。