---
title: "設定 PreciseMD 的模型連線"
description: "PreciseMD 需要 OCR 與 VLM 兩個模型；於 AI Model Center 確認模型正在執行並取得 Model ID，再到模型連線頁面核對系統自動完成的設定"
canonical_url: "https://docs.ardge.com/zh-tw/knowledge/precisemd/model-connection"
---
# 設定 PreciseMD 的模型連線

> PreciseMD 需要 OCR 與 VLM 兩個模型；於 AI Model Center 確認模型正在執行並取得 Model ID，再到模型連線頁面核對系統自動完成的設定

## 概觀

PreciseMD 的解析能力來自兩個模型：**OCR 模型** 負責辨識文件影像中的文字，**VLM 模型**（多模態模型）負責視覺校正，依原始影像重建表格與版面。

這兩個模型在 PreciseMD 的 **模型連線** 頁面各對應一筆標示 **預設** 的連線。這兩筆連線由系統於部署時自動建立，**名稱**、**Base URL** 與 **API 金鑰** 三個欄位皆已自動帶入，不需要你自行填寫。

因此設定流程很短：於 AI Model Center 確認兩個模型正在執行、取得各自的 Model ID，再回到 **模型連線** 頁面核對兩筆預設連線指向正確的模型即可。

## 你將學會什麼

- 於 AI Model Center 確認模型狀態並取得 Model ID
- 於 **模型連線** 頁面核對系統自動建立的兩筆預設連線
- 視需要新增自訂的模型連線，供 **遊樂場** 指定其他模型

**預計時間：約 10 分鐘**

## 適用版本

- PreciseMD 1.0.0 及以上版本
- ARX OS 1.0 及以上版本

## 開始之前

- 已於同一台 ARX 的 AI Model Center 部署 OCR 模型與 VLM 模型
- 你具備 PreciseMD 的管理者身分。**模型連線** 頁面僅對管理者開放

## 你需要準備的資訊

只需要一項：兩個模型各自的 **Model ID**。

<table>
<thead>
  <tr>
    <th>
      資訊
    </th>
    
    <th>
      用途
    </th>
    
    <th>
      取得位置
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        Model ID
      </strong>
    </td>
    
    <td>
      核對 <strong>
        模型連線
      </strong>
      
       中 <strong>
        模型 ID
      </strong>
      
       欄位的值
    </td>
    
    <td>
      AI Model Center <strong>
        Model Instances
      </strong>
      
       頁面該模型的 <strong>
        Instance Name
      </strong>
    </td>
  </tr>
</tbody>
</table>

**名稱**、**Base URL** 與 **API 金鑰** 三個欄位由系統依部署環境自動帶入，不需要另行取得。

## PreciseMD 需要的兩個模型

<table>
<thead>
  <tr>
    <th>
      模型
    </th>
    
    <th>
      用途
    </th>
    
    <th>
      使用它的功能
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        OCR 模型
      </strong>
    </td>
    
    <td>
      辨識文件影像中的文字，輸出為 Markdown
    </td>
    
    <td>
      <strong>
        遊樂場
      </strong>
      
       與 <strong>
        OCR 任務
      </strong>
      
       的每一次解析
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        VLM 模型
      </strong>
    </td>
    
    <td>
      視覺校正：對照原始影像修正辨識結果，並重建表格與版面
    </td>
    
    <td>
      啟用 <strong>
        視覺校正
      </strong>
      
       的解析，以及 <strong>
        智慧代理
      </strong>
    </td>
  </tr>
</tbody>
</table>

視覺校正的作用與適用時機，見[什麼時候應該啟用視覺校正？](https://docs.ardge.com/zh-tw/knowledge/precisemd/vision-correction)。

## 步驟 1：建立管理員帳號

首次開啟 PreciseMD 時，畫面顯示 **建立管理員帳號**。已完成註冊者請直接登入，並略過本步驟。

1. 依下表填寫欄位

<table>
<thead>
  <tr>
    <th>
      欄位
    </th>
    
    <th>
      設定值
    </th>
    
    <th>
      規則與注意事項
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        使用者帳號
      </strong>
    </td>
    
    <td>
      管理者的登入帳號
    </td>
    
    <td>
      須在 3–50 個字元之間
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        電子郵件
      </strong>
    </td>
    
    <td>
      管理者的電子郵件
    </td>
    
    <td>
      須為有效的電子郵件格式
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        密碼
      </strong>
    </td>
    
    <td>
      登入密碼
    </td>
    
    <td>
      長度須在 8–128 個字元之間
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        確認密碼
      </strong>
    </td>
    
    <td>
      與 <strong>
        密碼
      </strong>
      
       相同
    </td>
    
    <td>
      兩次輸入不一致時顯示「兩次密碼不一致」
    </td>
  </tr>
</tbody>
</table>

1. 點擊 **建立帳號**

帳號建立後即可登入，側邊選單顯示 **智慧代理**、**遊樂場**、**OCR 任務**、**儲存空間連線**、**模型連線** 與 **使用者管理**。

## 步驟 2：於 AI Model Center 取得兩個 Model ID

1. 開啟同一台 ARX 的 **AI Model Center**，前往 **Model Instances** 頁面
2. 確認 OCR 模型與 VLM 模型的狀態皆為 **Running**
3. 記下兩者的 **Instance Name**，此字串即為各自的 Model ID

![AI模型中心-模型實例](https://docs.ardge.com/screenshots/knowledge/zh-tw/precisemd/model-connection/step-2.webp)

<warning>

**模型未在執行時解析會失敗：**

狀態不是 **Running** 的模型，即使 **模型連線** 設定正確，解析仍會失敗。請先於 AI Model Center 啟動該模型。

</warning>

## 步驟 3：核對兩筆預設的模型連線

1. 登入 PreciseMD，前往 **模型連線** 頁面
2. 於列表中找出標示 **預設** 的兩筆連線，一筆供 OCR 使用，一筆供 VLM 使用
3. 核對各自的 **模型 ID** 欄位，是否與步驟 2 取得的 **Instance Name** 相同

兩者相同即表示設定已完成，可直接進行步驟 4。

若某一筆的 **模型 ID** 指向的不是你要使用的模型，請改選：

1. 點擊該列的編輯圖示
2. 點開 **模型 ID** 下拉選單，系統向 **Base URL** 取得該端點的模型清單
3. 選取步驟 2 記下的模型
4. 點擊 **儲存**

![模型連線清單](https://docs.ardge.com/screenshots/knowledge/zh-tw/precisemd/model-connection/step-3-1.webp)

![編輯模型連線](https://docs.ardge.com/screenshots/knowledge/zh-tw/precisemd/model-connection/step-3-2.webp)

<warning>

**預設連線的名稱無法修改：**

標示 **預設** 的連線由系統管理，**名稱** 欄位為停用狀態，欄位下方顯示「系統預設模型連線的名稱無法修改」。此兩筆連線亦不提供刪除。

</warning>

<note>

**Base URL 的結尾：**

含 `/v1` 與不含 `/v1` 皆可，系統會自行接上 `/v1/models` 路徑。

</note>

## 步驟 4：確認設定生效

1. 前往 **遊樂場** 頁面
2. 於 *原始文件* 面板點擊 **上傳**，選取一份 PDF 或圖片
3. 勾選該檔案
4. 點擊 **執行**

未於 **進階設定** 另行指定模型時，這次試跑即使用步驟 3 核對過的兩筆預設連線。

*執行結果* 面板出現一筆紀錄，狀態依序為 **處理中** 與 **完成**。點擊該列的檔名可開啟解析結果，即表示兩個模型皆可正常運作。

## 新增自訂的模型連線

**遊樂場** 的 **進階設定** 中，OCR 與 VLM 的模型下拉選單只列出自訂的模型連線，不含標示 **預設** 的兩筆；未建立任何自訂連線時，選單顯示「沒有可用模型」，兩項模型皆沿用預設。要在試跑時比較其他模型的結果，請依下列步驟新增。

1. 前往 **模型連線** 頁面，點擊 **新增模型連線**
2. 依下表填寫欄位

<table>
<thead>
  <tr>
    <th>
      欄位
    </th>
    
    <th>
      設定值
    </th>
    
    <th>
      規則與注意事項
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        名稱
      </strong>
    </td>
    
    <td>
      這組連線的識別名稱
    </td>
    
    <td>
      必填，最長 128 個字元
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Base URL
      </strong>
    </td>
    
    <td>
      AI Model Center 的 Model API Endpoint
    </td>
    
    <td>
      必填，須為 OpenAI 相容端點
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        API 金鑰
      </strong>
    </td>
    
    <td>
      AI Model Center 建立的 API Key
    </td>
    
    <td>
      選填。留空或填入 <code>
        null
      </code>
      
       時不帶認證標頭
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        模型 ID
      </strong>
    </td>
    
    <td>
      於下拉選單中勾選要建立的模型
    </td>
    
    <td>
      必填。清單由系統向端點取得，可一次勾選多個
    </td>
  </tr>
</tbody>
</table>

1. 點擊 **模型 ID** 的下拉選單。系統依 **Base URL** 與 **API 金鑰** 取得模型清單，清單上方的搜尋框可依名稱過濾，左側的核取方塊可全選當前過濾結果
2. 勾選要建立的模型
3. 點擊 **建立**

<warning>

**勾選幾個模型就建立幾筆連線：**

每個勾選的模型各建立一筆模型連線，列表中的名稱為 `<名稱> / <模型 ID>`。組合後的名稱不可與既有連線重複，且長度上限為 255 個字元。

</warning>

送出後畫面顯示「已建立 N 個模型連線」，列表中出現對應筆數的資料列。新增的連線隨即出現在 **遊樂場** 的 **OCR** 與 **VLM** 下拉選單中。

自訂連線的 **Base URL** 與 **API 金鑰** 需要自行填寫，取值方式請參考[透過 API 呼叫 ARX 平台上的地端模型](https://docs.ardge.com/zh-tw/knowledge/arx-os/api-model-calls)：**Base URL** 填入該文所稱的 Model API Endpoint，**API 金鑰** 填入於 AI Model Center 建立的 API Key。

## 疑難排解

<table>
<thead>
  <tr>
    <th>
      訊息
    </th>
    
    <th>
      可能原因
    </th>
    
    <th>
      處理方式
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        無法連線到模型服務，請確認 Base URL、API Key、網路與服務狀態
      </code>
    </td>
    
    <td>
      Base URL 有誤，或 PreciseMD 無法連通該端點
    </td>
    
    <td>
      於 AI Model Center 的 <strong>
        Model Instances
      </strong>
      
       頁面確認模型狀態為 <strong>
        Running
      </strong>
      
      ；自訂連線請一併檢查所填的 Base URL
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        模型服務回應格式不符合模型列表 API 預期格式
      </code>
    </td>
    
    <td>
      該端點的回應不符合 OpenAI 模型列表 API 的格式
    </td>
    
    <td>
      確認填入的是模型閘道的端點，而非其他服務的網址
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        模型連線名稱已存在
      </code>
    </td>
    
    <td>
      組合後的 <code>
        <名稱> / <模型 ID>
      </code>
      
       與既有連線重複
    </td>
    
    <td>
      於 <strong>
        名稱
      </strong>
      
       欄位改用其他名稱
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        模型連線無法存取或沒有可用 model
      </code>
    </td>
    
    <td>
      端點可達但未回傳任何模型
    </td>
    
    <td>
      於 AI Model Center 確認該 API Key 的可取用模型範圍已涵蓋目標模型
    </td>
  </tr>
</tbody>
</table>

## 後續步驟

模型連線核對完成後，可於 **遊樂場** 針對特定文件類型調校提示詞，見[在遊樂場調校提示詞並比較解析結果](https://docs.ardge.com/zh-tw/knowledge/precisemd/playground-prompt-tuning)。

## 相關文章

- [什麼時候應該啟用視覺校正？](https://docs.ardge.com/zh-tw/knowledge/precisemd/vision-correction)
- [PreciseMD 支援哪些檔案格式與數量限制？](https://docs.ardge.com/zh-tw/knowledge/precisemd/formats-and-limits)
- [透過 API 呼叫 ARX 平台上的地端模型](https://docs.ardge.com/zh-tw/knowledge/arx-os/api-model-calls)


## Sitemap

See the full [sitemap](https://docs.ardge.com/sitemap.md) for all pages.