ניהול גרסאות של מעבדי מידע

גרסאות חדשות יוצאות מסיבות שונות, למשל כדי לשפר את הדיוק, להגדיל את הזמינות ולתמוך ברכיבים חדשים של מסמכים, כמו סימני בחירה.

מכיוון ש-Document AI מבוסס על AI גנרטיבי, גרסאות עתידיות ישתמשו במודלים חדשים של AI גנרטיבי כדי שתוכלו ליהנות משיפורים של AI גנרטיבי.

אנחנו משפרים את המודלים הבסיסיים, ולכן מוציאים משימוש מודלים בסיסיים קודמים. באופן דומה, גרסאות של מעבדים מוצאות משימוש 6 חודשים אחרי שגרסאות חדשות שלהם יוצאות.

למעבד יכול להיות אחד מהגרסאות הבאות:

בדף הזה מוסבר איך מעבדים מקבלים גרסאות, ואיך אפשר לראות ולבחור גרסה מסוימת.

managing-processor-versions-1

סקירה כללית של גרסאות המעבד

יש שתי קטגוריות של גרסאות מעבד:

  • גרסאות Google הן יציבות (לתרחישי שימוש בייצור) או גרסאות מועמדות (ניסיוניות עם הפונקציונליות העדכנית ביותר).
  • גרסאות משתמש נוצרות על ידכם כדי להתאים אישית את התחזיות למסמכים שלכם, ויש להן מזהי גרסה אלפאנומריים.

גרסאות Google

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

גרסאות יציבות של Google

גרסאות יציבות הן באיכות של ייצור ומוכנות לשימוש.

  • ‫Google נותנת עדיפות ליציבות של התנהגות המעבד, אבל עדיין כוללת תיקונים קריטיים.
  • גרסאות יציבות קודמות של Google יוצאות משימוש שישה חודשים אחרי שגרסת היציבות החדשה ביותר יוצאת, כמו שמוצג באיור הבא.

managing-processor-versions-2

גרסאות מועמדות להפצה (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 לא רלוונטי

managing-processor-versions-3

מחזור החיים של גרסת מעבד

ברגע שגרסה חדשה של Google תהיה זמינה, מומלץ ליצור גרסאות חדשות של משתמשים ולהעריך אותן באמצעות גרסת הבסיס החדשה. לאחר מכן, פורסים את הגרסה החדשה ומבטלים את הפריסה (או מוחקים) של גרסאות משתמש קודמות שמבוססות על הגרסה היציבה הקודמת. גרסאות יציבות יוצאות משימוש אחרי שגרסה חדשה יוצאת. ‫Google תודיע לכם על כך לפחות שישה חודשים מראש.

מה קורה כשמוציאים משימוש גרסת בסיס?

גרסאות משתמשים שמבוססות על גרסאות בסיס קודמות מפסיקות להחזיר תחזיות כשגרסת הבסיס יוצאת משימוש.

איך נבחרות גרסאות המעבד לבקשות שלכם?

כשמתקשרים לנקודת קצה של מעבד בלי לציין את גרסת המעבד, נעשה שימוש בגרסת המעבד שמוגדרת כברירת מחדל. כשגרסת ברירת המחדל של המעבד משתנה, יכול להיות שתצטרכו לעדכן את הקוד.

נקודת קצה בשימוש חוויית צפייה
אם לא מציינים מזהה גרסה של מעבד בקשות שעובדו באמצעות גרסה חדשה של מעבד ברירת המחדל.
אם הגרסה של המעבד שמוגדרת כברירת מחדל הוצאה משימוש, ברירת המחדל תתעדכן לגרסה היציבה העדכנית ביותר של Google כשהגרסה הישנה יותר של ברירת המחדל תוצא משימוש.
אם מציינים את מזהה הגרסה של המעבד התגובה תיכשל אם תתקשרו לנקודת קצה של מעבד ותציינו מזהה גרסה שהוצא משימוש.

דוגמה להוצאה משימוש של גרסה בהתאמה אישית

לצורך המחשה, נבחן את התרחיש הבא שמתאר את רצף האירועים בהוצאה משימוש של גרסה מותאמת אישית:

  1. אתם מפתחים שמשתמשים בכלי לחילוץ מותאם אישית כדי לקבל נתונים ממסמכים. בהתחשב במורכבות ובנפח המסמכים שאתם מעבדים, אתם מבצעים כוונון עדין של מודל בסיסי כדי ליצור גרסה בשם fine-tune-A. אתם מגדירים את גרסה fine-tune-A כגרסת ברירת המחדל של המעבד ומשתמשים בה לעיבוד מסמכים. גרסת הבסיס שמפעילה את מודל fine-tune-A היא הגרסה היציבה pretrained-foundation-model-v1.0-2023-08-22 (v1.0).

  2. ‫Google פרסמה גרסה יציבה חדשה בשם pretrained-foundation-model-v1.2-2024-05-10 (v1.2) והודיעה שגרסה v1.0 היציבה תוצא משימוש ב-9 באפריל 2025.

  3. מכיוון ששמרתם את מסמכי האימון והבדיקה במערך הנתונים של המעבד, אתם יכולים לבצע התאמה עדינה של גרסה נוספת על סמך הגרסה היציבה העדכנית ביותר של 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.

כדאי לעיין במקורות המידע הבאים בנושא העברות:

בחירת גרסת מעבד

יש שלוש דרכים לציין באיזו גרסת מעבד להשתמש לעיבוד אונליין ולעיבוד ברצף (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

צפייה בגרסה הזמינה

המסוף

  1. במסוף Google Cloud , בקטע Document AI, עוברים לדף Processors.

    מעבר אל 'מעבדים'

  2. ברשימת המעבדים, לוחצים על שם המעבד שרוצים לראות את הפרטים שלו.

  3. בוחרים בכרטיסייה 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. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.

using Google.Api.Gax;
using Google.Cloud.DocumentAI.V1;
using System;

public sealed partial class GeneratedDocumentProcessorServiceClientSnippets
{
    /// <summary>Snippet for ListProcessorVersions</summary>
    /// <remarks>
    /// This snippet has been automatically generated and should be regarded as a code template only.
    /// It will require modifications to work:
    /// - It may require correct/in-range values for request initialization.
    /// - It may require specifying regional endpoints when creating the service client as shown in
    ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
    /// </remarks>
    public void ListProcessorVersionsRequestObject()
    {
        // Create client
        DocumentProcessorServiceClient documentProcessorServiceClient = DocumentProcessorServiceClient.Create();
        // Initialize request argument(s)
        ListProcessorVersionsRequest request = new ListProcessorVersionsRequest
        {
            ParentAsProcessorName = ProcessorName.FromProjectLocationProcessor("[PROJECT]", "[LOCATION]", "[PROCESSOR]"),
        };
        // Make the request
        PagedEnumerable<ListProcessorVersionsResponse, ProcessorVersion> response = documentProcessorServiceClient.ListProcessorVersions(request);

        // Iterate over all response items, lazily performing RPCs as required
        foreach (ProcessorVersion item in response)
        {
            // Do something with each item
            Console.WriteLine(item);
        }

        // Or iterate over pages (of server-defined size), performing one RPC per page
        foreach (ListProcessorVersionsResponse page in response.AsRawResponses())
        {
            // Do something with each page of items
            Console.WriteLine("A page of results:");
            foreach (ProcessorVersion item in page)
            {
                // Do something with each item
                Console.WriteLine(item);
            }
        }

        // Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
        int pageSize = 10;
        Page<ProcessorVersion> singlePage = response.ReadPage(pageSize);
        // Do something with the page of items
        Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
        foreach (ProcessorVersion item in singlePage)
        {
            // Do something with each item
            Console.WriteLine(item);
        }
        // Store the pageToken, for when the next page is required.
        string nextPageToken = singlePage.NextPageToken;
    }
}

Go

למידע נוסף, קראו את מאמרי העזרה של Document AI Go API.

כדי לבצע אימות ב-Document AI, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.


//go:build examples

package main

import (
	"context"

	documentai "cloud.google.com/go/documentai/apiv1"
	documentaipb "cloud.google.com/go/documentai/apiv1/documentaipb"
	"google.golang.org/api/iterator"
)

func main() {
	ctx := context.Background()
	// This snippet has been automatically generated and should be regarded as a code template only.
	// It will require modifications to work:
	// - It may require correct/in-range values for request initialization.
	// - It may require specifying regional endpoints when creating the service client as shown in:
	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options
	c, err := documentai.NewDocumentProcessorClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &documentaipb.ListProcessorVersionsRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/documentai/apiv1/documentaipb#ListProcessorVersionsRequest.
	}
	it := c.ListProcessorVersions(ctx, req)
	for {
		resp, err := it.Next()
		if err == iterator.Done {
			break
		}
		if err != nil {
			// TODO: Handle error.
		}
		// TODO: Use resp.
		_ = resp

		// If you need to access the underlying RPC response,
		// you can do so by casting the `Response` as below.
		// Otherwise, remove this line. Only populated after
		// first call to Next(). Not safe for concurrent access.
		_ = it.Response.(*documentaipb.ListProcessorVersionsResponse)
	}
}

Java

למידע נוסף, קראו את מאמרי העזרה של Document AI Java API.

כדי לבצע אימות ב-Document AI, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.

import com.google.cloud.documentai.v1.DocumentProcessorServiceClient;
import com.google.cloud.documentai.v1.ListProcessorVersionsRequest;
import com.google.cloud.documentai.v1.ProcessorName;
import com.google.cloud.documentai.v1.ProcessorVersion;

public class SyncListProcessorVersions {

  public static void main(String[] args) throws Exception {
    syncListProcessorVersions();
  }

  public static void syncListProcessorVersions() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (DocumentProcessorServiceClient documentProcessorServiceClient =
        DocumentProcessorServiceClient.create()) {
      ListProcessorVersionsRequest request =
          ListProcessorVersionsRequest.newBuilder()
              .setParent(ProcessorName.of("[PROJECT]", "[LOCATION]", "[PROCESSOR]").toString())
              .setPageSize(883849137)
              .setPageToken("pageToken873572522")
              .build();
      for (ProcessorVersion element :
          documentProcessorServiceClient.listProcessorVersions(request).iterateAll()) {
        // doThingsWith(element);
      }
    }
  }
}

Python

למידע נוסף, קראו את מאמרי העזרה של Document AI Python API.

כדי לבצע אימות ב-Document AI, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.


from google.api_core.client_options import ClientOptions
from google.cloud import documentai  # type: ignore

# TODO(developer): Uncomment these variables before running the sample.
# project_id = 'YOUR_PROJECT_ID'
# location = 'YOUR_PROCESSOR_LOCATION' # Format is 'us' or 'eu'
# processor_id = 'YOUR_PROCESSOR_ID' # Create processor before running sample


def list_processor_versions_sample(
    project_id: str, location: str, processor_id: str
) -> None:
    # You must set the `api_endpoint` if you use a location other than "us".
    opts = ClientOptions(api_endpoint=f"{location}-documentai.googleapis.com")

    client = documentai.DocumentProcessorServiceClient(client_options=opts)

    # The full resource name of the processor
    # e.g.: projects/project_id/locations/location/processors/processor_id
    parent = client.processor_path(project_id, location, processor_id)

    # Make ListProcessorVersions request
    processor_versions = client.list_processor_versions(parent=parent)

    # Print the processor version information
    for processor_version in processor_versions:
        processor_version_id = client.parse_processor_version_path(
            processor_version.name
        )["processor_version"]

        print(f"Processor Version: {processor_version_id}")
        print(f"Display Name: {processor_version.display_name}")
        print(f"DEPLOYED: {processor_version.state}")
        print("")

Ruby

למידע נוסף, קראו את מאמרי העזרה של Document AI Ruby API.

כדי לבצע אימות ב-Document AI, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.

require "google/cloud/document_ai/v1"

##
# Snippet for the list_processor_versions call in the DocumentProcessorService service
#
# This snippet has been automatically generated and should be regarded as a code
# template only. It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
# client as shown in https://cloud.google.com/ruby/docs/reference.
#
# This is an auto-generated example demonstrating basic usage of
# Google::Cloud::DocumentAI::V1::DocumentProcessorService::Client#list_processor_versions.
#
def list_processor_versions
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::DocumentAI::V1::DocumentProcessorService::Client.new

  # Create a request. To set request fields, pass in keyword arguments.
  request = Google::Cloud::DocumentAI::V1::ListProcessorVersionsRequest.new

  # Call the list_processor_versions method.
  result = client.list_processor_versions request

  # The returned object is of type Gapic::PagedEnumerable. You can iterate
  # over elements, and API calls will be issued to fetch pages as needed.
  result.each do |item|
    # Each element is of type ::Google::Cloud::DocumentAI::V1::ProcessorVersion.
    p item
  end
end

הצגת פרטים על גרסה

המסוף

  1. במסוף Google Cloud , בקטע Document AI, עוברים לדף Processors.

    מעבר אל 'מעבדים'

  2. ברשימת המעבדים, לוחצים על שם המעבד שרוצים לראות את הפרטים שלו.

  3. בוחרים בכרטיסייה ניהול גרסאות (או פריסה ושימוש) שבה מוצגות כל הגרסאות הזמינות של המעבד והפרטים שלהן.

REST

בדוגמה הזו מוסבר איך לקבל פרטים על גרסת מעבד עבור המעבד באמצעות השיטה processorVersions.get.

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

  • LOCATION: המיקום של המעבד, לדוגמה:
    • us – ארצות הברית
    • eu - האיחוד האירופי
  • PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  • PROCESSOR_ID: המזהה של המעבד בהתאמה אישית.
  • PROCESSOR_VERSION: מזהה גרסת המעבד. מידע נוסף זמין במאמר בנושא בחירת גרסת מעבד. לדוגמה:
    • pretrained-TYPE-vX.X-YYYY-MM-DD
    • stable
    • rc

ה-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. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.

using Google.Cloud.DocumentAI.V1;

public sealed partial class GeneratedDocumentProcessorServiceClientSnippets
{
    /// <summary>Snippet for GetProcessorVersion</summary>
    /// <remarks>
    /// This snippet has been automatically generated and should be regarded as a code template only.
    /// It will require modifications to work:
    /// - It may require correct/in-range values for request initialization.
    /// - It may require specifying regional endpoints when creating the service client as shown in
    ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
    /// </remarks>
    public void GetProcessorVersionRequestObject()
    {
        // Create client
        DocumentProcessorServiceClient documentProcessorServiceClient = DocumentProcessorServiceClient.Create();
        // Initialize request argument(s)
        GetProcessorVersionRequest request = new GetProcessorVersionRequest
        {
            ProcessorVersionName = ProcessorVersionName.FromProjectLocationProcessorProcessorVersion("[PROJECT]", "[LOCATION]", "[PROCESSOR]", "[PROCESSOR_VERSION]"),
        };
        // Make the request
        ProcessorVersion response = documentProcessorServiceClient.GetProcessorVersion(request);
    }
}

Go

למידע נוסף, קראו את מאמרי העזרה של Document AI Go API.

כדי לבצע אימות ב-Document AI, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.


//go:build examples

package main

import (
	"context"

	documentai "cloud.google.com/go/documentai/apiv1"
	documentaipb "cloud.google.com/go/documentai/apiv1/documentaipb"
)

func