סקירה כללית

מאגר הנתונים של 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 של המשתמשים לצורך גילוי תוכן.
<!--Data ingestion-->הטמעת נתונים 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), מומלץ להשתמש במצב הטמעת נתונים כדי שהחיפוש יהיה יעיל. במצב הזה, מנתח הפריסה יכול לעבד לעומק את כל תוכן המסמך ולהוסיף אותו לאינדקס.

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