---
title: "PreciseMD でモデル接続を設定する"
description: "PreciseMD には OCR モデルと VLM モデルが必要です。AI Model Center で両方が実行中であることを確認し、モデル ID を取得したうえで、システムが作成した接続を確認します"
canonical_url: "https://docs.ardge.com/ja/knowledge/precisemd/model-connection"
---
# PreciseMD でモデル接続を設定する

> PreciseMD には OCR モデルと VLM モデルが必要です。AI Model Center で両方が実行中であることを確認し、モデル ID を取得したうえで、システムが作成した接続を確認します

## 概要

PreciseMD の解析能力は、2 つの外部モデルによって支えられています。**OCR model** はドキュメント画像内のテキストを認識し、**VLM model**（マルチモーダルモデル）はビジョン補正を担当して、元の画像から表とレイアウトを再構築します。どちらのモデルも、同じ ARX デバイス上の AI Model Center にデプロイされています。

これら 2 つのモデルには、PreciseMD の **Model connections** ページにそれぞれ専用の接続があり、**Default** と表示されます。システムがデプロイ時に両方を作成し、**Name**、**Base URL**、**API key** を入力するため、この 3 つを自分で入力する必要はありません。

そのため、設定作業は短くて済みます。AI Model Center で両方のモデルが実行中であることを確認し、モデル ID を取得したうえで、**Model connections** ページに戻り、2 つのデフォルト接続が正しいモデルを指しているかを確認します。

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

- OCR モデルと VLM モデルの違い、およびそれぞれが PreciseMD で果たす役割
- AI Model Center でモデルのステータスを確認し、モデル ID を取得する
- システムが作成した 2 つのデフォルト接続を **Model connections** ページで確認する
- **Playground** で別のモデルを使いたい場合に、カスタムモデル接続を追加する

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

## 対象バージョン

- PreciseMD 1.4.0 以降
- ARX OS 1.0 以降

## 事前準備

- 同じ ARX デバイス上の AI Model Center に、OCR モデルと VLM モデルをデプロイしていること
- PreciseMD の管理者であること。**Model connections** ページは管理者にのみ公開されています

## 必要な情報

必要なものは 1 つだけです。2 つのモデルそれぞれの **モデル ID** です。

<table>
<thead>
  <tr>
    <th>
      値
    </th>
    
    <th>
      用途
    </th>
    
    <th>
      取得場所
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        Model ID
      </strong>
    </td>
    
    <td>
      <strong>
        Model connections
      </strong>
      
       の <strong>
        Model ID
      </strong>
      
       欄の値を確認する
    </td>
    
    <td>
      AI Model Center の <strong>
        Model Instances
      </strong>
      
       ページに表示される、そのモデルの <strong>
        Instance Name
      </strong>
    </td>
  </tr>
</tbody>
</table>

**Name**、**Base URL**、**API key** はデプロイ環境に合わせてシステムが入力するため、収集するものはありません。

## PreciseMD が必要とする 2 つのモデル

<table>
<thead>
  <tr>
    <th>
      モデル
    </th>
    
    <th>
      役割
    </th>
    
    <th>
      使用される場面
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        OCR model
      </strong>
    </td>
    
    <td>
      ドキュメント画像内のテキストを認識し、Markdown として出力します
    </td>
    
    <td>
      <strong>
        Playground
      </strong>
      
       と <strong>
        OCR tasks
      </strong>
      
       のすべての解析
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        VLM model
      </strong>
    </td>
    
    <td>
      ビジョン補正: 元の画像と照らし合わせて認識結果を補正し、表とレイアウトを再構築します
    </td>
    
    <td>
      <strong>
        Vision correction
      </strong>
      
       を有効にした解析、および <strong>
        Agent
      </strong>
      
      （インターフェース上ではデフォルト VLM と表記されます）
    </td>
  </tr>
</tbody>
</table>

ビジョン補正の役割と使いどころについては、[ビジョン補正はいつ有効にすべきですか？](https://docs.ardge.com/ja/knowledge/precisemd/vision-correction) を参照してください

## ステップ 1: 管理者アカウントを作成する

PreciseMD を初めて開くと、**Create administrator account** が表示されます。すでに登録済みの場合は、サインインしてこのステップを省略してください。

1. 次のように各項目を入力します

<table>
<thead>
  <tr>
    <th>
      項目
    </th>
    
    <th>
      入力値
    </th>
    
    <th>
      ルールと注意事項
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        Username
      </strong>
    </td>
    
    <td>
      管理者のサインイン名
    </td>
    
    <td>
      3〜50 文字
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Email
      </strong>
    </td>
    
    <td>
      管理者のメールアドレス
    </td>
    
    <td>
      有効なメールアドレスである必要があります
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Password
      </strong>
    </td>
    
    <td>
      サインインパスワード
    </td>
    
    <td>
      8〜128 文字
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Confirm password
      </strong>
    </td>
    
    <td>
      <strong>
        Password
      </strong>
      
       と同じ値
    </td>
    
    <td>
      一致しない場合は「Passwords don't match」と表示されます
    </td>
  </tr>
</tbody>
</table>

1. **Create account** をクリックします

これでサインインできます。サイドバーには **Agent**、**Playground**、**OCR tasks**、**Storage connections**、**Model connections**、**User management** が表示されます。

## ステップ 2: AI Model Center で両方のモデル ID を取得する

1. 同じ ARX デバイスで **AI Model Center** を開き、**Model Instances** ページに移動します
2. OCR モデルと VLM モデルの両方が **Running** と表示されていることを確認します
3. それぞれの **Instance Name** を記録します。この文字列がモデル ID です

![AI Model Center のモデルインスタンスページ](https://docs.ardge.com/screenshots/knowledge/ja/precisemd/model-connection/step-2.webp)

<warning>

**モデルが実行中でない間は解析が失敗します：**

ステータスが **Running** ではないモデルは、**Model connections** が正しく設定されていても解析が失敗します。まず AI Model Center でモデルを起動してください。

</warning>

## ステップ 3: 2 つのデフォルトモデル接続を確認する

1. PreciseMD にサインインし、**Model connections** ページに移動します
2. 一覧の中から **Default** と表示された 2 つの接続を探します。1 つは OCR 用、もう 1 つは VLM 用です
3. それぞれの **Model ID** 欄を、ステップ 2 で記録した **Instance Name** と照らし合わせます

一致していれば設定は完了です。そのままステップ 4 に進めます。

接続の **Model ID** が使用したくないモデルを指している場合は、次の手順で変更します。

1. その行の編集アイコンをクリックします
2. **Model ID** のドロップダウンを開きます。システムが **Base URL** からエンドポイントのモデル一覧を取得します
3. ステップ 2 で記録したモデルを選択します
4. **Save** をクリックします

![モデル接続の一覧](https://docs.ardge.com/screenshots/knowledge/ja/precisemd/model-connection/step-3-1.webp)

![モデル接続の編集](https://docs.ardge.com/screenshots/knowledge/ja/precisemd/model-connection/step-3-2.webp)

<warning>

**デフォルト接続の名前は変更できません：**

**Default** と表示された接続はシステムが管理しています。**Name** 欄は無効化され、その下に「The name of a system default model connection can't be changed」と表示されます。この 2 つの接続はどちらも削除できません。

</warning>

<note>

**ベース URL の末尾：**

`/v1` を付けても付けなくても動作します。システムが `/v1/models` のパスを自動的に追加します。

</note>

## ステップ 4: 設定が機能することを確認する

1. **Playground** ページに移動します
2. *Source documents* パネルで **Upload** をクリックし、PDF または画像を選択します
3. そのファイルを選択します
4. **Run** をクリックします

**Advanced settings** でモデルを指定していない場合、この実行ではステップ 3 で確認した 2 つのデフォルト接続が使用されます。

*Run results* パネルにレコードが表示され、**Processing** から **Completed** へと進みます。その行のファイル名をクリックすると解析結果が開き、両方のモデルが動作していることを確認できます。

## カスタムモデル接続を追加する

**Playground** の **Advanced settings** にある OCR と VLM のドロップダウンには、カスタムモデル接続のみが表示され、**Default** と表示された 2 つは含まれません。カスタム接続を作成していない場合、ドロップダウンには「No models available」と表示され、どちらのモデルもデフォルトにフォールバックします。テスト実行で別のモデルの結果と比較したい場合は、ここで追加してください。

1. **Model connections** ページに移動し、**Add model connection** をクリックします
2. 次のように各項目を入力します

<table>
<thead>
  <tr>
    <th>
      項目
    </th>
    
    <th>
      入力値
    </th>
    
    <th>
      ルールと注意事項
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        Name
      </strong>
    </td>
    
    <td>
      この接続を識別する名前
    </td>
    
    <td>
      必須、最大 128 文字
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Base URL
      </strong>
    </td>
    
    <td>
      AI Model Center のモデル API エンドポイント
    </td>
    
    <td>
      必須、OpenAI 互換のエンドポイントである必要があります
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        API key
      </strong>
    </td>
    
    <td>
      AI Model Center で発行した API キー
    </td>
    
    <td>
      任意。空欄または <code>
        null
      </code>
      
       にすると、認証ヘッダーは送信されません
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Model ID
      </strong>
    </td>
    
    <td>
      作成するモデルをドロップダウンから選択します
    </td>
    
    <td>
      必須。システムがエンドポイントから一覧を取得します。複数同時に選択できます
    </td>
  </tr>
</tbody>
</table>

1. **Model ID** のドロップダウンをクリックします。システムが **Base URL** と **API key** を使ってモデル一覧を取得します。上部の検索ボックスで名前を絞り込み、左側のチェックボックスで現在絞り込まれているすべてを選択できます
2. 作成したいモデルを選択します
3. **Create** をクリックします

<warning>

**選択したモデルごとに 1 つの接続が作成されます：**

選択したモデルはそれぞれ個別のモデル接続になり、`<name> / <model ID>` の形式で一覧に表示されます。この結合後の名前は既存の接続と重複してはならず、上限は 255 文字です。

</warning>

送信すると、ページに「N model connections created」と表示され、その数の行が一覧に追加されます。新しい接続は **Playground** の **OCR** と **VLM** のドロップダウンにすぐ表示されます。

カスタム接続の **Base URL** と **API key** は自分で入力します。取得方法については [ARX 上のオンプレミスモデルを API 経由で呼び出す](https://docs.ardge.com/ja/knowledge/arx-os/api-model-calls) を参照してください。**Base URL** にはその記事でモデル API エンドポイントと呼んでいる値を入力し、**API key** には AI Model Center で作成した API キーを入力します。

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

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

<tbody>
  <tr>
    <td>
      <code>
        Couldn't reach the model service — check the base URL, API key, network, and service status
      </code>
    </td>
    
    <td>
      ベース URL が誤っている、または PreciseMD がエンドポイントに到達できない
    </td>
    
    <td>
      AI Model Center の <strong>
        Model Instances
      </strong>
      
       ページでモデルのステータスが <strong>
        Running
      </strong>
      
       であることを確認します。カスタム接続の場合は、入力したベース URL も確認します
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        The model service response doesn't match the expected model list API format
      </code>
    </td>
    
    <td>
      エンドポイントのレスポンスが OpenAI のモデル一覧 API と一致していない
    </td>
    
    <td>
      他のサービスの URL ではなく、モデルゲートウェイのエンドポイントを入力したか確認します
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        Model connection name already exists
      </code>
    </td>
    
    <td>
      結合後の <code>
        <name> / <model ID>
      </code>
      
       が既存の接続と重複している
    </td>
    
    <td>
      別の <strong>
        Name
      </strong>
      
       を使用します
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        The model connection is unreachable or has no models available
      </code>
    </td>
    
    <td>
      エンドポイントには到達できたが、モデルが返されなかった
    </td>
    
    <td>
      AI Model Center で、API キーのモデルスコープに目的のモデルが含まれているか確認します
    </td>
  </tr>
</tbody>
</table>

## 次のステップ

モデル接続を確認したら、**Playground** で特定のドキュメント種別に合わせてプロンプトを調整します。[Playground でプロンプトを調整し、OCR 結果を比較する](https://docs.ardge.com/ja/knowledge/precisemd/playground-prompt-tuning) を参照してください。

## 関連記事

- [ビジョン補正はいつ有効にすべきですか？](https://docs.ardge.com/ja/knowledge/precisemd/vision-correction)
- [PreciseMD が対応するファイル形式と制限は？](https://docs.ardge.com/ja/knowledge/precisemd/formats-and-limits)
- [ARX 上のオンプレミスモデルを API 経由で呼び出す](https://docs.ardge.com/ja/knowledge/arx-os/api-model-calls)


## Sitemap

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