---
title: "設定 ARGENT 的模型連線"
description: "在模型來源設定 Base URL 與 API 金鑰，再於模型設定為大語言、向量化、OCR 與 Enhance 四項用途選擇模型"
canonical_url: "https://docs.ardge.com/zh-tw/knowledge/argent/model-connection"
---
# 設定 ARGENT 的模型連線

> 在模型來源設定 Base URL 與 API 金鑰，再於模型設定為大語言、向量化、OCR 與 Enhance 四項用途選擇模型

## 概觀

ARGENT 本身不含模型，問答、檢索與檔案辨識都交由外部模型處理。這些模型通常部署於同一台 ARX 的 AI Model Center。

**模型連線** 頁面分為兩個分頁：

- **1. 模型來源**：登錄提供模型的服務，每筆來源包含 **名稱**、**Base URL** 與 **API 金鑰**。可登錄多筆來源
- **2. 模型設定**：從已登錄的來源中，為四項用途各選一個模型

設定流程因此分為兩段：先確認模型來源可以連線，再於模型設定選擇要使用的模型。

## 你將學會什麼

- 分辨大語言、向量化、OCR 與 Enhance 四項模型在 ARGENT 中的用途
- 於 AI Model Center 確認模型正在執行
- 新增或核對模型來源
- 為四項用途選擇模型，並掌握日後更換模型的注意事項

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

## 適用版本

- ARGENT 1.0.1 及以上版本

## 開始之前

- 你的帳號具備 ARGENT 的管理員權限
- 已於同一台 ARX 的 AI Model Center 部署大語言模型與向量化模型。要使用 OCR 或 Enhance 模型時，一併部署

## ARGENT 使用的四項模型

<table>
<thead>
  <tr>
    <th>
      模型
    </th>
    
    <th>
      用途
    </th>
    
    <th>
      是否必填
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        大語言模型
      </strong>
    </td>
    
    <td>
      回答問題
    </td>
    
    <td>
      必填
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        向量化模型
      </strong>
    </td>
    
    <td>
      匯入與搜尋時，把文件和查詢轉成向量
    </td>
    
    <td>
      必填
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        OCR 模型
      </strong>
    </td>
    
    <td>
      匯入 PDF、Office 與圖片檔時，逐區塊辨識文字的視覺模型
    </td>
    
    <td>
      選填。留空時使用 OCR 服務自己的部署預設值
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Enhance 模型
      </strong>
    </td>
    
    <td>
      校正辨識結果文字的視覺模型
    </td>
    
    <td>
      選填。留空時使用 OCR 服務自己的部署預設值
    </td>
  </tr>
</tbody>
</table>

必要的模型尚未設定時，ARGENT 會顯示「**模型尚未就緒**」，並提示「**必要的模型尚未設定。請到「模型連線」完成設定。**」。

## 步驟 1：於 AI Model Center 確認模型正在執行

1. 開啟同一台 ARX 的 **AI Model Center**，前往 **Model Instances** 頁面
2. 確認要使用的模型狀態皆為 **Running**

![AI 模型中心的模型實例，四個模型皆為執行中](https://docs.ardge.com/screenshots/knowledge/zh-tw/argent/model-connection/step-1.webp)

<warning>

**模型未在執行時，問答與檔案處理會失敗：**

模型設定所選的模型在來源上找不到時，ARGENT 會顯示「**在模型來源上找不到模型設定所選的模型，可能仍在載入中。請到 ARX AI Model Center 確認狀態。**」。請先於 AI Model Center 啟動該模型。

</warning>

## 步驟 2：核對或新增模型來源

1. 登入 ARGENT 管理介面，前往 **模型連線** 頁面
2. 切換至 **1. 模型來源** 分頁
3. 於左側清單點選要核對的來源，右側會顯示其 **名稱**、**Base URL** 與 **API 金鑰**

ARGENT 部署於 ARX 時，清單中會有一筆指向 ARX 內部模型閘道的來源。核對其 **Base URL** 有值即可，不需要修改。

要新增其他提供 OpenAI 相容 API 的模型服務時：

1. 點擊 **新增模型來源**
2. 依下表填寫欄位
3. 點擊 **儲存**

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

<tbody>
  <tr>
    <td>
      <strong>
        名稱
      </strong>
    </td>
    
    <td>
      此來源的識別名稱，例如 <code>
        My API gateway
      </code>
    </td>
    
    <td>
      必填，不得與既有來源同名
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Base URL
      </strong>
    </td>
    
    <td>
      模型服務的 API 網址，例如 <code>
        https://api.example.com/v1
      </code>
    </td>
    
    <td>
      必填。須為有效的網址
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        API 金鑰
      </strong>
    </td>
    
    <td>
      該服務核發的 API 金鑰
    </td>
    
    <td>
      編輯既有來源時，留空會保留原本的 API 金鑰
    </td>
  </tr>
</tbody>
</table>

儲存成功時，畫面顯示「**已儲存模型來源**」。

![模型連線的模型來源分頁，已選取 ARX 來源](https://docs.ardge.com/screenshots/knowledge/zh-tw/argent/model-connection/step-2.webp)

<note>

**刪除模型來源前，須先改選模型：**

模型設定仍在使用某一筆來源的模型時，該來源無法刪除，畫面會顯示「**模型設定仍在使用這個模型來源，請先在模型設定改選其他模型。**」。

</note>

## 步驟 3：為四項用途選擇模型

1. 切換至 **2. 模型設定** 分頁
2. 於 **大語言模型**、**向量化模型**、**OCR 模型** 與 **Enhance 模型** 四個下拉選單中，各自選擇要使用的模型。選項以「來源名稱 / 模型名稱」顯示，可輸入關鍵字搜尋
3. 點擊 **儲存**

儲存成功時，畫面顯示「**已儲存模型連線設定**」。

![模型連線的模型設定分頁，列出四項模型的下拉選單](https://docs.ardge.com/screenshots/knowledge/zh-tw/argent/model-connection/step-3-1.webp)

![展開大語言模型的下拉選單，選項依模型來源分組列出](https://docs.ardge.com/screenshots/knowledge/zh-tw/argent/model-connection/step-3-2.webp)

<warning>

**變更向量化模型後須重新產生知識：**

修改 **向量化模型** 時，欄位下方會出現「**變更向量化模型後，需要手動重新產生 AI agent 的知識。**」。既有的向量與新模型不在同一個向量空間，不重新產生會使檢索失準。原因與操作方式見[變更向量化模型後，為什麼需要重新生成知識？](https://docs.ardge.com/zh-tw/knowledge/argent/regenerate-knowledge)

</warning>

## 疑難排解

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

<tbody>
  <tr>
    <td>
      <code>
        無法取得以下模型來源的模型清單：<名稱>
      </code>
    </td>
    
    <td>
      該來源目前無法連線，或 API 金鑰有誤
    </td>
    
    <td>
      回到 <strong>
        1. 模型來源
      </strong>
      
       核對其 <strong>
        Base URL
      </strong>
      
       與 <strong>
        API 金鑰
      </strong>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        無法從選定的模型來源取得模型清單，請到「模型來源」檢查它的 Base URL 與 API 金鑰。
      </code>
    </td>
    
    <td>
      儲存模型設定時，所選的來源無法回應
    </td>
    
    <td>
      同上
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        無法從此位址取得模型清單，請檢查 Base URL。
      </code>
    </td>
    
    <td>
      新增或編輯來源時，<strong>
        Base URL
      </strong>
      
       無法連線
    </td>
    
    <td>
      確認網址正確且含通訊協定（<code>
        http://
      </code>
      
       或 <code>
        https://
      </code>
      
      ）
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        此模型來源拒絕了這把 API 金鑰，請確認金鑰是否正確。
      </code>
    </td>
    
    <td>
      <strong>
        API 金鑰
      </strong>
      
       錯誤或已失效
    </td>
    
    <td>
      向該服務重新取得金鑰
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        已有同名的模型來源。
      </code>
    </td>
    
    <td>
      <strong>
        名稱
      </strong>
      
       與既有來源重複
    </td>
    
    <td>
      改用其他名稱
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        請輸入有效的網址（例如 https://api.example.com/v1）。
      </code>
    </td>
    
    <td>
      <strong>
        Base URL
      </strong>
      
       不是合法網址
    </td>
    
    <td>
      補上通訊協定與完整路徑
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        無法更新模型連線，請再試一次。
      </code>
    </td>
    
    <td>
      儲存請求未成功送達
    </td>
    
    <td>
      稍後重新點擊 <strong>
        儲存
      </strong>
    </td>
  </tr>
</tbody>
</table>

## 後續步驟

模型連線設定完成後，即可建立第一個 Agent，見[建立你的第一個 AI Agent](https://docs.ardge.com/zh-tw/knowledge/argent/first-ai-agent)。

## 相關文章

- [變更向量化模型後，為什麼需要重新生成知識？](https://docs.ardge.com/zh-tw/knowledge/argent/regenerate-knowledge)
- [透過 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.