גרסאות חדשות יוצאות מסיבות שונות, למשל כדי לשפר את הדיוק, להגדיל את הזמינות ולתמוך ברכיבים חדשים של מסמכים, כמו סימני בחירה.
מכיוון ש-Document AI מבוסס על AI גנרטיבי, גרסאות עתידיות ישתמשו במודלים חדשים של AI גנרטיבי כדי שתוכלו ליהנות משיפורים של AI גנרטיבי.
אנחנו משפרים את המודלים הבסיסיים, ולכן מוציאים משימוש מודלים בסיסיים קודמים. באופן דומה, גרסאות של מעבדים מוצאות משימוש 6 חודשים אחרי שגרסאות חדשות שלהם יוצאות.
למעבד יכול להיות אחד מהגרסאות הבאות:
- גרסה יציבה
- גרסה מועמדת להפצה (RC)
- גרסה מותאמת אישית וגרסת הבסיס המשויכת לה
בדף הזה מוסבר איך מעבדים מקבלים גרסאות, ואיך אפשר לראות ולבחור גרסה מסוימת.

סקירה כללית של גרסאות המעבד
יש שתי קטגוריות של גרסאות מעבד:
- גרסאות Google הן יציבות (לתרחישי שימוש בייצור) או גרסאות מועמדות (ניסיוניות עם הפונקציונליות העדכנית ביותר).
- גרסאות משתמש נוצרות על ידכם כדי להתאים אישית את התחזיות למסמכים שלכם, ויש להן מזהי גרסה אלפאנומריים.
גרסאות Google
כל גרסה של Google מזוהה באמצעות מזהה גרסה, למשל pretrained-TYPE-vX.X-YYYY-MM-DD.
לכל גרסת מעבד ש-Google מציעה יש שם: Google Stable או Google Release Candidate (RC).
גרסאות יציבות של Google
גרסאות יציבות הן באיכות של ייצור ומוכנות לשימוש.
- Google נותנת עדיפות ליציבות של התנהגות המעבד, אבל עדיין כוללת תיקונים קריטיים.
- גרסאות יציבות קודמות של Google יוצאות משימוש שישה חודשים אחרי שגרסת היציבות החדשה ביותר יוצאת, כמו שמוצג באיור הבא.

גרסאות מועמדות להפצה (RC) של Google
גרסאות קנדידט הן ניסיוניות, והן משודרגות באופן קבוע עם התכונות העדכניות ביותר. אלה לא גרסאות באיכות של מוצר, והיציבות שלהן עשויה להשתנות.
גרסאות מותאמות אישית
גרסאות בהתאמה אישית הן גרסאות של מעבד שאפשר ליצור על סמך המסמכים שלכם כדי להתאים אישית את התחזיות.
לגרסאות מותאמות אישית יש Type, שבו מצוין סוג המודל שמשמש לחיזויים.
אם יוצרים גרסה באמצעות מודל בסיסי (על ידי יצירת גרסה או כוונון עדין), הסוג הוא AI גנרטיבי. אם יוצרים גרסת מעבד על ידי אימון של מודל קטן יותר בהתאמה אישית (מבוסס על מודל או על תבנית), הסוג הוא Custom (בהתאמה אישית). אם יוצרים גרסאות של מעבד, אתם קובעים את השם והמזהה.
גרסאות בסיס
אם יוצרים גרסת מעבד, בגרסת הבסיס מוצגת הגרסה של Google שמפעילה את גרסת המשתמש המותאמת. גרסת הבסיס קובעת את מחזור החיים של גרסת המשתמש. אתם צריכים להחליט איך לנהל את מחזור החיים של גרסת המשתמש המותאמת.
גרסאות יציבות זמינות של מעבדים
בטבלאות הבאות אפשר לראות את הגרסאות היציבות הזמינות של מעבדים מסוגים שונים.
| חילוץ מותאם אישית | תאריך השקה | תאריך הפסקת התמיכה |
|---|---|---|
pretrained-foundation-model-v1.5-2025-05-05 |
5 במאי 2025 | לא רלוונטי |
pretrained-foundation-model-v1.5-pro-2025-06-20 |
20 ביוני 2025 | לא רלוונטי |
| Form Parser | תאריך השקה | תאריך הפסקת התמיכה |
|---|---|---|
pretrained-form-parser-v1.0-2020-09-23 |
23 בספטמבר 2020 | לא רלוונטי |
pretrained-form-parser-v2.0-2022-11-10 |
10 בנובמבר 2022 | לא רלוונטי |
| Layout Parser | תאריך השקה | תאריך הפסקת התמיכה |
|---|---|---|
pretrained-layout-parser-v1.0-2024-06-03 |
3 ביוני 2024 | לא רלוונטי |
| Bank Statement Parser | תאריך השקה | תאריך הפסקת התמיכה |
|---|---|---|
pretrained-bankstatement-v1.0-2021-08-08 |
8 באוגוסט 2021 | לא רלוונטי |
pretrained-bankstatement-v1.1-2021-08-13 |
13 באוגוסט 2021 | לא רלוונטי |
pretrained-bankstatement-v2.0-2021-12-10 |
10 בדצמבר 2021 | לא רלוונטי |
pretrained-bankstatement-v3.0-2022-05-16 |
16 במאי 2022 | לא רלוונטי |
pretrained-bankstatement-v5.0-2023-12-06 |
6 בדצמבר 2023 | לא רלוונטי |
| W2 Parser | תאריך השקה | תאריך הפסקת התמיכה |
|---|---|---|
pretrained-w2-v1.0-2020-10-01 |
1 באוקטובר 2020 | 31 במרץ 2024 |
pretrained-w2-v1.1-2022-01-27 |
27 בינואר 2022 | 31 במרץ 2024 |
pretrained-w2-v1.2-2022-01-28 |
28 בינואר 2022 | לא רלוונטי |
pretrained-w2-v2.1-2022-06-08 |
8 ביוני 2022 | לא רלוונטי |
| כלי לניתוח הוכחות של תעודות מזהות | תאריך השקה | תאריך הפסקת התמיכה |
|---|---|---|
pretrained-id-proofing-v1.0-2022-10-03 |
3 באוקטובר 2022 | לא רלוונטי |
| Pay Slip Parser | תאריך השקה | תאריך הפסקת התמיכה |
|---|---|---|
pretrained-paystub-v1.0-2021-03-19 |
19 במרץ 2021 | לא רלוונטי |
pretrained-paystub-v1.1-2021-08-13 |
13 באוגוסט 2021 | לא רלוונטי |
pretrained-paystub-v1.2-2021-12-10 |
10 בדצמבר 2021 | לא רלוונטי |
pretrained-paystub-v2.0-2022-07-22 |
22 ביולי 2022 | לא רלוונטי |
pretrained-paystub-v3.0-2023-12-06 |
6 בדצמבר 2023 | לא רלוונטי |
| US Driver License Parser | תאריך השקה | תאריך הפסקת התמיכה |
|---|---|---|
pretrained-us-driver-license-v1.0-2021-06-14 |
14 ביוני 2021 | לא רלוונטי |
| Expense Parser | תאריך השקה | תאריך הפסקת התמיכה |
|---|---|---|
pretrained-expense-v1.1-2021-04-09 |
9 באפריל 2024 | לא רלוונטי |
pretrained-expense-v1.4-2022-11-18 |
18 בנובמבר 2022 | לא רלוונטי |
pretrained-expense-v1.4.2-2024-09-12 |
12 בספטמבר 2024 | לא רלוונטי |
| כלי לניתוח חשבוניות | תאריך השקה | תאריך הפסקת התמיכה |
|---|---|---|
pretrained-invoice-v1.1-2021-04-09 |
9 באפריל 2024 | לא רלוונטי |
pretrained-invoice-v1.2-2022-02-18 |
18 בפברואר 2022 | לא רלוונטי |
pretrained-invoice-v1.3-2022-07-15 |
15 ביולי 2022 | לא רלוונטי |
pretrained-invoice-v2.0-2023-12-06 |
6 בדצמבר 2023 | לא רלוונטי |
| Enterprise Document OCR (זיהוי תווים אופטי) | תאריך השקה | תאריך הפסקת התמיכה |
|---|---|---|
pretrained-ocr-v1.2-2022-11-10 |
10 בנובמבר 2022 | לא רלוונטי |
pretrained-ocr-v2.0-2023-06-02 |
2 ביוני 2023 | לא רלוונטי |
pretrained-ocr-v2.1-2024-08-07 |
7 באוגוסט 2024 | לא רלוונטי |

מחזור החיים של גרסת מעבד
ברגע שגרסה חדשה של Google תהיה זמינה, מומלץ ליצור גרסאות חדשות של משתמשים ולהעריך אותן באמצעות גרסת הבסיס החדשה. לאחר מכן, פורסים את הגרסה החדשה ומבטלים את הפריסה (או מוחקים) של גרסאות משתמש קודמות שמבוססות על הגרסה היציבה הקודמת. גרסאות יציבות יוצאות משימוש אחרי שגרסה חדשה יוצאת. Google תודיע לכם על כך לפחות שישה חודשים מראש.
מה קורה כשמוציאים משימוש גרסת בסיס?
גרסאות משתמשים שמבוססות על גרסאות בסיס קודמות מפסיקות להחזיר תחזיות כשגרסת הבסיס יוצאת משימוש.
איך נבחרות גרסאות המעבד לבקשות שלכם?
כשמתקשרים לנקודת קצה של מעבד בלי לציין את גרסת המעבד, נעשה שימוש בגרסת המעבד שמוגדרת כברירת מחדל. כשגרסת ברירת המחדל של המעבד משתנה, יכול להיות שתצטרכו לעדכן את הקוד.
| נקודת קצה בשימוש | חוויית צפייה |
|---|---|
| אם לא מציינים מזהה גרסה של מעבד | בקשות שעובדו באמצעות גרסה חדשה של מעבד ברירת המחדל. אם הגרסה של המעבד שמוגדרת כברירת מחדל הוצאה משימוש, ברירת המחדל תתעדכן לגרסה היציבה העדכנית ביותר של Google כשהגרסה הישנה יותר של ברירת המחדל תוצא משימוש. |
| אם מציינים את מזהה הגרסה של המעבד | התגובה תיכשל אם תתקשרו לנקודת קצה של מעבד ותציינו מזהה גרסה שהוצא משימוש. |
דוגמה להוצאה משימוש של גרסה בהתאמה אישית
לצורך המחשה, נבחן את התרחיש הבא שמתאר את רצף האירועים בהוצאה משימוש של גרסה מותאמת אישית:
אתם מפתחים שמשתמשים בכלי לחילוץ מותאם אישית כדי לקבל נתונים ממסמכים. בהתחשב במורכבות ובנפח המסמכים שאתם מעבדים, אתם מבצעים כוונון עדין של מודל בסיסי כדי ליצור גרסה בשם
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היציבה תוצא משימוש ב-9 באפריל 2025.מכיוון ששמרתם את מסמכי האימון והבדיקה במערך הנתונים של המעבד, אתם יכולים לבצע התאמה עדינה של גרסה נוספת על סמך הגרסה היציבה העדכנית ביותר של Google,
v1.2, ולתת לה את השםfine-tune-B. אחרי שמעריכים את הביצועים שלה, מגדירים את גרסהfine-tune-Bכגרסת ברירת המחדל החדשה של המעבד ומוציאים משימוש את גרסהfine-tune-A. הגרסה החדשה שלכם משתמשת עכשיו בגרסה היציבה העדכנית ביותר של Google שנתמכת.
לעומת זאת, אם לא הייתם יוצרים ומעריכים את הגרסה המותאמת אישית fine-tune-B
של המעבד, Google הייתה מעדכנת את גרסת ברירת המחדל של המעבד ל-v1.2 ב-9 באפריל 2025. מכיוון שאתם קוראים לנקודת הקצה של המעבד ולא מציינים גרסת מעבד, גרסה v1.2 החדשה משמשת כברירת המחדל החדשה לעיבוד הבקשות שלכם.
משאבים בנושא הוצאה משימוש והעברה
לגבי מנתחים ומעבדים שהוצאו משימוש, אפשר לעיין במאמר בנושא הוצאה משימוש של Document AI.
כדאי לעיין במקורות המידע הבאים בנושא העברות:
כדי ליצור ולאמן מנתח הוצאות חדש, אפשר לעיין במאמר בנושא המשך אימון של מעבד שאומן מראש.
הוראות ליצירה ולהתאמה של מעבד חדש מסוג 'חילוץ מותאם אישית' זמינות במאמר בנושא חילוץ מותאם אישית באמצעות AI גנרטיבי.
בחירת גרסת מעבד
יש שלוש דרכים לציין באיזו גרסת מעבד להשתמש לעיבוד אונליין ולעיבוד ברצף (batch processing):
אם לא מציינים גרסה, המערכת משתמשת בברירת המחדל של המעבד.
- לדוגמה:
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.
ברשימת המעבדים, לוחצים על שם המעבד שרוצים לראות את הפרטים שלו.
בוחרים בכרטיסייה Manage Versions (ניהול גרסאות) או Deploy & use (פריסה ושימוש), שבה מוצגות כל הגרסאות הזמינות של המעבד.
REST
בדוגמה הזו אפשר לראות איך מציגים את הגרסאות הזמינות של המעבד באמצעות השיטה processorVersions.list.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- LOCATION: המיקום של המעבד, לדוגמה:
us– ארצות הבריתeu- האיחוד האירופי
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
- PROCESSOR_ID: המזהה של המעבד בהתאמה אישית.
ה-method של ה-HTTP וכתובת ה-URL:
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, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Go
למידע נוסף, קראו את מאמרי העזרה של Document AI Go API.
כדי לבצע אימות ב-Document AI, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Java
למידע נוסף, קראו את מאמרי העזרה של Document AI Java API.
כדי לבצע אימות ב-Document AI, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Python
למידע נוסף, קראו את מאמרי העזרה של Document AI Python API.
כדי לבצע אימות ב-Document AI, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Ruby
למידע נוסף, קראו את מאמרי העזרה של Document AI Ruby API.
כדי לבצע אימות ב-Document AI, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
הצגת פרטים על גרסה
המסוף
במסוף Google Cloud , בקטע Document AI, עוברים לדף Processors.
ברשימת המעבדים, לוחצים על שם המעבד שרוצים לראות את הפרטים שלו.
בוחרים בכרטיסייה ניהול גרסאות (או פריסה ושימוש) שבה מוצגות כל הגרסאות הזמינות של המעבד והפרטים שלהן.
REST
בדוגמה הזו מוסבר איך לקבל פרטים על גרסת מעבד עבור המעבד באמצעות השיטה processorVersions.get.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- LOCATION: המיקום של המעבד, לדוגמה:
us– ארצות הבריתeu- האיחוד האירופי
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
- PROCESSOR_ID: המזהה של המעבד בהתאמה אישית.
- PROCESSOR_VERSION: מזהה גרסת המעבד. מידע נוסף זמין במאמר בנושא בחירת גרסת מעבד. לדוגמה:
pretrained-TYPE-vX.X-YYYY-MM-DDstablerc
ה-method של ה-HTTP וכתובת ה-URL:
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, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Go
למידע נוסף, קראו את מאמרי העזרה של Document AI Go API.
כדי לבצע אימות ב-Document AI, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.