---
title: "建立個人存取權杖供 AI 代理使用"
description: "建立個人存取權杖並安全保存、依用途設定權限等級與資料來源範圍，以及日後修改範圍或撤銷權杖"
canonical_url: "https://docs.ardge.com/zh-tw/knowledge/precisemd/access-tokens"
---
# 建立個人存取權杖供 AI 代理使用

> 建立個人存取權杖並安全保存、依用途設定權限等級與資料來源範圍，以及日後修改範圍或撤銷權杖

## 概觀

個人存取權杖（Personal Access Token）是供 AI 代理以某位使用者的身分呼叫 PreciseMD API 的長期憑證。透過 MCP 或 CLI 存取 PreciseMD 時，皆以此權杖通過驗證。

每一組權杖各自帶有兩層範圍：**權限** 決定可執行哪一類操作，**資料來源範圍** 決定可存取哪些儲存空間連線。本文說明如何建立權杖、設定其範圍、日後修改範圍，以及在權杖外洩時將其撤銷。

## 你將學會什麼

- 建立個人存取權杖並安全保存
- 依用途選擇適當的權限等級與資料來源範圍
- 檢視權杖的最後使用時間與到期狀態
- 修改既有權杖的範圍，或將其撤銷

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

## 適用版本

- PreciseMD 1.4.0 及以上版本

## 開始之前

- 已建立要授權的儲存空間連線。若打算逐一指定資料來源範圍，這些連線須先存在
- 你具備 PreciseMD 的管理者身分

<warning>

**一般成員無法自行建立權杖：**

個人存取權杖的入口位於 **使用者管理** 頁面，一般成員看不到管理者介面。成員所需的權杖須由管理者代為建立後交付。

</warning>

## 步驟 1：開啟該使用者的權杖列表

1. 前往 **使用者管理** 頁面
2. 於要建立權杖的使用者所在列，點擊 **管理個人存取權杖** 的鑰匙圖示

**個人存取權杖** 視窗顯示「使用者：<帳號>」，並列出該使用者既有的權杖。尚無權杖時顯示「此使用者尚無個人存取權杖（Personal Access Token）」。

![使用者管理頁](https://docs.ardge.com/screenshots/knowledge/zh-tw/precisemd/access-tokens/step-1-1.webp)

![個人存取權杖視窗](https://docs.ardge.com/screenshots/knowledge/zh-tw/precisemd/access-tokens/step-1-2.webp)

## 步驟 2：建立權杖

1. 於視窗上方點擊 **建立**
2. 依下表填寫欄位

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

<tbody>
  <tr>
    <td>
      <strong>
        名稱
      </strong>
    </td>
    
    <td>
      這組權杖的識別名稱
    </td>
    
    <td>
      必填，須為 1–100 個字元。建議寫明用途與使用裝置，例如 <code>
        Claude Desktop on MacBook
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        權限
      </strong>
    </td>
    
    <td>
      三個等級擇一
    </td>
    
    <td>
      見下方「權限等級」
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        資料來源範圍
      </strong>
    </td>
    
    <td>
      開啟 <strong>
        授權所有資料來源
      </strong>
      
      ，或逐一勾選
    </td>
    
    <td>
      兩者皆未設定時無法送出
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        到期時間
      </strong>
    </td>
    
    <td>
      權杖失效的日期
    </td>
    
    <td>
      選填，可選取今日之後的日期。留空代表永不過期
    </td>
  </tr>
</tbody>
</table>

1. 點擊 **儲存**

<warning>

**完整的 token 只顯示一次：**

建立後畫面顯示 **個人存取權杖已建立**，並提示「請立即複製，關閉視窗後將無法再次取得完整 token。」請點擊複製圖示保存後，再點擊 **我已安全保存**。未保存時只能撤銷該權杖並重新建立。

</warning>

### 權限等級

<table>
<thead>
  <tr>
    <th>
      等級
    </th>
    
    <th>
      可執行的操作
    </th>
  </tr>
</thead>

<tbody>
  <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>

<tip>

**依用途給予最小權限：**

只做內容擷取的代理選擇 **僅可讀取**；需要建立任務的代理選擇 **可讀寫、不可刪除**。**可讀寫與刪除** 僅在代理確實需要刪除資源時使用。

</tip>

### 資料來源範圍

- 開啟 **授權所有資料來源**：該權杖可存取全部的儲存空間連線，包含日後新增的連線
- 關閉 **授權所有資料來源**：於下拉選單逐一勾選要授權的連線，按鈕顯示「已選 N 個資料來源」

兩者皆未設定即送出時，欄位下方顯示「請至少選擇一個資料來源，或開啟全部授權」。

![建立權杖表單](https://docs.ardge.com/screenshots/knowledge/zh-tw/precisemd/access-tokens/step-2-1.webp)

![填寫名稱與資料來源範圍](https://docs.ardge.com/screenshots/knowledge/zh-tw/precisemd/access-tokens/step-2-2.webp)

## 步驟 3：檢視權杖狀態

回到 **個人存取權杖** 視窗，每一組權杖顯示名稱與其到期狀態：**永不過期**、**將於 <日期> 過期**、**已於 <日期> 過期** 或 **已於 <日期> 撤銷**。

點擊該列的 **詳情** 可檢視完整資訊：

<table>
<thead>
  <tr>
    <th>
      項目
    </th>
    
    <th>
      內容
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        名稱
      </strong>
    </td>
    
    <td>
      建立時填寫的名稱
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Token
      </strong>
    </td>
    
    <td>
      遮蔽後的權杖字串，用於辨識是哪一組
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        建立時間
      </strong>
    </td>
    
    <td>
      權杖的建立時間
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        最後使用
      </strong>
    </td>
    
    <td>
      最近一次以此權杖呼叫 API 的時間
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        到期時間
      </strong>
    </td>
    
    <td>
      到期日期，或 <strong>
        永不過期
      </strong>
    </td>
  </tr>
</tbody>
</table>

已過期或已撤銷的權杖，**詳情** 按鈕為停用狀態。

![權杖詳情](https://docs.ardge.com/screenshots/knowledge/zh-tw/precisemd/access-tokens/step-3.webp)

## 步驟 4：修改或撤銷權杖

修改既有權杖的範圍：

1. 於 **個人存取權杖** 視窗點擊該列的 **詳情**
2. 調整 **權限** 或 **資料來源範圍**
3. 點擊 **儲存**

畫面顯示「權限範圍已更新」。**名稱** 與 **到期時間** 於建立後無法修改。

撤銷權杖：

1. 於 **個人存取權杖** 視窗點擊該列的 **撤銷**
2. 於確認視窗再次點擊 **撤銷**

<warning>

**撤銷無法復原：**

撤銷後使用此權杖的呼叫會立即失敗。該代理須改用新建立的權杖。

</warning>

畫面顯示「已撤銷「<名稱>」」，該列標示為 **已於 <日期> 撤銷**。

## 相關文章

- [設定排程讓 OCR 任務定時處理資料夾中的檔案](https://docs.ardge.com/zh-tw/knowledge/precisemd/schedule-ocr-tasks)
- [透過智慧代理以對話方式操作 PreciseMD](https://docs.ardge.com/zh-tw/knowledge/precisemd/built-in-agent)


## Sitemap

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