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

בדף הזה מוסבר איך ליצור אפליקציית Gemini Enterprise.

חשוב: אם רוצים להשתמש במפתחות הצפנה בניהול הלקוח (CMEK) כדי להגן על נתוני האפליקציה, צריך לרשום את מפתח ה-CMEK לפני שיוצרים את האפליקציה. אפליקציות שנוצרו לפני רישום המפתח לא מוגנות. מידע נוסף מופיע במאמר בנושא מפתחות הצפנה בניהול הלקוח.

הערה: אי אפשר לקשר מאגרי נתונים של אתרים לאפליקציות של Gemini Enterprise לחיפוש פנים-ארגוני ולעזרה.

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

המסוף

1. במסוף Google Cloud , נכנסים לדף Gemini Enterprise.
2. בדף אפליקציות, לוחצים על יצירת אפליקציה.
3. בשדה App name, מזינים שם לאפליקציה.
4. כדי לעדכן את המזהה של האפליקציה שנוצר באופן אוטומטי, לוחצים על עריכה. אי אפשר לעדכן את מזהה האפליקציה אחרי שיוצרים את האפליקציה.
5. בקטע בחירת מיקום, בוחרים באפשרות Multi-region. מומלץ להשתמש באזור ברירת המחדל גלובלי (Global), אלא אם אתם צריכים להגביל את הנתונים למיקום גיאוגרפי ספציפי.

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

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

   2. אם אתם מחברים מאגר נתונים של Google Drive, אתם יכולים לאפשר לאפליקציה לחפש מסמכים מחוץ לארגון. כדי להפעיל את התכונה הזו, מסמנים את תיבת הסימון Include cross-domain documents (הכללת מסמכים בדומיינים שונים).

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

7. לוחצים על יצירה.

REST

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

כדי להשתמש בשיטה engines.create ליצירת אפליקציה משורת הפקודה, פועלים לפי השלבים הבאים:

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

   1. במסוף Google Cloud , עוברים לדף Gemini Enterprise ובתפריט הניווט לוחצים על Data Stores.

      מעבר לדף Data Stores

   2. לוחצים על השם של מאגר הנתונים.

   3. בדף Data (נתונים) של מאגר הנתונים, מאתרים את מזהה מאגר הנתונים.

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

   מונח חשוב: ב-Gemini Enterprise, המונח אפליקציה יכול לשמש לחלופין למונח מנוע בהקשר של ממשקי API. מנוע Gemini Enterprise הוא מנוע חיפוש כללי שבו השדה app_type מוגדר לערך APP_TYPE_INTRANET.

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines?engineId=APP_ID" \
   -d '{
     "displayName": "APP_DISPLAY_NAME",
     "dataStoreIds": ["DATA_STORE_ENTITY_ID_1", "DATA_STORE_ENTITY_ID_2", "DATA_STORE_ENTITY_ID_3"],
     "solutionType": "SOLUTION_TYPE_SEARCH",
     "industryVertical": "GENERIC",
     "appType": "APP_TYPE_INTRANET"
   }'
   

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

   • ‫PROJECT_ID: מזהה הפרויקט.
   • ‫APP_ID: המזהה של האפליקציה שרוצים ליצור.
   • ‫APP_DISPLAY_NAME: השם המוצג של האפליקציה שרוצים ליצור.
   • DATA_STORE_ENTITY_ID: אם מאגר הנתונים מכיל ישויות, צריך להשתמש במזהי הישויות הספציפיים. אם מאגר הנתונים לא מכיל ישויות, צריך להשתמש במזהה מאגר הנתונים.

   אפשר לכלול את ההגדרות האופציונליות הבאות במטען הייעודי (Payload) של ה-JSON:

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

     "commonConfig": {
       "companyName": "COMPANY_NAME"
     }
     

     מחליפים את COMPANY_NAME בשם החברה החיצוני, בלי סיומות כמו Inc או LLC.

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

     "includeCrossDomainDocuments": true
     

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

   דוגמה לפקודה ולתוצאה

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: my-project-123" \
   "https://discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/collections/default_collection/engines?engineId=my-app" \
   -d '{
     "displayName": "my-app",
     "dataStoreIds": ["slack_1234567890123_conversation", "slack_1234567890123_file", "slack_1234567890123_message"],
     "solutionType": "SOLUTION_TYPE_SEARCH",
     "industryVertical": "GENERIC",
     "appType": "APP_TYPE_INTRANET"
   }'
   
   {
     "name": "projects/123456/locations/global/collections/default_collection/operations/create-engine-12345678901234567890",
     "done": true,
     "response": {
       "@type": "type.googleapis.com/google.cloud.discoveryengine.v1.Engine",
       "name": "projects/123456/locations/global/collections/default_collection/engines/my-app",
       "displayName": "my-app",
       "dataStoreIds": [
         "slack_1234567890123_conversation",
         "slack_1234567890123_file",
         "slack_1234567890123_message"
       ],
       "solutionType": "SOLUTION_TYPE_SEARCH",
       "searchEngineConfig": {
         "searchTier": "SEARCH_TIER_STANDARD"
       },
       "industryVertical": "GENERIC",
       "appType": "APP_TYPE_INTRANET"
     }
   }
   

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

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

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

• כדי לראות תצוגה מקדימה של תוצאות החיפוש, עוברים אל Configurations (הגדרות) > Search UI (ממשק משתמש לחיפוש) במסוףGoogle Cloud או אל קבלת תוצאות חיפוש מ-StreamAssist.

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