התאמה אישית של תבנית של Google ופריסה שלה

התאמה אישית של תבנית של Google ופריסה שלה

מדריך ההתחלה המהירה הזה עוזר לכם להעתיק תבנית ש-Google מספקת, להתאים אישית את הרכיבים שלה ולפרוס אפליקציית בדיקה. במדריך למתחילים הזה נשתמש בתבנית Generative AI RAG with Cloud SQL, אבל אפשר להשתמש בהליכים שמתוארים במאמר הזה בכל תבנית.

בתמונה הבאה מוצגים הרכיבים והחיבורים של תבנית ה-RAG של AI גנרטיבי עם Cloud SQL באזור העיצוב:

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

נכנסים לחשבון Google Cloud . אם אתם משתמשים חדשים ב- Google Cloud, צרו חשבון כדי שתוכלו להעריך את הביצועים של המוצרים שלנו בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300$ להרצה, לבדיקה ולפריסה של עומסי העבודה.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

1. מגדירים את App Design Center בפרויקט.

התפקידים הנדרשים

צריך לבקש מהאדמין להקצות לכם את התפקידים שמפורטים בטבלה הבאה:

משימה	התפקידים הנדרשים
העתקה, עיצוב ועריכה של תבניות	אדמין של Application Design Center (roles/designcenter.admin) או משתמש של Application Design Center (roles/designcenter.user)
פריסת אפליקציות והגדרות	אדמין באפליקציה (roles/designcenter.applicationAdmin), או עריכת אפליקציות (roles/designcenter.applicationEditor)
יצירת חשבונות שירות במהלך הפריסה	יצירת חשבונות שירות (roles/iam.serviceAccountCreator) בפרויקט
הענקת גישה לחשבון השירות לפרויקט	אדמין IAM בפרויקט (roles/resourcemanager.projectIamAdmin) בפרויקט

מידע נוסף על תפקידים זמין במאמר בקרת גישה באמצעות IAM.

הכנת הסביבה

כדי להשלים את המדריך למתחילים הזה, אפשר להשתמש באחת מהאפשרויות הבאות.

• משתמשים באזור העיצוב במסוף Google Cloud .

נכנסים לחשבון Google Cloud . אם אתם משתמשים חדשים ב- Google Cloud, צרו חשבון כדי שתוכלו להעריך את הביצועים של המוצרים שלנו בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300$ להרצה, לבדיקה ולפריסה של עומסי העבודה.

התקינו את ה-CLI של Google Cloud.

הערה: אם התקנתם את ה-CLI של gcloud, השתמשו בפקודה gcloud components update כדי לבדוק אם הגרסה העדכנית מותקנת.

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

כדי לאתחל את ה-CLI של gcloud, הריצו את הפקודה הבאה:

gcloud init

התקינו את ה-CLI של Google Cloud.

הערה: אם התקנתם את ה-CLI של gcloud, השתמשו בפקודה gcloud components update כדי לבדוק אם הגרסה העדכנית מותקנת.

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

כדי לאתחל את ה-CLI של gcloud, הריצו את הפקודה הבאה:

gcloud init

העתקת התבנית ויצירת טיוטה של אפליקציה

מעתיקים את התבנית של Google ומגדירים טיוטה של בקשה.

קנבס העיצוב

1. נכנסים לדף Google templates במסוף Google Cloud .

   מעבר לתבניות של Google

2. בכרטיס התבנית Generative AI RAG with Cloud SQL, לוחצים על Preview and customize (תצוגה מקדימה והתאמה אישית).

   התבנית תיפתח באזור העיצוב.

3. לוחצים על שכפול והתאמה אישית.

4. בתיבת הדו-שיח יצירת תבנית חדשה, מזינים את הפרטים הבאים:

   1. בשדה Template ID (מזהה התבנית), מזינים quickstart-custom-gen-ai-rag.

   2. בשדה Template Name (שם התבנית), מזינים Quickstart custom Generative AI RAG.

   3. בשדה Description (תיאור), מזינים A custom template copied from the Generative AI RAG with Cloud SQL template..

   4. לוחצים על יצירת תבנית.

   התבנית מועתקת למרחב ומוצגת באזור העיצוב.

5. באזור העיצוב, לוחצים על Configure an app (הגדרת אפליקציה).

6. לוחצים על יצירת אפליקציה חדשה ומזינים את הפרטים הבאים:

   1. בשדה שם מזינים quickstart-custom-gen-ai-rag-test.

   2. בשדה שם מוצג, מזינים Quickstart custom Generative AI RAG test.

   3. ברשימה אזור, בוחרים באפשרות us-central1 (Iowa).

   4. ברשימה סביבה, בוחרים באפשרות Test.

   5. ברשימה Criticality, בוחרים באפשרות Low.

7. לוחצים על יצירת אפליקציה.

   המערכת יוצרת טיוטה של האפליקציה.

‫CLI של gcloud

1. מסננים את התבניות המשותפות בקטלוג של Google כדי למצוא את ה-URI של הגרסה של תבנית gen-ai-rag-with-sql.

   gcloud design-center spaces shared-templates list \
     --google-catalog \
     --location=LOCATION \
     --filter="displayName:gen-ai-rag-cloud-sql"
   

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

   • ‫LOCATION: המיקום של המרחב. לדוגמה, us-central1.

   מזהים את ה-URI של הגרסה בפלט.

2. יוצרים טיוטה של אפליקציה מהגרסה הזו של התבנית.

   gcloud design-center spaces applications create quickstart-custom-gen-ai-rag-test \
     --space=SPACE \
     --location=LOCATION \
     --project=PROJECT \
     --source-shared-template-revision-uri=SHARED_TEMPLATE_REVISION_URI \
     --display-name="Quickstart custom Generative AI RAG test" \
     --environment-type=test \
     --criticality-type=low \
     --scope-type=regional \
     --deployment-region=LOCATION
   

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

   • ‫SPACE: מזהה המרחב. לדוגמה, default-space.
   • ‫PROJECT: מזהה הפרויקט.
   • ‫SHARED_TEMPLATE_REVISION_URI: ה-URI של הגרסה של התבנית. לדוגמה, projects/gcpdesigncenter/locations/us-central1/spaces/googlespace/sharedTemplates/f8ddfbd3-6393-4a1e-942c-aaa7292fa30c/revisions/r-28.

הגדרת רכיבים

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

קנבס העיצוב

1. באזור העיצוב, לוחצים על frontend-service ומבצעים את הפעולות הבאות באזור Configuration:

   1. בשדה שם השירות מזינים custom-rag-frontend.

   2. לוחצים על Save.

2. באזור העיצוב, לוחצים על retrieval-service ומבצעים את הפעולות הבאות באזור Configuration:

   1. בשדה שם השירות מזינים custom-retrieval-service.

   2. לוחצים על Save.

3. באזור העיצוב, לוחצים על database-postgresql ומבצעים את הפעולות הבאות באזור Configuration:

   1. בשדה שם מזינים custom-rag-database.

   2. לוחצים על Save.

4. באזור העיצוב, לוחצים על vertex-ai ומבצעים את הפעולות הבאות באזור Configuration:

   1. מוודאים שהפרויקט שלכם מסומן ברשימה Project ID.

   2. לוחצים על Save.

5. באזור העיצוב, לוחצים על secret-manager ומבצעים את הפעולות הבאות באזור Configuration:

   1. בשדה שם מזינים db-ai-secret.

   2. לוחצים על Save.

בכל רכיב בבד הציור מוצג סימן וי ירוק כדי לציין שכל הפרמטרים הנדרשים הוגדרו.

‫CLI של gcloud

1. תארו את האפליקציה כדי לזהות פרמטרים של רכיבים.

   gcloud design-center spaces applications describe quickstart-custom-gen-ai-rag-test \
     --space=SPACE \
     --location=LOCATION \
     --project=PROJECT \
     --format='yaml(name,componentParameters)'
   

   הפלט מציג פרמטרים לכל רכיב.

2. קבלת רשימה של מזהי URI של רכיבים.

   gcloud design-center spaces applications describe quickstart-custom-gen-ai-rag-test \
     --space=SPACE \
     --location=LOCATION \
     --project=PROJECT \
     --format='value(serializedApplicationTemplate.components.uri)'
   

3. יוצרים קובצי JSON של הגדרות בספריית העבודה.

   1. יצירת custom-frontend.json.

      {
         "component": "FRONTEND_COMPONENT_URI",
         "parameters": [
            {
               "key": "service_name",
               "value": "custom-rag-frontend"
            },
            {
               "key": "PROJECT",
               "value": "PROJECT"
            },
            {
               "key": "location",
               "value": "LOCATION"
            }
         ]
      }
      

   2. יצירת custom-retrieval.json.

      {
         "component": "RETRIEVAL_COMPONENT_URI",
         "parameters": [
            {
               "key": "service_name",
               "value": "custom-retrieval-service"
            },
            {
               "key": "project_id",
               "value": "PROJECT"
            },
            {
               "key": "location",
               "value": "LOCATION"
            }
         ]
      }
      

   3. יצירת custom-database.json.

      {
         "component": "DATABASE_COMPONENT_URI",
         "parameters": [
            {
               "key": "name",
               "value": "custom-rag-database"
            },
            {
               "key": "project_id",
               "value": "PROJECT"
            },
            {
               "key": "database_version",
               "value": "POSTGRES_15"
            },
            {
               "key": "region",
               "value": "us-central1"
            },
            {
               "key": "zone",
               "value": "us-central1-a"
            }
         ]
      }
      

   4. יצירת custom-secmanager.json.

      {
      "component": "SECRET_MANAGER_COMPONENT_URI",
      "parameters": [
         {
            "key": "name",
            "value": "db-ai-secret"
         },
         {
            "key": "project_id",
            "value": "PROJECT"
         }
      ]
      }
      

   5. יצירת custom-vertex.json.

      {
      "component": "VERTEX_AI_COMPONENT_URI",
      "parameters": [
         {
            "key": "project_id",
            "value": "PROJECT"
         }
      ]
      }
      

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

   • ‫FRONTEND_COMPONENT_URI: ה-URI של רכיב ה-Frontend. לדוגמה, projects/gcpdesigncenter/locations/us-central1/spaces/googlespace/applicationTemplates/gen-ai-rag-cloud-sql/components/frontend-service.
   • ‫RETRIEVAL_COMPONENT_URI: ה-URI של רכיב האחזור. לדוגמה, projects/gcpdesigncenter/locations/us-central1/spaces/googlespace/applicationTemplates/gen-ai-rag-cloud-sql/components/retrieval-service.
   • ‫DATABASE_COMPONENT_URI: ה-URI של רכיב מסד הנתונים. לדוגמה, projects/gcpdesigncenter/locations/us-central1/spaces/googlespace/applicationTemplates/gen-ai-rag-cloud-sql/components/database-postgresql.
   • ‫SECRET_MANAGER_COMPONENT_URI: ה-URI של רכיב Secret Manager. לדוגמה, projects/gcpdesigncenter/locations/us-central1/spaces/googlespace/applicationTemplates/gen-ai-rag-cloud-sql/components/secret-manager.
   • ‫VERTEX_AI_COMPONENT_URI: ה-URI של רכיב Vertex AI. לדוגמה, projects/gcpdesigncenter/locations/us-central1/spaces/googlespace/applicationTemplates/gen-ai-rag-cloud-sql/components/vertex-ai.
   • ‫PROJECT: מזהה הפרויקט.

4. מעדכנים את הגדרות האפליקציה באמצעות קובצי הפרמטרים בפורמט JSON.

   gcloud design-center spaces applications update quickstart-custom-gen-ai-rag-test \
     --space=SPACE \
     --location=LOCATION \
     --project=PROJECT \
     --component-parameters=./custom-frontend.json \
     --component-parameters=./custom-retrieval.json \
     --component-parameters=./custom-database.json \
     --component-parameters=./custom-secmanager.json \
     --component-parameters=./custom-vertex.json
   

פריסת האפליקציה

פורסים את האפליקציה שהוגדרה.

קנבס העיצוב

1. לוחצים על פריסה.

2. באזור Select service account, מבצעים את הפעולות הבאות:

   1. בוחרים באפשרות יצירת חשבון שירות חדש.

   2. לוחצים על המשך.

3. לוחצים על פריסה.

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

‫CLI של gcloud

1. הצגת הפריסה בתצוגה מקדימה ויצירה אוטומטית של חשבון שירות לתצוגה מקדימה.

   gcloud design-center spaces applications preview quickstart-custom-gen-ai-rag-test \
     --space=SPACE \
     --location=LOCATION \
     --project=PROJECT \
     --create-sa
   

2. פורסים את האפליקציה ויוצרים באופן אוטומטי חשבון שירות לפריסה.

   gcloud design-center spaces applications deploy quickstart-custom-gen-ai-rag-test \
     --space=SPACE \
     --location=LOCATION \
     --project=PROJECT \
     --create-sa \
     --async
   

   מעתיקים את מזהה הפעולה.

3. עוקבים אחרי סטטוס הפריסה.

   gcloud design-center operations describe operation-OPERATION_ID \
     --space=SPACE \
     --location=LOCATION \
     --project=PROJECT
   

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

   • ‫OPERATION_ID: מזהה הפעולה.

אופציונלי: מעקב אחרי הפריסה

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

1. נכנסים לדף Application monitoring במסוף Google Cloud :

   עוברים אל מעקב אחר אפליקציות

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

2. בעמודה Name (שם), לוחצים על האפליקציה שפרסתם.

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

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

הסרת המשאבים

כדי לא לצבור חיובים בחשבון על המשאבים שבהם השתמשתם בדף הזה, אתם צריכים למחוק את הפרויקט יחד עם המשאבים. Google Cloud Google Cloud

מחיקת האפליקציה שנפרסה

קנבס העיצוב

1. בתפריט הניווט, לוחצים על אפליקציות.

   מעבר אל Applications

2. לוחצים על Quickstart custom Generative AI RAG test (מדריך למתחילים לבדיקת RAG מותאמת אישית של AI גנרטיבי).

3. לוחצים על פעולות ובוחרים באפשרות מחיקת האפליקציה.

4. בשדה מחיקה, מזינים quickstart-custom-gen-ai-rag-test.

5. לוחצים על Delete.

‫CLI של gcloud

1. מוחקים את האפליקציה באמצעות ה-CLI.

   gcloud design-center spaces applications delete quickstart-custom-gen-ai-rag-test \
     --space=SPACE \
     --location=LOCATION \
     --project=PROJECT
   

אופציונלי: מחיקת הפרויקט

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

1. במסוף Google Cloud , נכנסים לדף Manage resources.

   כניסה לדף Manage resources

2. ברשימת הפרויקטים, בוחרים את הפרויקט שרוצים למחוק ולוחצים על Delete.
3. בתיבת ההנחיה, מקלידים את מזהה הפרויקט ולוחצים על Shut down.

המאמרים הבאים

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