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

בדף הזה נסביר על הסוגים השונים של ספריות לקוח שמכשיר Google Distributed Cloud ‏ (GDC) עם בידוד פיזי מציע לממשקי Vertex AI API, ונסביר איך להתקין אותן מקובץ ה-tar.

מכשיר GDC עם air gap מציע מגוון שירותים של Vertex AI, כולל זיהוי תווים אופטי (OCR),‏ Vertex AI Translation ו-Speech-to-Text. לכל שירות יש API משלו, שאפשר להתקין באמצעות ספריות לקוח.

ספריות לקוח מפשטות את הגישה ל-Vertex AI APIs משפות נתמכות במכשיר GDC עם air gap. אמנם אפשר להשתמש ישירות ב-Vertex AI APIs על ידי יצירת בקשות גולמיות חדשות לשרת, אבל ספריות לקוח מפשטות את התהליך ומפחיתות את כמות הקוד שצריך לכתוב.

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

ספריות לקוח של 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
   

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

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

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

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

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

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

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

   python SCRIPT_NAME
   

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