---
title: "在遊樂場調校提示詞並比較解析結果"
description: "以工作區區隔試跑紀錄、調整視覺校正的提示詞與模型，並以並排比較找出兩次試跑的差異"
canonical_url: "https://docs.ardge.com/zh-tw/knowledge/precisemd/playground-prompt-tuning"
---
# 在遊樂場調校提示詞並比較解析結果

> 以工作區區隔試跑紀錄、調整視覺校正的提示詞與模型，並以並排比較找出兩次試跑的差異

## 概觀

不同文件類型適用的提示詞並不相同。**遊樂場** 保留每一次試跑的完整紀錄，可在同一份檔案上反覆調整提示詞與模型，並將兩次結果並排比對，據此決定 **OCR 任務** 要採用的設定。

本文說明如何建立工作區、以 **進階設定** 調整視覺校正的提示詞與模型、檢視單次結果，以及使用 **比較** 檢視兩次試跑的差異。

## 你將學會什麼

- 以工作區區隔不同文件類型的試跑紀錄
- 調整視覺校正的提示詞，並指定 OCR 與 VLM 模型
- 檢視單次試跑的原始檔、OCR 區域與 Markdown 輸出
- 並排比對兩次試跑，找出提示詞造成的差異

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

## 適用版本

- PreciseMD 1.4.0 及以上版本

## 開始之前

- 已核對 **模型連線** 的設定，且 OCR 與 VLM 兩個模型於 AI Model Center 的狀態皆為 **Running**。核對方式見[設定 PreciseMD 的模型連線](https://docs.ardge.com/zh-tw/knowledge/precisemd/model-connection)
- 已備妥一份要調校的代表性文件。支援的格式與大小上限見[PreciseMD 支援哪些檔案格式與數量限制？](https://docs.ardge.com/zh-tw/knowledge/precisemd/formats-and-limits)

## 步驟 1：建立工作區並上傳檔案

工作區保留該區內所有試跑的紀錄與檔案。建議依文件類型分開建立，例如發票、合約、報表各一個工作區。

1. 前往 **遊樂場** 頁面
2. 於頁面右上角的 **工作區** 選擇器旁點擊新增圖示，畫面顯示 **建立工作區** 視窗
3. 於 **工作區名稱** 填入名稱，點擊 **建立**
4. 於 *原始文件* 面板點擊 **上傳**
5. 將檔案拖放至視窗中，或點擊視窗選取檔案，接著點擊上傳

<note>

**單次上傳上限：**

50 個檔案。視窗下方顯示「已選擇 N / 50 個檔案」。

</note>

建立後系統自動切換至該工作區，*原始文件* 面板列出已上傳的檔案，欄位為 **名稱**、**大小** 與 **修改時間**。

![遊樂場頁面](https://docs.ardge.com/screenshots/knowledge/zh-tw/precisemd/playground-prompt-tuning/step-1-1.webp)

![建立工作區](https://docs.ardge.com/screenshots/knowledge/zh-tw/precisemd/playground-prompt-tuning/step-1-2.webp)

![上傳檔案視窗](https://docs.ardge.com/screenshots/knowledge/zh-tw/precisemd/playground-prompt-tuning/step-1-3.webp)

## 步驟 2：設定視覺校正與提示詞

1. 於 *原始文件* 面板勾選要試跑的檔案
2. 點擊面板下方的 **進階設定**
3. 開啟 **視覺校正** 開關
4. 於提示詞編輯器描述這份文件的類型與內容

<tip>

**描述檔案類型與內容可提升準確度：**

提示詞欄位的範例為「掃描的發票，內含品項明細表格與總計。」愈貼近實際文件的描述，校正結果愈準確。

</tip>

<warning>

**未啟用視覺校正時無法輸入提示詞：**

提示詞編輯器在 **視覺校正** 關閉時為停用狀態，並顯示「請先啟用視覺校正以輸入提示詞。」

</warning>

**視覺校正** 開啟後，提示詞編輯器與 **模型連線** 區塊的 **VLM** 下拉選單皆可操作。

![進階設定與視覺校正](https://docs.ardge.com/screenshots/knowledge/zh-tw/precisemd/playground-prompt-tuning/step-2-1.webp)

![填寫提示詞](https://docs.ardge.com/screenshots/knowledge/zh-tw/precisemd/playground-prompt-tuning/step-2-2.webp)

## 步驟 3：指定 OCR 與 VLM 模型

**進階設定** 的 **模型連線** 區塊可分別指定兩項模型，未指定時使用系統的預設模型。

1. 於 **OCR** 下拉選單選取要使用的模型連線
2. 於 **VLM** 下拉選單選取校正所使用的多模態模型連線

<note>

**下拉選單的內容：**

僅列出自訂的模型連線，未包含標示 **預設** 的兩筆。尚未建立自訂連線時，選單顯示「沒有可用模型」，兩項模型皆沿用預設。

</note>

兩個選單在未選取時顯示「選擇以取代預設模型」。

![模型選單沒有可用模型](https://docs.ardge.com/screenshots/knowledge/zh-tw/precisemd/playground-prompt-tuning/step-3.webp)

## 步驟 4：執行並檢視結果

1. 確認 *原始文件* 面板中已勾選檔案。未勾選時點擊 **執行** 會顯示「請先選取檔案才能執行」
2. 點擊 **執行**
3. 於右側 *執行結果* 面板點擊該列的檔名

*執行結果* 面板的欄位為 **檔案**、**狀態**、**時間** 與 **提示詞**，狀態依序顯示 **處理中** 與 **完成**。狀態為 **完成** 或 **失敗** 的紀錄可點擊檔名開啟。

開啟後的結果視窗提供兩組檢視切換：

<table>
<thead>
  <tr>
    <th>
      切換
    </th>
    
    <th>
      選項
    </th>
    
    <th>
      內容
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      影像檢視
    </td>
    
    <td>
      <strong>
        原始檔
      </strong>
    </td>
    
    <td>
      該頁的原始影像
    </td>
  </tr>
  
  <tr>
    <td>
      影像檢視
    </td>
    
    <td>
      <strong>
        OCR 區域
      </strong>
    </td>
    
    <td>
      在影像上標示辨識到的版面區塊
    </td>
  </tr>
  
  <tr>
    <td>
      文字檢視
    </td>
    
    <td>
      <strong>
        預覽
      </strong>
    </td>
    
    <td>
      以排版後的樣式呈現 Markdown
    </td>
  </tr>
  
  <tr>
    <td>
      文字檢視
    </td>
    
    <td>
      <strong>
        Markdown
      </strong>
    </td>
    
    <td>
      呈現 Markdown 原始碼
    </td>
  </tr>
</tbody>
</table>

視窗上方另顯示本次試跑使用的 OCR 與 VLM 模型；未指定時顯示 **預設**。

![執行中](https://docs.ardge.com/screenshots/knowledge/zh-tw/precisemd/playground-prompt-tuning/step-4-1.webp)

![結果視窗、原始檔與預覽](https://docs.ardge.com/screenshots/knowledge/zh-tw/precisemd/playground-prompt-tuning/step-4-2.webp)

![OCR區域與Markdown原始碼](https://docs.ardge.com/screenshots/knowledge/zh-tw/precisemd/playground-prompt-tuning/step-4-3.webp)

## 步驟 5：調整提示詞後比較兩次結果

1. 回到 **進階設定**，修改提示詞
2. 保持勾選同一份檔案，再次點擊 **執行**
3. 待 *執行結果* 出現第二筆狀態為 **完成** 的紀錄後，點擊其中一筆的檔名
4. 於結果視窗點擊 **比較**
5. 於右半部的下拉選單點選另一筆紀錄

<note>

**可比較的對象：**

同一工作區中、同一個檔名、狀態為 **完成** 的其他試跑紀錄。未選取時下拉選單顯示「請從上方選取要比較的執行結果」。

</note>

比較視窗以左右並排呈現兩次結果，並提供三個分頁：

- **預覽**：兩側各自呈現排版後的 Markdown
- **Markdown**：兩側各自呈現 Markdown 原始碼
- **差異**：以逐行標示的方式呈現兩者的差異

每一側的標頭顯示該次試跑的 **提示詞**、**OCR** 與 **VLM** 模型，以及耗時秒數。文件超過一頁時，視窗下方的頁次導覽會同步切換兩側的頁面。

![比較、尚未選取對象](https://docs.ardge.com/screenshots/knowledge/zh-tw/precisemd/playground-prompt-tuning/step-5-1.webp)

![比較、預覽並排](https://docs.ardge.com/screenshots/knowledge/zh-tw/precisemd/playground-prompt-tuning/step-5-2.webp)

![比較、差異](https://docs.ardge.com/screenshots/knowledge/zh-tw/precisemd/playground-prompt-tuning/step-5-3.webp)

## 步驟 6：清理工作區中的檔案

1. 於 *原始文件* 面板勾選不再需要的檔案
2. 點擊頁面右上角的 **刪除 (N)**
3. 於 **刪除選取的檔案** 視窗點擊 **刪除**

刪除的檔案不可復原，*原始文件* 面板不再列出該檔案。

![刪除選取的檔案](https://docs.ardge.com/screenshots/knowledge/zh-tw/precisemd/playground-prompt-tuning/step-6.webp)

## 疑難排解

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

<tbody>
  <tr>
    <td>
      <code>
        工作區名稱已存在
      </code>
    </td>
    
    <td>
      名稱與既有工作區重複
    </td>
    
    <td>
      回到步驟 1，改用其他名稱
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        請先選取檔案才能執行
      </code>
    </td>
    
    <td>
      未於 <em>
        原始文件
      </em>
      
       面板勾選檔案
    </td>
    
    <td>
      回到步驟 4，勾選要試跑的檔案
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        沒有可用模型
      </code>
    </td>
    
    <td>
      尚未建立自訂的模型連線
    </td>
    
    <td>
      依<a href="https://docs.ardge.com/zh-tw/knowledge/precisemd/model-connection">
        設定 PreciseMD 的模型連線
      </a>
      
      的「新增自訂的模型連線」新增
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        Playground 處理逾時
      </code>
    </td>
    
    <td>
      單次試跑超出處理時間上限
    </td>
    
    <td>
      減少單次勾選的檔案數，或改以較少頁數的檔案試跑
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        AI 服務暫時無法回應，請稍後重試
      </code>
    </td>
    
    <td>
      模型服務當下無法回應
    </td>
    
    <td>
      於 AI Model Center 確認模型狀態為 <strong>
        Running
      </strong>
      
       後重試
    </td>
  </tr>
</tbody>
</table>

## 後續步驟

調校完成的提示詞可套用至排程執行的批次任務，見[設定排程讓 OCR 任務定時處理資料夾中的檔案](https://docs.ardge.com/zh-tw/knowledge/precisemd/schedule-ocr-tasks)。

## 相關文章

- [設定 PreciseMD 的模型連線](https://docs.ardge.com/zh-tw/knowledge/precisemd/model-connection)
- [什麼時候應該啟用視覺校正？](https://docs.ardge.com/zh-tw/knowledge/precisemd/vision-correction)
- [PreciseMD 支援哪些檔案格式與數量限制？](https://docs.ardge.com/zh-tw/knowledge/precisemd/formats-and-limits)


## Sitemap

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