發布新版本的原因有很多,例如提升準確率、增加可用性,以及支援新的文件元素 (例如選取標記)。
由於 Document AI 採用生成式 AI 技術,未來版本將使用新的基礎模型,讓您享有生成式 AI 強化功能。
隨著基礎模型不斷進步,舊版基礎模型將會淘汰。 同樣地,處理器版本會在新版本發布六個月後淘汰。
處理器可採用下列其中一個版本:
本頁說明處理器的版本管理方式,以及如何查看和選取特定版本。

處理器版本總覽
處理器版本分為兩類:
- Google 版本分為穩定版 (適用於正式版用途) 或候選版本 (實驗版,具備最新功能)。
- 使用者版本是由您建立,用於自訂文件預測結果,且版本 ID 為英數字元。
Google 版本
每個 Google 版本都有專屬的版本 ID,例如 pretrained-TYPE-vX.X-YYYY-MM-DD。
Google 提供的每個處理器版本都命名為「Google 穩定版」或「Google 候選版本 (RC)」。
Google 穩定版
穩定版可立即用於正式環境。
- Google 會以處理器的運作穩定性為優先,不過仍會納入關鍵修正內容。
- 如圖所示,最新穩定版發布六個月後,Google 就會淘汰舊版穩定版。

Google 發行候選版 (RC)
候選版處於實驗階段,會透過定期升級加入最新功能。這些並非正式版,穩定性可能有所不同。
自訂版本
自訂版本是根據文件建立的處理器版本,可自訂預測結果。自訂版本會顯示 Type,指出用於預測的模型類型。如果您使用基礎模型建立版本 (無論是建立版本或微調),類型都是「生成式 AI」。如果訓練較小的自訂模型 (以模型或範本為準),然後建立處理器版本,則類型為「自訂」。如果您建立處理器版本,可以自行決定名稱和 ID。
基礎版本
如果您建立處理器版本,「基礎版本」會顯示為自訂使用者版本提供支援的 Google 版本。基礎版本會決定使用者版本的生命週期。 您必須決定如何管理自訂使用者版本的生命週期。
可用的穩定版處理器版本
如要查看不同處理器類型可用的穩定處理器版本,請參閱下表。
| 自訂擷取器 | 發布日期 | 淘汰日期 |
|---|---|---|
pretrained-foundation-model-v1.5-2025-05-05 |
2025 年 5 月 5 日 | 不適用 |
pretrained-foundation-model-v1.5-pro-2025-06-20 |
2025 年 6 月 20 日 | 不適用 |
| 表單剖析器 | 發布日期 | 淘汰日期 |
|---|---|---|
pretrained-form-parser-v1.0-2020-09-23 |
2020 年 9 月 23 日 | 不適用 |
pretrained-form-parser-v2.0-2022-11-10 |
2022 年 11 月 10 日 | 不適用 |
| 版面配置剖析器 | 發布日期 | 淘汰日期 |
|---|---|---|
pretrained-layout-parser-v1.0-2024-06-03 |
2024 年 6 月 3 日 | 不適用 |
| 銀行對帳單剖析器 | 發布日期 | 淘汰日期 |
|---|---|---|
pretrained-bankstatement-v1.0-2021-08-08 |
2021 年 8 月 8 日 | 不適用 |
pretrained-bankstatement-v1.1-2021-08-13 |
2021 年 8 月 13 日 | 不適用 |
pretrained-bankstatement-v2.0-2021-12-10 |
2021 年 12 月 10 日 | 不適用 |
pretrained-bankstatement-v3.0-2022-05-16 |
2022 年 5 月 16 日 | 不適用 |
pretrained-bankstatement-v5.0-2023-12-06 |
2023 年 12 月 6 日 | 不適用 |
| W2 剖析器 | 發布日期 | 淘汰日期 |
|---|---|---|
pretrained-w2-v1.0-2020-10-01 |
2020 年 10 月 1 日 | 2024 年 3 月 31 日 |
pretrained-w2-v1.1-2022-01-27 |
2022 年 1 月 27 日 | 2024 年 3 月 31 日 |
pretrained-w2-v1.2-2022-01-28 |
2022 年 1 月 28 日 | 不適用 |
pretrained-w2-v2.1-2022-06-08 |
2022 年 6 月 8 日 | 不適用 |
| 身分證明文件剖析器 | 發布日期 | 淘汰日期 |
|---|---|---|
pretrained-id-proofing-v1.0-2022-10-03 |
2022 年 10 月 3 日 | 不適用 |
| 薪資單剖析器 | 發布日期 | 淘汰日期 |
|---|---|---|
pretrained-paystub-v1.0-2021-03-19 |
2021 年 3 月 19 日 | 不適用 |
pretrained-paystub-v1.1-2021-08-13 |
2021 年 8 月 13 日 | 不適用 |
pretrained-paystub-v1.2-2021-12-10 |
2021 年 12 月 10 日 | 不適用 |
pretrained-paystub-v2.0-2022-07-22 |
2022 年 7 月 22 日 | 不適用 |
pretrained-paystub-v3.0-2023-12-06 |
2023 年 12 月 6 日 | 不適用 |
| 美國駕照剖析器 | 發布日期 | 淘汰日期 |
|---|---|---|
pretrained-us-driver-license-v1.0-2021-06-14 |
2021 年 6 月 14 日 | 不適用 |
| 費用剖析器 | 發布日期 | 淘汰日期 |
|---|---|---|
pretrained-expense-v1.1-2021-04-09 |
2024 年 4 月 9 日 | 不適用 |
pretrained-expense-v1.4-2022-11-18 |
2022 年 11 月 18 日 | 不適用 |
pretrained-expense-v1.4.2-2024-09-12 |
2024 年 9 月 12 日 | 不適用 |
| 應付憑據剖析器 | 發布日期 | 淘汰日期 |
|---|---|---|
pretrained-invoice-v1.1-2021-04-09 |
2024 年 4 月 9 日 | 不適用 |
pretrained-invoice-v1.2-2022-02-18 |
2022 年 2 月 18 日 | 不適用 |
pretrained-invoice-v1.3-2022-07-15 |
2022 年 7 月 15 日 | 不適用 |
pretrained-invoice-v2.0-2023-12-06 |
2023 年 12 月 6 日 | 不適用 |
| Enterprise Document OCR (光學字元辨識) | 發布日期 | 淘汰日期 |
|---|---|---|
pretrained-ocr-v1.2-2022-11-10 |
2022 年 11 月 10 日 | 不適用 |
pretrained-ocr-v2.0-2023-06-02 |
2023 年 6 月 2 日 | 不適用 |
pretrained-ocr-v2.1-2024-08-07 |
2024 年 8 月 7 日 | 不適用 |

處理器版本生命週期
Google 推出新版本後,請立即使用新版基礎模型建立及評估新版使用者。接著,部署新版本,並取消部署 (或刪除) 以先前穩定版為基礎的舊版使用者版本。新版發布後,穩定版就會停止更新。如果發生這種情況,Google 至少會提前六個月通知您。
如果基底版本已淘汰,會發生什麼情況?
如果基礎版本已淘汰,以該版本為基礎的使用者版本就不會再傳回預測結果。
系統如何為要求選取處理器版本?
如果您呼叫處理器端點時未指定處理器版本,系統會使用預設處理器版本。預設處理器版本變更時,您可能需要更新程式碼。
| 使用的端點 | 資歷 |
|---|---|
| 如未指定處理器版本 ID | 使用新的預設處理器版本處理的要求。 如果預設處理器版本已淘汰,當舊版預設版本淘汰時,預設版本會更新為最近推出的穩定版 Google 版本。 |
| 如果指定處理器版本 ID | 如果您呼叫處理器端點並指定已淘汰的版本 ID,回應就會失敗。 |
自訂版本淘汰範例
請參考下列情境,瞭解自訂版本淘汰的事件順序:
開發人員使用自訂擷取器從文件中取得資料。考量到您處理的文件複雜度和數量,您微調了基礎模型,建立名為「
fine-tune-A」的版本。您可以將fine-tune-A版本設為處理器的預設版本,並用來處理文件。驅動fine-tune-A模型的基礎版本是pretrained-foundation-model-v1.0-2023-08-22 (v1.0)穩定版。Google 發布了名為
pretrained-foundation-model-v1.2-2024-05-10 (v1.2)的新穩定版, 並宣布v1.0穩定版將於 2025 年 4 月 9 日淘汰。由於您將訓練和測試文件保留在處理器的資料集中,因此請根據最新的 Google 穩定版 (
v1.2) 微調另一個版本,並將其命名為fine-tune-B。評估成效後,請將fine-tune-B版本設為處理器的新預設版本,並停用fine-tune-A版本。新版本現在會使用最新支援的 Google 穩定版。
反之,如果您未建立及評估自訂版本,Google 會在 2025 年 4 月 9 日將處理器的預設版本更新為 fine-tune-B
v1.2。由於您呼叫的是處理器的端點,且未指定處理器版本,因此系統會使用新的 v1.2 版本做為新的預設版本來處理要求。
淘汰與遷移資源
如要瞭解已淘汰的剖析器和處理器,請參閱 Document AI 淘汰項目。
如要瞭解遷移作業,請參閱下列資源:
如要建立及訓練新的費用剖析器,請參閱升級預先訓練的處理器。
如要建立及調整新的自訂擷取器處理器,請參閱「使用 GenAI 的自訂擷取器」。
選取處理器版本
您可以透過三種方式,指定用於線上和批次處理的處理器版本:
如果未指定版本,系統會使用處理器的預設版本。
- 範例:
projects/my-proj/locations/us/processors/my-processor:process
- 範例:
如果您指定版本,系統就會使用該特定版本。如果特定版本不存在,要求就會失敗並顯示錯誤。
- 例如:
projects/my-proj/locations/us/processors/my-processor/processorVersions/pretrained-invoice-v1.2-2022-02-18:process
- 例如:
如果您指定管道,系統會使用該管道的最新版本。(選項:
stable、rc)- 例如:
projects/my-proj/locations/us/processors/my-processor/processorVersions/stable:process
- 例如:
查看可用版本
控制台
在 Google Cloud 控制台,依序前往「Document AI」專區和「Processors」頁面。
在處理器清單中,按一下要查看詳細資料的處理器名稱。
選取「管理版本」 (或「部署及使用」) 分頁,系統會顯示所有可用的處理器版本。
REST
這個範例說明如何使用 processorVersions.list 方法,列出處理器的可用版本。
使用任何要求資料之前,請先修改下列項目的值:
- LOCATION:處理器的位置,例如:
us- 美國eu- 歐盟
- PROJECT_ID: Google Cloud 專案 ID。
- PROCESSOR_ID:自訂處理器的 ID。
HTTP 方法和網址:
GET https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions
如要傳送要求,請選擇以下其中一個選項:
curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions"
PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions" | Select-Object -Expand Content
回應包含 ProcessorVersions 清單,其中包含每個處理器版本的相關資訊,例如 name、state 和其他詳細資料。
{
"processorVersions": [
{
"name": "projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/pretrained-ocr-v1.1-2022-09-12",
"displayName": "Google Release Candidate",
"state": "DEPLOYED",
"createTime": "2022-09-13T23:39:12.156648Z",
"googleManaged": true
},
{
"name": "projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/pretrained-ocr-v1.0-2020-09-23",
"displayName": "Google Stable",
"state": "DEPLOYED",
"createTime": "2022-09-12T23:35:09.829557Z",
"googleManaged": true,
"deprecationInfo": {
"deprecationTime": "1970-01-01T00:00:00Z"
}
}
]
}
C#
詳情請參閱 Document AI C# API 參考文件。
如要向 Document AI 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Go
詳情請參閱 Document AI Go API 參考文件。
如要向 Document AI 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Java
詳情請參閱 Document AI Java API 參考文件。
如要向 Document AI 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Python
詳情請參閱 Document AI Python API 參考文件。
如要向 Document AI 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Ruby
詳情請參閱 Document AI Ruby API 參考文件。
如要向 Document AI 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
查看版本詳細資料
控制台
在 Google Cloud 控制台,依序前往「Document AI」專區和「Processors」頁面。
在處理器清單中,按一下要查看詳細資料的處理器名稱。
選取「管理版本」 (或「部署及使用」) 分頁,即可查看所有可用的處理器版本和詳細資料。
REST
這個範例說明如何使用 processorVersions.get 方法,取得處理器版本的詳細資料。
使用任何要求資料之前,請先修改下列項目的值:
- LOCATION:處理器的位置,例如:
us- 美國eu- 歐盟
- PROJECT_ID: Google Cloud 專案 ID。
- PROCESSOR_ID:自訂處理器的 ID。
- PROCESSOR_VERSION:處理器版本 ID。詳情請參閱「選取處理器版本」。例如:
pretrained-TYPE-vX.X-YYYY-MM-DDstablerc
HTTP 方法和網址:
GET https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION
如要傳送要求,請選擇以下其中一個選項:
curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION"
PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION" | Select-Object -Expand Content
回應是 ProcessorVersion,其中包含處理器版本的相關資訊,例如 name、state 和其他詳細資料。
{
"name": "projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/pretrained-ocr-v1.1-2022-09-12",
"displayName": "Google Release Candidate",
"state": "DEPLOYED",
"createTime": "2022-09-13T23:39:12.156648Z",
"googleManaged": true
}
C#
詳情請參閱 Document AI C# API 參考文件。
如要向 Document AI 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Go
詳情請參閱 Document AI Go API 參考文件。
如要向 Document AI 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Java
詳情請參閱 Document AI Java API 參考文件。
如要向 Document AI 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Python
詳情請參閱 Document AI Python API 參考文件。
如要向 Document AI 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Ruby
詳情請參閱 Document AI Ruby API 參考文件。
如要向 Document AI 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
變更預設版本
處理器的預設版本會指定處理文件時使用的版本 (如果未指定特定版本)。建立處理器時,初始預設版本是穩定版的最新版本。
變更預設版本後,系統會使用新選取的版本處理傳入的要求。如果處理器正在處理要求,您變更預設版本,要求仍會繼續使用先前選取的版本。
如要變更預設版本,請按照下列步驟操作:
控制台
在 Google Cloud 控制台,依序前往「Document AI」專區和「Processors」頁面。
在處理器清單中,按一下要查看詳細資料的處理器名稱。
在處理器的「管理版本」 (或「部署及使用」) 分頁中,從「預設版本」下拉式選單選擇要設為預設版本的處理器版本。
REST
這個範例說明如何使用 processors.setDefaultProcessorVersion 方法,為處理器設定預設處理器版本。
使用任何要求資料之前,請先修改下列項目的值: