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

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

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

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

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

המסוף

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

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

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

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

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

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

REST

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

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

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

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

      נכנסים לדף 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.

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