הגדרת מאגר נתונים של Salesforce

בדף הזה מוסבר איך ליצור מאגר נתונים ולחבר את Salesforce ל-Gemini Enterprise. מאגר הנתונים מחפש ברשומות של Salesforce בזמן אמת ומאפשר למשתמשי הקצה לבצע בהן פעולות באמצעות שפה טבעית.

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

לפני שמגדירים את החיבור ל-Salesforce, צריך לבצע את הפעולות הבאות:

1. מקצים את התפקיד Discovery Engine Editor‏ (roles/discoveryengine.editor). התפקיד הזה נדרש כדי שהמשתמש יוכל ליצור את מאגר הנתונים. כדי להקצות את התפקיד הזה:

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

      כניסה לדף IAM

   2. מוצאים את חשבון המשתמש ולוחצים על עריכה .
   3. מקצים למשתמש את התפקיד Discovery Engine Editor. מידע נוסף זמין במאמר תפקידים והרשאות ב-IAM.

2. מבקשים מהאדמין של Salesforce להפעיל את שרת ה-MCP‏ SObject All בארגון ב-Salesforce שאליו מתחברים, ולהגדיר את שיטת האימות שבחרתם:

   • ‫OAuth 2.0 (בניהול Google) (ברירת המחדל): מתקינים בארגון את החבילה המנוהלת Gemini Enterprise - Salesforce Connector מ-Salesforce AppExchange. אתם לא צריכים מזהה לקוח או סוד לקוח.
   • ‫OAuth 2.0 (Bring Your Own App): יוצרים אפליקציית לקוח חיצונית בארגון ומקבלים את טוקן הצרכן (מזהה הלקוח) ואת סוד הצרכן (סוד הלקוח).

   עד שאפליקציית ה-OAuth תוגדר, המשתמשים לא יוכלו לאשר את המחבר. עד ששרת ה-MCP של SObject All יהיה פעיל, לא יהיו פעולות זמינות. הגדרת Salesforce

3. רושמים את כתובת ה-URL של הדומיין של הארגון, לדוגמה https://example.my.salesforce.com. מזינים את הכתובת הזו בתור Instance URI. בארגון של ארגז חול, משתמשים ב-My Domain של ארגז החול, לדוגמה https://example--sandbox.sandbox.my.salesforce.com.

איך מוצאים את כתובת ה-URL של My Domain

כדי למצוא את כתובת ה-URL של "הדומיין שלי" שצריך להזין בשדה Instance URI:

1. ב-Salesforce, עוברים אל Setup (הגדרה).
2. בתיבה Quick Find, מחפשים את My Domain ובוחרים בו.
3. בקטע Current My Domain URL, מעתיקים את כתובת ה-URL, לדוגמה https://example.my.salesforce.com.

בארגון של ארגז חול, צריך לעשות את זה בארגז החול. כתובת ה-URL של הדומיין שלי נראית כך: https://example--sandbox.sandbox.my.salesforce.com.

יצירת מאגר הנתונים של Salesforce

כדי ליצור את מאגר הנתונים של Salesforce, פועלים לפי השלבים הבאים:

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

   Gemini Enterprise

2. בוחרים פרויקט ב- Google Cloud או יוצרים פרויקט חדש.

3. בתפריט הניווט, לוחצים על מאגרי נתונים.

4. לוחצים על Create data store.

5. בקטע Source, מחפשים את Salesforce ולוחצים על Select.

6. בקטע נתונים:

   1. בקטע Authentication settings, בוחרים אחת מהאפשרויות הבאות ב-Select your authentication method:

      • OAuth 2.0 (Google Managed) (ברירת המחדל):
        1. בשדה Instance URI, מזינים את כתובת ה-URL של הדומיין שלכם באתר Salesforce, לדוגמה https://example.my.salesforce.com. בארגון של ארגז חול, מזינים את הדומיין שלי בארגז החול, לדוגמה https://example--sandbox.sandbox.my.salesforce.com.
      • ‫OAuth 2.0 (אפליקציה משלכם):
        1. בשדה Instance URI, מזינים את כתובת ה-URL של הדומיין שלכם באתר Salesforce, לדוגמה https://example.my.salesforce.com. בארגון של ארגז חול, מזינים את הדומיין שלי בארגז החול, לדוגמה https://example--sandbox.sandbox.my.salesforce.com.
        2. בשדה Client ID, מזינים את טוקן הצרכן של אפליקציית הלקוח החיצונית של Salesforce.
        3. בשדה Client Secret, מזינים את סוד הלקוח של אפליקציית הלקוח החיצונית של Salesforce.
        4. לוחצים על Verify Auth ונכנסים ל-Salesforce כדי לאמת את פרטי הכניסה ל-OAuth.

   2. בקטע Advanced options, אם אתם מחברים ארגון בארגז חול, בוחרים באפשרות Use Sandbox. לאחר מכן, Salesforce מציגה פעולות מהארגון בארגז החול.

   3. לוחצים על Continue.

   4. בקטע Entities to search, בוחרים את הישויות שרוצים ש-Gemini Enterprise יחפש בהן. ב-Salesforce, בוחרים באפשרות Salesforce MCP.

7. לוחצים על Continue.

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

9. לוחצים על Continue.

10. בקטע Configuration (הגדרה):

    1. ברשימה Multi-region, בוחרים את המיקום של מחבר הנתונים.
    2. בשדה השם של מחבר הנתונים, נותנים שם למחבר.
    3. אם בחרתם באפשרות us או eu בתור המיקום, מגדירים את הגדרות ההצפנה:
       • אופציונלי: אם לא הגדרתם מפתחות לאזור יחיד, לחצו על מעבר לדף ההגדרות כדי לעשות זאת. מידע נוסף זמין במאמר רישום מפתח לאזור יחיד למחברים של צד שלישי.
       • בוחרים באפשרות מפתח הצפנה בניהולGoogle או מפתח Cloud KMS.
       • אם בחרתם באפשרות Cloud KMS key:
         • ברשימה Key management type, בוחרים את הסוג המתאים.
         • ברשימה Cloud KMS key, בוחרים את המפתח.
       מידע נוסף זמין במאמר מפתחות הצפנה בניהול הלקוח.

11. לוחצים על Continue.

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

13. לוחצים על יצירה. ‫Gemini Enterprise יוצר את מאגר הנתונים ומציג את מאגרי הנתונים בדף Data Stores.

בדף Data Stores, לוחצים על שם מאגר הנתונים כדי לראות את הסטטוס. אחרי שהסטטוס של מאגר הנתונים משתנה מ-Creating ל-Active, מאגר הנתונים של Salesforce מוכן לשימוש.

אחרי שיוצרים את מאגר הנתונים, מחברים אותו לאפליקציה קיימת או יוצרים אפליקציה חדשה ומחברים אותו אליה, ונותנים ל-Gemini Enterprise הרשאת גישה ל-Salesforce לפני שמריצים שאילתות.

הערה: בשלב Authorize, כל משתמש מועבר לדף הכניסה של הארגון ב-Salesforce כדי להעניק לאפליקציית OAuth את היקפי ההרשאות mcp_api ו-refresh_token. השלב הזה נכשל אם החבילה המנוהלת של Gemini Enterprise (ל-OAuth 2.0 (Google Managed)) או אפליקציית OAuth בהתאמה אישית (ל-OAuth 2.0 (Bring Your Own App)) לא מוגדרת בארגון הזה, או אם לפרופיל של המשתמש אין גישה לאפליקציה. אין תמיכה בהגדרת כתובת IP סטטית לכל מאגר נתונים. מדיניות כתובת ה-IP להתחברות לאימות ולקריאות לרענון טוקנים מוגדרת באפליקציה ב-Salesforce, והקריאות לנתונים מאושרות באמצעות טוקן הגישה התקף של המשתמש. איך מגדירים את מדיניות כתובות ה-IP להתחברות לאפליקציה?

הפעלת הפעולות

כשיוצרים מאגר נתונים של Salesforce, הפעולות שלו מאוכלסות מראש במאגר הנתונים. פעולות לקריאה בלבד (Soql Query,‏ Find,‏ Get Object Schema,‏ Get Related Records,‏ List Recent Sobject Records ו-Get User Info) מופעלות כברירת מחדל ותמיד זמינות. פעולות שיוצרות, מעדכנות או מוחקות רשומות (Create Sobject Record,‏ Update Sobject Record,‏ Update Related Record,‏ Delete Sobject Record ו-Delete Related Record) מושבתות כברירת מחדל.

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

1. במסוף Google Cloud , נכנסים למאגר הנתונים של Salesforce.

2. לוחצים על הכרטיסייה פעולות.

3. בוחרים את הפעולות שרוצים להפעיל (Create Sobject Record,‏ Update Sobject Record,‏ Update Related Record,‏ Delete Sobject Record או Delete Related Record). כדי שהמחבר יישאר במצב קריאה בלבד, אל תבחרו את הפעולות האלה.

4. לוחצים על הפעלת פעולות.

רשימת הפעולות הנתמכות

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

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

הרצת שאילתות

אחרי שנותנים הרשאה ל-Salesforce ושולחים שאילתת חיפוש ל-Gemini Enterprise:

• ‫Gemini Enterprise שולח את שאילתת החיפוש ישירות לשרת ה-MCP של Salesforce.
• ‫Gemini Enterprise משלב את התוצאות עם תוצאות ממקורות נתונים מקושרים אחרים ומציג תוצאת חיפוש מקיפה.

טיפול בנתונים

כשמשתמשים בחיפוש מאוחד של צד שלישי, חלים הכללים הבאים לטיפול בנתונים:

• מחרוזת השאילתה נשלחת לקצה העורפי של החיפוש של הצד השלישי (שרת MCP של Salesforce).
• הצדדים השלישיים האלה עשויים לשייך את השאילתות לזהות שלכם.
• אם מופעלים כמה מקורות נתונים לחיפוש מאוחד, יכול להיות שהשאילתה תישלח לכולם.
• אחרי שהנתונים מגיעים למערכת של הצד השלישי, הם כפופים לתנאים ולהגבלות ולמדיניות הפרטיות של אותה מערכת.

הערה: כדי לשפר את הדיוק, יכול להיות שמודל ה-LLM ישכתב את השאילתה לפני שהיא תישלח אל Salesforce. השאילתה המשוכתבת יכולה לכלול מידע מהיסטוריית השאילתות של הסשן. כתוצאה מכך, יכול להיות שחלקים מהיסטוריית השאילתות שלכם ייכללו גם בשאילתה שתישלח לשרת ה-MCP של Salesforce.

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

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