---
title: "Playground でプロンプトを調整し、OCR 結果を比較する"
description: "ワークスペースごとに実行を分け、ビジョン補正のプロンプトとモデルを調整し、2 つの実行結果を並べて比較して変化を確認します"
canonical_url: "https://docs.ardge.com/ja/knowledge/precisemd/playground-prompt-tuning"
---
# Playground でプロンプトを調整し、OCR 結果を比較する

> ワークスペースごとに実行を分け、ビジョン補正のプロンプトとモデルを調整し、2 つの実行結果を並べて比較して変化を確認します

## 概要

ドキュメント種別が異なれば、必要なプロンプトも異なります。**Playground** はすべての実行記録を保持するため、同じファイルに対してプロンプトとモデルを繰り返し調整し、2 つの結果を並べて比較しながら、**OCR task** で使用する設定を決められます。

この記事では、ワークスペースの作成、**Advanced settings** でのビジョン補正プロンプトとモデルの調整、単一の結果の確認、そして **Compare** を使った 2 つの実行の差分確認について説明します。

## この記事で学べること

- ワークスペースを使って、ドキュメント種別ごとに実行記録を分ける
- ビジョン補正のプロンプトを調整し、OCR モデルと VLM モデルを選択する
- 実行のソースファイル、OCR 領域、Markdown 出力を確認する
- 2 つの実行を並べて比較し、プロンプトによる変化を確認する

**所要時間: 約 20 分**

## 対象バージョン

- PreciseMD 1.4.0 以降

## 事前準備

- **Model connections** の設定を確認済みで、OCR モデルと VLM モデルの両方が AI Model Center で **Running** と表示されていること。[PreciseMD でモデル接続を設定する](https://docs.ardge.com/ja/knowledge/precisemd/model-connection) を参照してください
- 調整に使う代表的なドキュメントを用意していること。対応形式とサイズ上限については [PreciseMD が対応するファイル形式と制限は？](https://docs.ardge.com/ja/knowledge/precisemd/formats-and-limits) を参照してください

## ステップ 1: ワークスペースを作成してファイルをアップロードする

ワークスペースは、その中のすべての実行記録とファイルを保持します。ドキュメント種別ごとに 1 つ作成し、請求書、契約書、レポートをそれぞれ別のワークスペースに分けてください。

1. **Playground** ページに移動します
2. ページ右上の **Workspace** セレクターの横にある追加アイコンをクリックし、**Create workspace** ダイアログを開きます
3. **Workspace name** に名前を入力し、**Create** をクリックします
4. *Source documents* パネルで **Upload** をクリックします
5. ダイアログにファイルをドラッグするか、クリックしてファイルを選択し、アップロードをクリックします

<note>

**1 回のアップロード上限：**

50 ファイルです。ダイアログの下部に「N / 50 files selected」と表示されます。

</note>

システムは自動的に新しいワークスペースに切り替わり、*Source documents* パネルにアップロードしたファイルが **Name**、**Size**、**Modified** の列とともに一覧表示されます。

![プレイグラウンドのページ](https://docs.ardge.com/screenshots/knowledge/ja/precisemd/playground-prompt-tuning/step-1-1.webp)

![ワークスペースの作成](https://docs.ardge.com/screenshots/knowledge/ja/precisemd/playground-prompt-tuning/step-1-2.webp)

![ファイルのアップロード](https://docs.ardge.com/screenshots/knowledge/ja/precisemd/playground-prompt-tuning/step-1-3.webp)

## ステップ 2: ビジョン補正とプロンプトを設定する

1. *Source documents* パネルで、実行するファイルを選択します
2. パネルの下にある **Advanced settings** をクリックします
3. **Vision correction** のトグルをオンにします
4. プロンプトエディターに、このドキュメントの種別と内容を記述します

<tip>

**ファイル種別と内容を記述すると精度が向上します：**

プロンプト欄の例には「A scanned invoice with a line-item table and a total.」と表示されています。記述が実際のドキュメントに近いほど、補正の精度は高くなります。

</tip>

<warning>

**ビジョン補正なしではプロンプトを入力できません：**

**Vision correction** がオフの間、プロンプトエディターは無効化され、「Enable vision correction first to enter a prompt.」と表示されます。

</warning>

**Vision correction** をオンにすると、プロンプトエディターと **Model connections** セクションの **VLM** ドロップダウンの両方が使用可能になります。

![詳細設定とビジョン補正](https://docs.ardge.com/screenshots/knowledge/ja/precisemd/playground-prompt-tuning/step-2-1.webp)

![プロンプトの入力](https://docs.ardge.com/screenshots/knowledge/ja/precisemd/playground-prompt-tuning/step-2-2.webp)

## ステップ 3: OCR モデルと VLM モデルを選択する

**Advanced settings** の **Model connections** セクションでは、2 つのモデルを別々に設定できます。未設定のままにすると、システムのデフォルトモデルが使用されます。

1. **OCR** ドロップダウンで、使用するモデル接続を選択します
2. **VLM** ドロップダウンで、補正に使用するマルチモーダルモデルの接続を選択します

<note>

**ドロップダウンに表示される内容：**

カスタムモデル接続のみで、**Default** と表示された 2 つは含まれません。カスタム接続を作成していない場合、ドロップダウンには「No models available」と表示され、どちらのモデルもデフォルトにフォールバックします。

</note>

未設定の場合、どちらのドロップダウンにも「Select to override the default model」と表示されます。

![利用可能なモデルがないモデルメニュー](https://docs.ardge.com/screenshots/knowledge/ja/precisemd/playground-prompt-tuning/step-3.webp)

## ステップ 4: 実行して結果を確認する

1. *Source documents* パネルでファイルが選択されていることを確認します。何も選択せずに **Run** をクリックすると、「Select a file before running」と表示されます
2. **Run** をクリックします
3. 右側の *Run results* パネルで、その行のファイル名をクリックします

*Run results* パネルには **File**、**Status**、**Time**、**Prompt** の列があり、ステータスは **Processing** から **Completed** へと進みます。ステータスが **Completed** または **Failed** のレコードは、ファイル名をクリックすると開きます。

結果ウィンドウには 2 つの表示切り替えがあります。

<table>
<thead>
  <tr>
    <th>
      切り替え
    </th>
    
    <th>
      オプション
    </th>
    
    <th>
      表示内容
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      画像表示
    </td>
    
    <td>
      <strong>
        Source
      </strong>
    </td>
    
    <td>
      ページの元の画像
    </td>
  </tr>
  
  <tr>
    <td>
      画像表示
    </td>
    
    <td>
      <strong>
        OCR regions
      </strong>
    </td>
    
    <td>
      検出されたレイアウトブロックを画像上に表示
    </td>
  </tr>
  
  <tr>
    <td>
      テキスト表示
    </td>
    
    <td>
      <strong>
        Preview
      </strong>
    </td>
    
    <td>
      Markdown をレンダリングした結果
    </td>
  </tr>
  
  <tr>
    <td>
      テキスト表示
    </td>
    
    <td>
      <strong>
        Markdown
      </strong>
    </td>
    
    <td>
      生の Markdown
    </td>
  </tr>
</tbody>
</table>

ウィンドウ上部には、この実行で使用した OCR モデルと VLM モデルも表示されます。未設定の場合は **Default** と表示されます。

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

![結果ウィンドウ（元ファイルとプレビュー）](https://docs.ardge.com/screenshots/knowledge/ja/precisemd/playground-prompt-tuning/step-4-2.webp)

![OCR 領域と Markdown ソース](https://docs.ardge.com/screenshots/knowledge/ja/precisemd/playground-prompt-tuning/step-4-3.webp)

## ステップ 5: プロンプトを調整して 2 つの結果を比較する

1. **Advanced settings** に戻り、プロンプトを編集します
2. 同じファイルを選択したまま、もう一度 **Run** をクリックします
3. *Run results* に 2 つ目の **Completed** レコードが表示されたら、いずれかのレコードのファイル名をクリックします
4. 結果ウィンドウで **Compare** をクリックします
5. 右半分のドロップダウンで、もう一方のレコードを選択します

<note>

**比較できる対象：**

同じワークスペース内で、同じファイル名に対して実行され、ステータスが **Completed** のもの。未選択の場合、ドロップダウンには「Select a run above to compare」と表示されます。

</note>

比較ウィンドウでは、3 つのタブで両方の結果が並べて表示されます。

- **Preview** — 左右それぞれのレンダリングされた Markdown
- **Markdown** — 左右それぞれの生の Markdown
- **Diff** — 行単位で示された差分

左右のヘッダーには、その実行の **Prompt**、**OCR** モデルと **VLM** モデル、および処理にかかった秒数が表示されます。複数ページのドキュメントでは、ウィンドウ下部のページナビゲーションで左右を同時に移動できます。

![比較（実行結果を未選択）](https://docs.ardge.com/screenshots/knowledge/ja/precisemd/playground-prompt-tuning/step-5-1.webp)

![比較（プレビューを並べて表示）](https://docs.ardge.com/screenshots/knowledge/ja/precisemd/playground-prompt-tuning/step-5-2.webp)

![比較（差分）](https://docs.ardge.com/screenshots/knowledge/ja/precisemd/playground-prompt-tuning/step-5-3.webp)

## ステップ 6: ワークスペース内のファイルを整理する

1. *Source documents* パネルで、不要になったファイルを選択します
2. ページ右上の **Delete (N)** をクリックします
3. **Delete selected files** ダイアログで **Delete** をクリックします

削除したファイルは復元できず、*Source documents* パネルにも表示されなくなります。

![選択したファイルの削除](https://docs.ardge.com/screenshots/knowledge/ja/precisemd/playground-prompt-tuning/step-6.webp)

## トラブルシューティング

<table>
<thead>
  <tr>
    <th>
      メッセージ
    </th>
    
    <th>
      考えられる原因
    </th>
    
    <th>
      対処方法
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        Workspace name already exists
      </code>
    </td>
    
    <td>
      名前が既存のワークスペースと重複している
    </td>
    
    <td>
      ステップ 1 に戻り、別の名前を使用します
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        Select a file before running
      </code>
    </td>
    
    <td>
      <em>
        Source documents
      </em>
      
       パネルでファイルが選択されていない
    </td>
    
    <td>
      ステップ 4 に戻り、実行するファイルを選択します
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        No models available
      </code>
    </td>
    
    <td>
      カスタムモデル接続がまだ存在しない
    </td>
    
    <td>
      <a href="https://docs.ardge.com/ja/knowledge/precisemd/model-connection">
        PreciseMD でモデル接続を設定する
      </a>
      
       の「カスタムモデル接続を追加する」に従って追加します
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        Playground processing timed out
      </code>
    </td>
    
    <td>
      実行が処理時間の上限を超えた
    </td>
    
    <td>
      1 回の実行あたりのファイル数を減らすか、ページ数の少ないドキュメントを使用します
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        The AI service is temporarily unavailable. Try again later
      </code>
    </td>
    
    <td>
      モデルサービスが応答していない
    </td>
    
    <td>
      AI Model Center でモデルのステータスが <strong>
        Running
      </strong>
      
       であることを確認し、再試行します
    </td>
  </tr>
</tbody>
</table>

## 次のステップ

調整したプロンプトをスケジュール実行のバッチタスクに適用します。[OCR タスクをスケジュールしてフォルダーを自動処理する](https://docs.ardge.com/ja/knowledge/precisemd/schedule-ocr-tasks) を参照してください。

## 関連記事

- [PreciseMD でモデル接続を設定する](https://docs.ardge.com/ja/knowledge/precisemd/model-connection)
- [ビジョン補正はいつ有効にすべきですか？](https://docs.ardge.com/ja/knowledge/precisemd/vision-correction)
- [PreciseMD が対応するファイル形式と制限は？](https://docs.ardge.com/ja/knowledge/precisemd/formats-and-limits)


## Sitemap

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