סקירה כללית

מאגר הנתונים של Microsoft OneDrive ב-Gemini Enterprise מאפשר לכם לחפש ולבצע פעולות בקבצים ובתיקיות שלכם.

גרסאות נתמכות של Microsoft OneDrive

מאגר הנתונים של Microsoft OneDrive תומך בכל הגרסאות המתארחות של Microsoft OneDrive דרך Microsoft Graph API v1.0.

פעולות נתמכות

כשהאפשרות להשתמש במאגר הנתונים של Microsoft OneDrive מופעלת, משתמשי הקצה יכולים להשתמש בפקודות בשפה טבעית ב-Gemini Enterprise כדי לבצע את הפעולות הבאות.

פעולה תיאור
יצירת תיקייה יצירת תיקייה חדשה בנתיב שצוין ב-Microsoft OneDrive.
העתקת קובץ העתקת קובץ ממקור ליעד ב-Microsoft OneDrive.
העלאת קובץ העלאת קובץ למיקום מסוים ב-Microsoft OneDrive.
הורדת הקובץ הורדת קובץ מ-Microsoft OneDrive למיקום מסוים.
העתקת התיקייה העתקת תיקייה ממקור ליעד ב-Microsoft OneDrive.
העבר את הקובץ העברת קובץ ממקור ליעד ב-Microsoft OneDrive.
העברת התיקייה העברת תיקייה ממקור ליעד ב-Microsoft OneDrive.
שינוי שם הקובץ משנה שם של קובץ ב-Microsoft OneDrive.
שינוי השם של התיקייה משנה שם של תיקייה ב-Microsoft OneDrive.
שיתוף של קובץ או תיקייה משתפת קובץ או תיקייה עם נמענים ספציפיים או יוצרת קישור לשיתוף.
עדכון מאפייני הקובץ מעדכן מאפייני מטא-נתונים של קובץ ב-Microsoft OneDrive.

ההרשאות הנדרשות

כדי לאפשר ל-Gemini Enterprise לבצע חיפוש והטמעת נתונים באמצעות מאגר הנתונים של Microsoft OneDrive, אתם צריכים את ההרשאות הבאות:

הרשאות ל-Microsoft Graph API

בטבלה הבאה מפורטות ההרשאות שנדרשות לכל מצב חיבור.

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

מצב חיבור היקף מטרה
חיפוש מאוחד Files.Read.All (מוענקת) מאפשרת למאגר הנתונים לקרוא את כל הקבצים שהמשתמש יכול לגשת אליהם.
Sites.Read.All (מוענקת) מאפשרת למאגר הנתונים לקרוא מסמכים ופריטים ברשימה בכל אוספי האתרים שהמשתמש יכול לגשת אליהם.
User.Read.All (מוענקת) מאפשרת למאגר הנתונים לפתור את מיקומי ה-Drive של המשתמשים לצורך גילוי תוכן.
הטמעת נתונים GroupMember.Read.All (פרטי כניסה מאוחדים וטוקן רענון של OAuth 2.0) מאפשר למאגר הנתונים לקרוא חברויות ומאפיינים בסיסיים של כל הקבוצות בלי משתמש מחובר.
User.Read (פרטי כניסה מאוחדים וטוקן רענון של OAuth 2.0) מאפשר למאגר הנתונים לקרוא את הפרופיל של משתמשים מחוברים. הוא גם מאפשר למאגר הנתונים לקרוא מידע בסיסי על החברה של משתמשים שמחוברים לחשבון.
User.Read.All (רק טוקן רענון של OAuth 2.0) מאפשר למאגר הנתונים לקרוא פרופילים של משתמשים.
Sites.FullControl.All (אפשרות 1)
Sites.Selected (אפשרות 2)		 (פרטי כניסה מאוחדים וטוקן רענון של OAuth 2.0) אפשרות 1 מאפשרת למאגר הנתונים לקבל שליטה מלאה על כל אוספי האתרים. אפשרות 2 מאפשרת למאגר הנתונים לגשת לקבוצת משנה של אוספי האתרים. אפשר להגדיר ב-Microsoft OneDrive את אוספי האתרים הספציפיים ואת ההרשאות שניתנו.
User.Read.All (אפשרות 1)
User.ReadBasic.All (אפשרות 2)		 (פרטי כניסה מאוחדים בלבד) אפשרות 1 מאפשרת למאגר הנתונים לקרוא פרופילי משתמשים. אפשרות 2 מאפשרת למאגר הנתונים לקרוא קבוצה בסיסית של מאפייני פרופיל של משתמשים אחרים בארגון.
פעולות Files.ReadWrite.AppFolder (מיופה כוח) מאפשר למאגר הנתונים לקרוא, ליצור, לעדכן ולמחוק קבצים בתיקיית Microsoft OneDrive.
Files.ReadWrite מואצלת: מאגר הנתונים יכול לקרוא, להוריד, ליצור, להעלות, לעדכן ולמחוק את הקבצים שלמשתמש יש גישה אליהם.
Files.ReadWrite.All (מיופה כוח) מאפשר למאגר הנתונים לקרוא ולעדכן קבצים בכל האחסונים שלמשתמש יש גישה אליהם. נדרש לפעולות של שינוי קבצים ותיקיות (העתקה, העברה, שינוי שם, שיתוף, עדכון מאפיינים) שפועלות על קבצים שמאוחסנים בכוננים מעבר ל-Microsoft OneDrive של המשתמש.

במאמר הגדרת Microsoft OneDrive וההרשאות הנדרשות מוסבר איך להוסיף את ההרשאות ל-Microsoft OneDrive.

מגבלות

בקטע הזה מפורטות בעיות ומגבלות ידועות שעשויות להשפיע על השימוש במאגר הנתונים של Microsoft OneDrive.

  • כשיוצרים אפליקציה חדשה או מוסיפים מאגר נתונים לאפליקציה קיימת, מומלץ לשייך רק מאגר נתונים אחד לפעולות ששייכות לסוג מחבר אחד.
  • אי אפשר לאכוף את היקף ההרשאות של VPC Service Controls על מאגרי נתונים קיימים של Microsoft OneDrive. כדי לאכוף את VPC Service Controls, צריך למחוק את מאגרי הנתונים וליצור אותם מחדש. מידע נוסף על VPC Service Controls ועל השימוש בפעולות אחרי הפעלת VPC Service Controls זמין במאמר אבטחת האפליקציה באמצעות VPC Service Controls.
  • מאגר הנתונים של Microsoft OneDrive נתמך רק במיקומים global,‏ us ו-eu.

אלה המגבלות של מאגר הנתונים המאוחד של Microsoft OneDrive:

  • מגבלות החיפוש: תוצאות החיפוש עשויות להשתנות והן לא תמיד מקיפות את כל סוגי הקבצים. יכול להיות שלא תהיה גישה לתוכן בתיקיות מוצפנות או בתיקיות שהועברו לארכיון. חיפוש מאוחד לא תומך בחיפוש בקבצים מצורפים.
  • גישה שהוענקה: כדי לגשת לקבצים או לתיקיות משותפים ב-Microsoft OneDrive, יכול להיות שצריך הרשאות ספציפיות שלא נכללות בהרשאת המשתמש הרגילה.
  • מנתח פריסה במצב חיפוש מאוחד: מנתח הפריסה הוא סטנדרטי, אבל היעילות שלו בקובצי PDF מורכבים (עם טבלאות, פריסת עמודות או כאלה שדורשים OCR) מוגבלת במצב חיפוש מאוחד. יכול להיות שהקריאות ל-API בזמן אמת במצב הזה לא יספקו את הנתונים המלאים או את הזמן שנדרש לניתוח המעמיק שמנתח הפריסה מבצע במהלך הטמעת הנתונים.

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

    • פריסות טקסט עם כמה עמודות
    • נתונים בטבלאות ובתרשימים מוטמעים
    • טקסט במסמכים סרוקים שדורשים זיהוי תווים אופטי (OCR)
    • מסמכים עם סדר קריאה לא לינארי או עיצוב מורכב.

אלה המגבלות של מאגר הנתונים להטמעה מ-Microsoft OneDrive:

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

המלצה

אם הנתונים ב-Microsoft OneDrive כוללים קובצי PDF עם תכונות מורכבות (כמו טבלאות, פריסות של עמודות או תוכן שתלוי ב-OCR), מומלץ להשתמש במצב הטמעת נתונים כדי שהחיפוש יהיה יעיל. במצב הזה, מנתח הפריסה יכול לעבד לעומק את כל תוכן המסמך ולהוסיף אותו לאינדקס.

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