新版本發布的原因有很多,例如提高準確度、提高可用性,以及支援新的文件元素 (例如選取標記)。
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」。如果您透過訓練較小的自訂模型 (以模型或範本為基礎) 來建立處理器版本,則類型為「Custom」(自訂)。如果您建立處理器版本,則可自行決定名稱和 ID。
基礎版本
如果您建立處理器版本,「基本版本」會顯示自訂使用者版本採用的是哪個 Google 版本。基本版本會決定使用者版本的生命週期。您必須決定如何管理自訂使用者版本的生命週期。
可用的穩定版處理器版本
您可以在下表中查看不同處理器類型的可用穩定處理器版本。
| Custom Extractor | 推出日期 | 淘汰日期 |
|---|---|---|
pretrained-foundation-model-v1.5-2025-05-05 |
2025 年 5 月 5 日 | 不適用 |
pretrained-foundation-model-v1.5-pro-2025-06-20 |
2025 年 6 月 20 日 | 不適用 |
pretrained-foundation-model-v3.1-lite-2026-10-08 |
2026 年 10 月 8 日 | 不適用 |
| 表單剖析器 | 推出日期 | 淘汰日期 |
|---|---|---|
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-layout-parser-v3.5-2026-07-09 |
2026 年 11 月 18 日 | 不適用 |
| 銀行對帳單剖析器 | 推出日期 | 淘汰日期 |
|---|---|---|
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 日 | 不適用 |
| W-2 表單剖析器 | 推出日期 | 淘汰日期 |
|---|---|---|
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 支援的最新穩定版。
另一方面,如果您未建立及評估自訂 fine-tune-B 版本,Google 就會在 2025 年 4 月 9 日將處理器的預設版本更新為 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」(處理器) 頁面。
在處理器清單中,按一下要查看詳細資料的處理器名稱。
選取「Manage Versions」(管理版本) (或「Deploy & use」(部署及使用)) 分頁,即可查看所有可用的處理器版本和詳細資料。
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」(處理器) 頁面。
在處理器清單中,按一下要查看詳細資料的處理器名稱。
在處理器的「Manage Versions」(管理版本) (或「Deploy & use」(部署及使用)) 分頁中,從「Default version」(預設版本) 下拉式選單中,選擇要設為預設版本的處理器版本。
REST
這個範例說明如何使用 processors.setDefaultProcessorVersion 方法,設定處理器的預設版本。
使用任何要求資料之前,請先修改下列項目的值:
- LOCATION:處理器的位置,例如:
us- 美國eu- 歐盟
- PROJECT_ID: Google Cloud 專案 ID。
- PROCESSOR_ID:自訂處理器的 ID。
- PROCESSOR_VERSION:處理器版本 ID。詳情請參閱「選取處理器版本」。例如:
pretrained-TYPE-vX.X-YYYY-MM-DDstablerc
HTTP 方法和網址:
POST https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID:setDefaultProcessorVersion
JSON 要求內文:
{
"defaultProcessorVersion": "PROCESSOR_VERSION"
}
如要傳送要求,請選擇以下其中一個選項:
curl
將要求主體儲存在名為 request.json 的檔案中,然後執行下列指令:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID:setDefaultProcessorVersion"
PowerShell
將要求主體儲存在名為 request.json 的檔案中,然後執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID:setDefaultProcessorVersion" | Select-Object -Expand Content
回應會是長時間執行的作業。如要輪詢長時間執行的作業,請呼叫 operations.get
回應中的 SetDefaultProcessorVersionMetadata 表示作業狀態。
{
"name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION",
"metadata": {
"@type": "type.googleapis.com/google.cloud.documentai.v1.SetDefaultProcessorVersionMetadata",
"commonMetadata": {
"state": "SUCCEEDED",
"createTime": "2022-03-02T22:52:49.957096Z",
"updateTime": "2022-03-02T22:52:50.175976Z",
"resource": "projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION"
}
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.documentai.v1.SetDefaultProcessorVersionResponse"
}
}
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 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
部署處理器版本
使用 Document AI 建立新的處理器版本後,必須先部署該版本,才能使用該版本處理文件。
控制台
在 Google Cloud 控制台,依序前往「Document AI」專區和「Processors」(處理器) 頁面。
在處理器清單中,按一下要查看詳細資料的處理器名稱。
在處理器的「Manage Versions」(管理版本) (或「Deploy & use」(部署及使用)) 分頁中,找出要部署的處理器版本,然後勾選旁邊的核取方塊。
依序點選「部署」和對話方塊視窗中的「部署」。這項程序會在幾分鐘內完成。
REST
這個範例說明如何使用 processorVersions.deploy 方法,為處理器部署處理器版本。
使用任何要求資料之前,請先修改下列項目的值:
- LOCATION:處理器的位置,例如:
us- 美國eu- 歐盟
- PROJECT_ID: Google Cloud 專案 ID。
- PROCESSOR_ID:自訂處理器的 ID。
- PROCESSOR_VERSION:處理器版本 ID。
HTTP 方法和網址:
POST https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION:deploy
如要傳送要求,請選擇以下其中一個選項:
curl
執行下列指令:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d "" \
"https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION:deploy"
PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-Uri "https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION:deploy" | Select-Object -Expand Content
回應會是長時間執行的作業。如要輪詢長時間執行的作業,請呼叫 operations.get
回應中的 DeployProcessorVersionMetadata 表示作業狀態。
{
"name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION",
"metadata": {
"@type": "type.googleapis.com/google.cloud.documentai.v1.DeployProcessorVersionMetadata",
"commonMetadata": {
"state": "SUCCEEDED",
"createTime": "2022-08-29T16:27:00.195539Z",
"updateTime": "2022-08-29T16:32:01.963962Z",
"resource": "projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION"
}
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.documentai.v1.DeployProcessorVersionResponse"
}
}
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 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
取消部署處理器版本
使用 Document AI 建立新的處理器版本並部署後,如果您不希望處理器版本能夠處理要求,可以取消部署。
控制台
在 Google Cloud 控制台,依序前往「Document AI」專區和「Processors」(處理器) 頁面。
在處理器清單中,按一下要查看詳細資料的處理器名稱。
在處理器的「Manage Versions」(管理版本) (或「Deploy & use」(部署及使用)) 分頁中,找出要取消部署的處理器版本,然後勾選旁邊的核取方塊。
依序點選「取消部署」和對話方塊視窗中的「取消部署」。這項程序需要幾分鐘才能完成。
REST
這個範例說明如何使用 processorVersions.undeploy 方法,取消部署處理器的處理器版本。
使用任何要求資料之前,請先修改下列項目的值:
- LOCATION:處理器的位置,例如:
us- 美國eu- 歐盟
- PROJECT_ID: Google Cloud 專案 ID。
- PROCESSOR_ID:自訂處理器的 ID。
- PROCESSOR_VERSION:處理器版本 ID。
HTTP 方法和網址:
POST https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION:undeploy
如要傳送要求,請選擇以下其中一個選項:
curl
執行下列指令:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d "" \
"https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION:undeploy"
PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-Uri "https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION:undeploy" | Select-Object -Expand Content
回應會是長時間執行的作業。如要輪詢長時間執行的作業,請呼叫 operations.get
回應中的 UndeployProcessorVersionMetadata 表示作業狀態。
{
"name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION",
"metadata": {
"@type": "type.googleapis.com/google.cloud.documentai.v1.UndeployProcessorVersionMetadata",
"commonMetadata": {
"state": "SUCCEEDED",
"createTime": "2022-08-29T16:27:00.195539Z",
"updateTime": "2022-08-29T16:32:01.963962Z",
"resource": "projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION"
}
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.documentai.v1.UndeployProcessorVersionResponse"
}
}
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 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
刪除處理器版本
使用 Document AI 建立新的處理器版本後,如果不再需要該版本,可以將其刪除。
控制台
在 Google Cloud 控制台,依序前往「Document AI」專區和「Processors」(處理器) 頁面。
在處理器清單中,按一下要查看詳細資料的處理器名稱。
在處理器的「Manage Versions」(管理版本) (或「Deploy & use」(部署及使用)) 分頁中,找出要刪除的處理器版本,然後按一下旁邊的動作選單 。
按一下「刪除」,然後在對話方塊視窗中再次點選「刪除」。
REST
這個範例說明如何使用 processorVersions.delete 方法刪除處理器版本。
使用任何要求資料之前,請先修改下列項目的值:
- LOCATION:處理器的位置,例如:
us- 美國eu- 歐盟
- PROJECT_ID: Google Cloud 專案 ID。
- PROCESSOR_ID:自訂處理器的 ID。
- PROCESSOR_VERSION:處理器版本 ID。
HTTP 方法和網址:
DELETE https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION
如要傳送要求,請選擇以下其中一個選項:
curl
執行下列指令:
curl -X DELETE \
-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 DELETE `
-Headers $headers `
-Uri "https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION" | Select-Object -Expand Content
回應會是長時間執行的作業。如要輪詢長時間執行的作業,請呼叫 operations.get
回應中的 DeleteProcessorVersionMetadata 表示作業狀態。
{
"name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION",
"metadata": {
"@type": "type.googleapis.com/google.cloud.documentai.v1.DeleteProcessorVersionMetadata",
"commonMetadata": {
"state": "SUCCEEDED",
"createTime": "2022-08-29T16:27:00.195539Z",
"updateTime": "2022-08-29T16:32:01.963962Z",
"resource": "projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION"
}
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.protobuf.Empty"
}
}
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 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
匯入處理器版本
使用 Document AI 建立新處理器後,您可以從相同或不同的專案匯入處理器版本。
destination project 是匯入作業的起點,匯入完成後,處理器版本就會出現在這裡。
source project 是來源處理器版本所在的位置。
來源或目的地處理器必須符合下列匯入條件:
- 處理器類型必須相符。例如:
CUSTOM_EXTRACTION_PROCESSOR或INVOICE_PROCESSOR - 處理器結構定義不得衝突。
- 目的地處理器可以有現有的資料集和版本。
- 目的地處理器必須處於
ENABLED狀態。 - 來源處理器版本必須處於下列任一狀態:
DEPLOYEDDEPLOYINGUNDEPLOYEDUNDEPLOYING
您必須將來源專案的 Document AI 編輯者權限,授予目的地專案的 DocumentAI 核心服務代理,以免發生權限遭拒錯誤。
如果是以 Gemini 1.5 以上版本為基礎的處理器版本,例如自訂擷取器pretrained-foundation-model-v1.2-2024-05-10,您可以匯入經過微調的處理器版本。
請先完成下列步驟設定權限,再匯入處理器版本:
控制台
查詢 DocumentAI Core 服務代理,並填入目的地專案編號。DocumentAI 核心服務代理的格式類似電子郵件地址。例如:
service-123@gcp-sa-prod-dai-core.在 Google Cloud 控制台中,開啟「IAM」頁面。
選取來源專案。
按一下「授予存取權」。
gcloud
使用下列 gcloud 指令授予必要權限:
gcloud projects add-iam-policy-binding SOURCE_PROJECT \ --member=serviceAccount:service-DESTINATION_PROJECT NUMBER@gcp-sa-prod-dai-core. \ --role=roles/documentai.editor
提供以下這些值:
SOURCE_PROJECT:來源專案編號或專案 ID。DESTINATION_PROJECT NUMBER:目的地專案編號。
更新權限後,請按照下列步驟匯入處理器版本:
控制台
在 Google Cloud 控制台,依序前往「Document AI」專區和「Processors」(處理器) 頁面。
在處理器清單中,按一下要匯入處理器版本做為目的地處理器的處理器名稱。
前往「管理版本」(或「部署及使用」) 分頁,然後點選「匯入」。
在視窗中,選擇專案、處理器和處理器版本,做為來源處理器版本。
點選視窗中的「匯入」IMPORT按鈕,匯入作業就會開始。
REST
這個範例說明如何使用 processorVersions.importProcessorVersion 方法匯入處理器版本。
使用任何要求資料之前,請先修改下列項目的值:
- 目的地專案
- DESTINATION_PROJECT_ID:目的地 Google Cloud 專案 ID。
- DESTINATION_LOCATION:目的地處理器的位置。
- DESTINATION_PROCESSOR_ID:目的地處理器的 ID。
- 來源專案
- SOURCE_PROJECT_ID:來源 Google Cloud 專案 ID。
- SOURCE_LOCATION:來源處理器的位置。
- SOURCE_PROCESSOR_ID:來源處理器的 ID。
- SOURCE_PROCESSOR_VERSION:要匯入的來源處理器版本。
HTTP 方法和網址:
POST https://DESTINATION_LOCATION-documentai.googleapis.com/v1beta3/projects/DESTINATION_PROJECT_ID/locations/DESTINATION_LOCATION/processors/DESTINATION_PROCESSOR_ID/processorVersions:importProcessorVersion
JSON 要求內文:
{
"processorVersionSource": "projects/SOURCE_PROJECT_ID/locations/SOURCE_LOCATION/processors/SOURCE_PROCESSOR_ID/processorVersions/SOURCE_PROCESSOR_VERSION"
}
如要傳送要求,請選擇以下其中一個選項:
curl
將要求主體儲存在名為 request.json 的檔案中,然後執行下列指令:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://DESTINATION_LOCATION-documentai.googleapis.com/v1beta3/projects/DESTINATION_PROJECT_ID/locations/DESTINATION_LOCATION/processors/DESTINATION_PROCESSOR_ID/processorVersions:importProcessorVersion"
PowerShell
將要求主體儲存在名為 request.json 的檔案中,然後執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://DESTINATION_LOCATION-documentai.googleapis.com/v1beta3/projects/DESTINATION_PROJECT_ID/locations/DESTINATION_LOCATION/processors/DESTINATION_PROCESSOR_ID/processorVersions:importProcessorVersion" | Select-Object -Expand Content
您應該會收到如下的 JSON 回覆:
{
"name": "projects/DESTINATION_PROJECT_ID/locations/DESTINATION_LOCATION/operations/OPERATION_ID"
}
如要跨虛擬私有雲服務範圍 (VPC-SC) 匯入,請參閱「設定輸入和輸出政策」和「設定 VPC Service Controls 範圍」,然後設定下列規則。
為 ingress 提供下列值:
DESTINATION_PROJECT:目的地專案編號。SOURCE_PROJECT:來源專案編號。
- ingressFrom:
identities:
- ANY_SERVICE_ACCOUNT
sources:
- resource: DESTINATION_PROJECT
ingressTo:
operations:
- serviceName: aiplatform.googleapis.com
methodSelectors:
- method: all actions
- serviceName: documentai.googleapis.com
methodSelectors:
- method: all actions
resources:
- projects/SOURCE_PROJECT
為輸出提供下列值:
- egressTo:
operations:
- serviceName: storage.googleapis.com
methodSelectors:
- method: google.storage.objects.create
- method: google.storage.buckets.testIamPermissions
resources:
- projects/DESTINATION_PROJECT
egressFrom:
identities:
- ANY_SERVICE_ACCOUNT
使用下列值設定虛擬私有雲目的地範圍。
- egressTo:
operations:
- serviceName: aiplatform.googleapis.com
methodSelectors:
- method: all actions
- serviceName: documentai.googleapis.com
methodSelectors:
- method: all actions
- serviceName: storage.googleapis.com
methodSelectors:
- method: google.storage.buckets.testIamPermissions
- method: google.storage.objects.get
- method: google.storage.objects.create
resources:
- projects/SOURCE_PROJECT
egressFrom:
identities:
- ANY_SERVICE_ACCOUNT
sourceRestriction: DISABLED