---
title: "透過智慧代理以對話方式操作 PreciseMD"
description: "確認代理可用、以教學範例開始對話、上傳檔案交由代理解析，並管理思考開關與對話歷史"
canonical_url: "https://docs.ardge.com/zh-tw/knowledge/precisemd/built-in-agent"
---
# 透過智慧代理以對話方式操作 PreciseMD

> 確認代理可用、以教學範例開始對話、上傳檔案交由代理解析，並管理思考開關與對話歷史

## 概觀

**智慧代理** 是 PreciseMD 內建的對話介面，位於側邊選單的第一個項目。你以自然語言描述要做的事，代理會呼叫對應的功能完成操作，過程中每一次呼叫的參數與結果都會顯示在對話中。

本文說明如何確認代理已可使用、以教學範例開始第一段對話、上傳檔案交由代理解析，以及管理對話歷史。

## 你將學會什麼

- 確認部署已具備代理所需的模型設定
- 以教學範例開始第一段對話
- 上傳檔案，交由代理完成 OCR 並取得預覽連結
- 依需要開關 **思考**，並管理對話歷史

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

## 適用版本

- PreciseMD 1.4.0 及以上版本

## 開始之前

- 已完成模型連線設定。設定方式見[設定 PreciseMD 的模型連線](https://docs.ardge.com/zh-tw/knowledge/precisemd/model-connection)

## 步驟 1：確認代理已可使用

1. 於側邊選單點擊 **智慧代理**

代理可用時，畫面下方的輸入框可輸入文字，提示文字為「輸入任何問題…」。

![智慧代理頁與教學範例](https://docs.ardge.com/screenshots/knowledge/zh-tw/precisemd/built-in-agent/step-1.webp)

<warning>

**未設定 Default VLM 時無法送出訊息：**

畫面頂端顯示「此部署尚未設定 Default VLM。」時，輸入框為停用狀態。Default VLM 即 **模型連線** 頁面中標示 **預設** 的 VLM 連線，請依[設定 PreciseMD 的模型連線](https://docs.ardge.com/zh-tw/knowledge/precisemd/model-connection)步驟 3 核對其 **模型 ID**，並確認該模型於 AI Model Center 的狀態為 **Running**。

</warning>

## 步驟 2：以教學範例開始對話

畫面左側的 *教學範例* 面板提供三個入門情境，各自列出該情境的操作步驟。

<table>
<thead>
  <tr>
    <th>
      範例
    </th>
    
    <th>
      涵蓋的操作
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        上傳檔案做 OCR
      </strong>
    </td>
    
    <td>
      上傳檔案、選擇視覺校正開關、取得結果預覽連結
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        設定資料來源與任務
      </strong>
    </td>
    
    <td>
      建立 SMB／NAS 連線、設定模型連線、建立讀取該連線的 OCR 任務
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Model provider + Playground
      </strong>
    </td>
    
    <td>
      新增模型連線、於遊樂場選擇模型、執行 OCR 並檢視結果
    </td>
  </tr>
</tbody>
</table>

1. 點擊任一張範例卡片

該範例的起始問句會自動填入輸入框，你可直接送出或先行修改。

![範例問句自動填入](https://docs.ardge.com/screenshots/knowledge/zh-tw/precisemd/built-in-agent/step-2.webp)

## 步驟 3：送出訊息並檢視代理的操作

1. 於輸入框輸入指令
2. 按下 Enter 送出

輸入框下方標示「Enter 送出 · Shift + Enter 換行」。代理執行期間，右側的送出按鈕變為 **停止**，點擊即可中斷本次執行。

代理每呼叫一項功能，對話中會出現一張卡片，顯示該次呼叫的 **參數** 與 **結果**，狀態依序為 **執行中**、**完成** 或 **失敗**。

代理可操作的範圍涵蓋下列項目：

<table>
<thead>
  <tr>
    <th>
      範圍
    </th>
    
    <th>
      內容
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        資料來源
      </strong>
    </td>
    
    <td>
      管理 SMB／NAS 連線
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        任務
      </strong>
    </td>
    
    <td>
      建立與管理 OCR 任務
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        執行
      </strong>
    </td>
    
    <td>
      執行與監控 OCR 作業
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        結果
      </strong>
    </td>
    
    <td>
      檢視 OCR 結果
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        遊樂場
      </strong>
    </td>
    
    <td>
      提示詞實驗
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        提示詞範本
      </strong>
    </td>
    
    <td>
      管理提示詞範本
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        模型連線
      </strong>
    </td>
    
    <td>
      管理模型連線
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        使用者
      </strong>
    </td>
    
    <td>
      使用者管理
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        存取權杖
      </strong>
    </td>
    
    <td>
      管理個人存取權杖
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        總覽
      </strong>
    </td>
    
    <td>
      唯讀的系統總覽
    </td>
  </tr>
</tbody>
</table>

![工具呼叫卡片與回答](https://docs.ardge.com/screenshots/knowledge/zh-tw/precisemd/built-in-agent/step-3-1.webp)

![完整回答](https://docs.ardge.com/screenshots/knowledge/zh-tw/precisemd/built-in-agent/step-3-2.webp)

<tip>

**需要填寫多個欄位時，代理會提供表單連結：**

建立資料來源、任務或模型連線時，代理可能回覆一個連結。點擊後會開啟該功能原本的建立視窗，其中已內建資料夾選擇器與共享資料夾清單。於視窗中完成建立後，代理會收到結果並接續處理。

</tip>

## 步驟 4：上傳檔案交由代理解析

1. 點擊輸入框左下角的迴紋針圖示 **附加檔案做 OCR**
2. 選取要解析的檔案，或直接將檔案拖放至輸入區

檔案上傳後，輸入框上方顯示該檔案的名稱，點擊其右側的叉號可移除。

1. 輸入要代理執行的動作後送出

代理會將檔案送入解析流程；解析完成後，代理於對話中提供該筆結果的預覽連結，點擊即可在對話中檢視輸出。

<note>

**上傳的檔案存放位置：**

代理上傳的檔案會放入 **遊樂場** 中名為 `Agent Uploads` 的工作區，可於該處查看與刪除。

</note>

## 步驟 5：依需要開關思考

輸入框右下角的 **思考** 開關，控制代理是否串流模型的推理過程。

- 關閉：回應較快，工具呼叫較穩定
- 開啟：對話中額外顯示 **思考過程**，執行速度較慢

介面的說明文字為「關閉較快、工具呼叫較穩定。開啟會串流模型的推理過程（較慢）。」

## 步驟 6：管理對話歷史

畫面右側為對話歷史面板，依最後更新時間排序，每段對話以其第一則訊息的前 40 個字作為標題。

- 建立新對話：點擊 **開新對話**，或於輸入框送出 `/new` 或 `/clear`
- 切換對話：點擊歷史面板中的任一段對話
- 刪除對話：將游標移至該段對話上，點擊 **刪除對話** 的垃圾桶圖示

左右兩側的面板皆可由標題列的圖示收合：左側為 **切換教學範例**，右側為 **切換聊天歷史**。

![對話歷史與刪除圖示](https://docs.ardge.com/screenshots/knowledge/zh-tw/precisemd/built-in-agent/step-6.webp)

## 相關文章

- [設定 PreciseMD 的模型連線](https://docs.ardge.com/zh-tw/knowledge/precisemd/model-connection)
- [建立個人存取權杖供 AI 代理使用](https://docs.ardge.com/zh-tw/knowledge/precisemd/access-tokens)
- [在遊樂場調校提示詞並比較解析結果](https://docs.ardge.com/zh-tw/knowledge/precisemd/playground-prompt-tuning)


## Sitemap

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