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

ספריות הלקוח של Vertex AI במכשיר Google Distributed Cloud עם air gap מאפשרות לגשת באופן פרוגרמטי לממשקי ה-API של זיהוי תווים אופטי (OCR), המרת דיבור לטקסט, Vertex AI Translation ו-Vertex AI Platform משפות נתמכות, בלי לכתוב בקשות גולמיות לשרת. חילוץ והתקנה של ספריית לקוח ישירות מקובץ ה-tar שלה למערכת ההפעלה CentOS או Ubuntu.

ספריות לקוח של Vertex AI

ל-Vertex AI יש גרסאות שונות של ספריות לקוח למערכות ההפעלה CentOS ו-Ubuntu.

מוסכמות מתן השמות של ספריות הלקוח של Vertex AI בקובץ ה-tar מבוססות על מערכת ההפעלה, שם השירות והגרסה. שמות הקבצים הם בפורמט הבא:

OS-google-cloud-SERVICE-VERSION.tar.gz

מחליפים את מה שכתוב בשדות הבאים:

• ‫OS: השם של מערכת ההפעלה שבה רוצים להתקין את ספריית הלקוח. הערכים המותרים הם centos ו-ubuntu.

• ‫SERVICE: השם של שירות Vertex AI שממנו רוצים להוריד את ספריית הלקוח. אלה הערכים המותרים:

  • ‫aiplatform: ספריית הלקוח של Vertex AI Platform.
  • ‫speech: ספריית הלקוח של Speech-to-Text.
  • ‫translate: ספריית הלקוח של Vertex AI Translation.
  • ‫vision: ספריית הלקוח של ה-OCR.

• ‫VERSION: מספר הגרסה של ספריית הלקוח, למשל 3.8.0.

בטבלה הבאה מפורטות ספריות הלקוח של Vertex AI שנתמכות במכשיר GDC עם air gap:

שירות Vertex AI	מערכת הפעלה	שם קובץ
OCR	Centos	centos-google-cloud-vision-3.0.0.tar.gz
	Ubuntu	ubuntu-google-cloud-vision-3.0.0.tar.gz
המרת דיבור לטקסט (STT)	Centos	centos-google-cloud-speech-2.15.0.tar.gz
	Ubuntu	ubuntu-google-cloud-speech-2.15.0.tar.gz
Vertex AI Translation	Centos	centos-google-cloud-translate-3.8.0.tar.gz
	Ubuntu	ubuntu-google-cloud-translate-3.8.0.tar.gz
Vertex AI Platform	Centos	centos-google-cloud-aiplatform-1.34.0.tar.gz
	Ubuntu	ubuntu-google-cloud-aiplatform-1.34.0.tar.gz

לפני שמתחילים

לפני שמורידים את קובץ ה-tar ומחלצים את ספריות הלקוח, מבצעים את הפעולות הבאות:

1. הגדרת פרויקט ל-Vertex AI.

2. אימות באמצעות gdcloud CLI:

   gdcloud auth login
   

   למידע נוסף על אימות באמצעות ספק הזהויות שהגדרתם, קראו את המאמר אימות ב-gdcloud CLI.

3. מקצים את התפקיד "צפייה ב-AI ב-Cloud" (cloud-ai-viewer) לחשבון שירות. חשבון השירות צריך את התפקיד הזה כדי לגשת לשירותי Vertex AI.

4. מוודאים שמותקנת גרסה 3.7 של Python.

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

אחרי שמשלימים את הדרישות המוקדמות, פועלים לפי השלבים הבאים כדי להוריד את קובץ ה-tar ולהשתמש בו להתקנת ספריית לקוח:

1. מורידים את ספריית הלקוח שרוצים להתקין:

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

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫GDC_URL: כתובת ה-URL של הארגון ב-GDC.
   • ‫CLIENT_LIBRARY: שם הקובץ של ספריית הלקוח שרוצים להוריד.

2. מחלצים את קובץ הספרייה:

   tar -zxf CLIENT_LIBRARY
   

3. מתקינים את ספריית הלקוח במכשיר GDC עם air gap:

   pip install -r FOLDER_NAME/requirements.txt --no-index --find-links FOLDER_NAME
   

   מחליפים את FOLDER_NAME בנתיב לספרייה המקומית שבה הורדתם את קובץ הספרייה.

4. מייבאים את ספריית הלקוח באמצעות סקריפט Python. בדוגמה הבאה מוצג קטע קוד של סקריפט Python שמייבא את ספריית הלקוח של Vertex AI Translation, כדי להמחיש איך נראה ייבוא של ספריות:

   from google.cloud import translate
   translate_client = translate.Client(
    client_options={"API_ENDPOINT": "https://foo-translation.googleapis.com"})
   result
   = translate_client.translate(text, target_language="ru")
   
   [...]
   

   דוגמת הקוד הזו לא מלאה. כדי לשלוח בקשה ל-Vertex AI Translation, קראו על תכונות התרגום.

5. שומרים את הסקריפט של Python בשם כלשהו, למשל translation-service.py.

6. מריצים את הסקריפט של Python:

   python SCRIPT_NAME
   

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