常見問題 (FAQ)

目前正式交付的連接對象為具備 Web API 的企業級 PDM（須在 IIS 啟用 Web API，預設 Port 65453）。其他品牌（例如 Autodesk Vault、Creo PDM、中望 PLM 等）歡迎聯絡——我們可評估對接。無 Web API 的入門／標準版暫不支援。

正式支援：繁體中文、簡體中文、英文。介面可切換更多語言，但其他語言屬預覽／持續優化，不納入標準技術支援範圍。建議日常以繁／簡／英使用；若以其他語言操作成功可視為額外便利，但遇問題時支援以正式三種語言為準。

正常。如果 .env 沒有填寫 PDM_USERNAME / PDM_PASSWORD，啟動時會顯示此訊息。只要在 Chatbot 中使用 PDM Login 登入，或在 .env 補填後重啟，即可正常使用。

• 第一次查詢需要傳送 79 個工具定義給 AI 模型，屬正常現象（約 5–15 秒）
• 確認 AI Agent 和 PDM Web API 在同一內網，不經 VPN 或外部代理
• 若超過 60 秒無回應，重新整理聊天頁面再試
• 考慮換用回應較快的 AI 模型

確認 .env 中的 CHATBOT_WEBHOOK_URL 已正確填寫（由 VATEC 安裝時提供），且 AI Chatbot Workflow 已 Activate（啟用）。

PDM Client 有本地快取。請在 PDM Client 中按 F5（重新整理），或重新開啟檔案 Properties，即可看到最新值。

特殊情況（PNG/JPG 的 Comment 欄位）： 若 Comment 變數有配置 EXIF 映射（Image | EXIF | PropertyTagExifUserComment），Checkin 時 EXIF 會覆蓋值。解決方法：在 PDM Server 執行 iisreset 清除 Web2 快取，或在 PDM Admin 重設映射。

常見原因：

1. 未先 Checkout 檔案（Datacard Writer 需 checkout 後才能寫入非 Version Free 欄位）
2. 嘗試修改 ReadOnly 變數（用 Datacard Reader 確認欄位是否 readOnly: true）
3. ConfigurationId 不符（系統通常自動處理，若仍失敗請聯絡支援）

核心規則：AI OCR 目標變數必須設定 Version Free = true。

設定步驟（PDM Admin → Card Editor）：

1. 在 Variables 新增 OCR 變數（建議前綴 _AI_OCR_*，長文字勾 Multiline）
2. 將變數放上對應檔案類型的 Card（圖片卡 / PDF 卡）
3. 逐一勾選每個 OCR 變數的 Version Free（關鍵，漏勾就會失敗）
4. 儲存並 Deploy

若工具回傳 notPersisted，代表該變數沒勾 Version Free，補勾即可。

不需要，也不應該設定 Version Free。

CAD / Office 檔案的 Datacard 更新靠 Smart Check-in 自動 Checkout → 改變數 → Checkin，這是正確方式。

Version Free 只適用於需要 AI OCR 自動填寫的欄位（圖片收據 / PDF 報告的專屬 OCR 欄位）。設 Version Free 在 CAD 檔案上會導致版本控制問題。

透過 Chatbot 上傳的上限為 50 MB（AI Agent 限制）。

超過 50 MB 的大型 Assembly 請改用：

• PDM Windows Client 直接上傳（建議）
• 或直接呼叫 /api/upload-to-vault（支援更大檔案）

OCR 批次處理每次最多 5 張圖；大批量（數百張）請改用 PDM Windows Client 批量匯入。

透過 File Uploader 上傳的是「外部來源」檔案，PDM 本地快取不存在。請在 PDM Windows Client 中先執行 Get Latest（取得最新版本）到本地，然後才能開啟。直接雙擊新上傳的檔案可能因本地快取缺失而失敗。

Transition 名稱必須與 PDM Admin 中設定的完全一致（大小寫敏感）。

解決方法：先呼叫 Available Transitions（傳入 fileId）取得目前可用的 Transition 名稱列表，再帶入正確名稱呼叫 State Transition。

依序確認：

1. Gmail query — Gmail 讀取設定的 query 是否包含 category:primary newer_than:3d（避免讀舊 email）
2. Workflow 已 Activate — ECO/ECR Processor workflow 必須是啟用狀態
3. Email 格式 — ECO/ECR 偵測靠 subject + body 聯合判斷，確認主旨包含 "ECO" 或 "ECR" 關鍵字
4. 已讀狀態 — 已手動開啟過的 email 會被 workflow 跳過（只處理未讀）

不會卡死。Server 有 OCR 併發節流：同時最多跑 OCR_MAX_CONCURRENCY 個 OCR 作業，其餘自動排隊。突發高峰會「稍慢但穩」。

建議依用戶規模設定 OCR_MAX_CONCURRENCY（見 授權定價頁面的規模建議表）。注意不要設得比 OCR 供應商的 Rate Limit 還高。

錯誤碼	原因	解決方法
ENOTFOUND	PDM_SERVER_URL 主機名稱無法解析	改用 IP 地址，或確認 DNS 設定
ECONNREFUSED	PDM Web API 服務未啟動或 Port 錯誤	確認 IIS 中 PDM Web API 已啟用，預設 Port 65453
401 Unauthorized	帳號密碼錯誤或 Session 過期	確認 .env 的 PDM_USERNAME / PDM_PASSWORD，重啟 Server

Port	方向	用途
HTTP Service Port	入站 (Inbound)	AI Agent HTTP / Chatbot 介面
65453	出站 (Outbound)	PDM Web API
443	出站 (Outbound)	License 驗證 + AI 模型 API