הגדרת פרויקט לזיהוי תווים

זיהוי תווים אופטי (OCR) במכשיר Google Distributed Cloud (GDC)‎ עם air gap מאפשר לזהות ולחלץ טקסט מתמונות וממסמכים באפליקציות שלכם. אחרי שיוצרים פרויקט ומבקשים תפקידי פיתוח, מפעילים את OCR API במסוף GDC כדי לראות את סטטוס השירות ואת נקודת הקצה. אחרי זה אתם יכולים להתקין את ספריית הלקוח של Python, להגדיר משתני סביבה ולהשתמש ב-gdcloud CLI כדי להגדיר חשבונות שירות ולאמת בקשות. אם אתם משתמשים חדשים ב-Vertex AI, כדאי לקרוא את המאמר מידע על תכונות זיהוי תווים.

יצירת פרויקט

יצירת פרויקט לזיהוי תווים מארגנת את משאבי ה-OCR, שכוללים שותפי עריכה, ממשקי API מופעלים, פרטי כניסה לאימות ובקרת גישה.

כדי ליצור פרויקט, קראו את המאמר הגדרת פרויקט ל-Vertex AI. מזהה הפרויקט נדרש כשמבצעים קריאות ל-API.

בקשת הרשאות מפתח

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

מבקשים מהאדמין של IAM בפרויקט להקצות למשתמש או לחשבון השירות את התפקיד "מפתח AI OCR" (ai-ocr-developer) במרחב השמות של הפרויקט. למידע על התפקיד הזה, ראו הכנת הרשאות IAM.

הפעלת ה-API של OCR

צריך להפעיל את ה-API לאימון מראש של OCR בפרויקט. אם הוא מופעל, אתם יכולים לראות את סטטוס השירות ונקודת הקצה של ה-API לאימון מראש של OCR.

התקנה של ספריות לקוח

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

מתקינים את ספריית הלקוח של OCR ופועלים לפי השלבים הבאים כדי לוודא שיש לכם את הגרסה הנכונה:

  1. בודקים אם ספריית הלקוח של OCR מותקנת ומקבלים את מספר הגרסה:

    pip freeze | grep vision

    אם ספריית הלקוח כבר מותקנת, תקבלו פלט שדומה לדוגמה הבאה:

    google-cloud-vision==3.0.0

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

    https://GDC_URL/.well-known/static/client-libraries

    מחליפים את GDC_URL בכתובת ה-URL של הארגון ב-GDC.

  2. אם מספרי הגרסאות לא תואמים, מסירים את ספריית הלקוח:

    pip uninstall google-cloud-vision

  3. אם הסרתם את ספריית הלקוח של OCR, אתם צריכים להתקין אותה מחדש על ידי ציון שם הקובץ שתואם למערכת ההפעלה שלכם.

הגדרת משתני הסביבה

אחרי שמתקינים את ספריית הלקוח של OCR, אפשר להשתמש ב-API באמצעות סקריפט Python.

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

כדי להגדיר את משתני הסביבה הנדרשים בסקריפט Python:

  1. יוצרים סקריפט Python.

  2. מוסיפים את הקוד הבא לסקריפט של Python:

    import os

os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = "APPLICATION_DEFAULT_CREDENTIALS_FILENAME"

    מחליפים את APPLICATION_DEFAULT_CREDENTIALS_FILENAME בשם של קובץ ה-JSON שמכיל את המפתחות של חשבון השירות שיצרתם בפרויקט, למשל my-service-key.json.

  3. שומרים את הסקריפט של Python בשם כלשהו, למשל vision.py.

  4. מריצים את הסקריפט של Python כדי להגדיר את משתני הסביבה:

    python SCRIPT_NAME

    מחליפים את SCRIPT_NAME בשם שנתתם לסקריפט Python, למשל vision.py.

מגדירים אימות

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