שתף דרך


חומר עזר עבור Microsoft SharePoint ו- OneDrive MCP Server

חשוב

עליך להיות חלק מתוכנית התצוגה המקדימה של Frontier כדי לקבל גישה מוקדמת ל - Microsoft Agent 365. Frontier מחברת אתכם ישירות עם החידושים האחרונים של Microsoft בתחום הבינה המלאכותית. קבל תכונות פורצות דרך מעשיות, שתף את התובנות שלך עם צוותי מוצרים ועזור לעצב את עתיד הבינה המלאכותית. תצוגות מקדימות של Frontier כפופות לתנאי התצוגה המקדימה הקיימים של הסכמי הלקוחות שלך. כאשר תכונות אלה עדיין בפיתוח, הזמינות והיכולות שלהן עשויות להשתנות עם הזמן.'

מבט כולל

מזהה שרת שם תצוגה תיאור
mcp_ODSPRemoteServer Microsoft SharePoint ו- OneDrive MCP Server שרת MCP המספק כלים לעבודה עם התוכן שלך ב- SharePoint וב- OneDrive. שרת זה מתחבר לשרת ה- MCP הספציפי לדייר שלך ב- SharePoint Online. הוא מגלה והופכת לזמין באופן אוטומטי את כל הכלים התומכים שילוב קבצי OneDrive ו- SharePoint שנחשפו על-ידי נקודת הקצה של ODSP MCP.

כלים זמינים

createFolder

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

פרמטרים נדרשים:

  • folderName(string) – שם התיקיה ליצירה. אם תיקיה בשם זה כבר קיימת, השרת מוסיף סיומת מספרית לשם התיקיה החדשה, כגון NewFolder (1).
  • documentLibraryId(string) – מזהה ספריית המסמכים (הנקראת גם כונן) שבו ברצונך ליצור את התיקיה. אם ברצונך ליצור תיקיה בכונן של המשתמש או ב- OneDrive שלו, כגון "הכונן שלי" או "onedrive שלי", שלח "me"documentLibraryIdבתור .

פרמטרים אופציונליים:

  • parentFolderId(string, default = "root") – מזהה תיקיית האב שתחתיה תיווצר התיקיה החדשה. אם לא צוין, מוגדר כברירת מחדל לשורש של ספריית המסמכים.

אתר חיפוש

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

פרמטרים נדרשים:

ללא

פרמטרים אופציונליים:

  • searchQuery(string, default = null) – שאילתת חיפוש שעשויה להיות שם האתר כולו או החלקי. מתן שאילתת חיפוש עוזר לחפש אתר ביעילות, אך רק אם המשתמש מחפש אתר ספציפי. לדוגמה, אם המשתמש יבקש אתר בשם xyz, תעבור בתור xyzsearchQuery. אם המשתמש מבקש "האתרים שלי", השאר פרמטר זה ריק.

רשימת ספריות מסמכים באתר

רשימת ספריות מסמכים (המכונות גם כוננים) באתר SharePoint שצוין. אם לא תציין אתר, השרת ישתמש באתר הבסיס.

פרמטרים נדרשים:

ללא

פרמטרים אופציונליים:

  • מזהה אתר: מזהה אתר (ברירת מחדל: בסיס)

findFileOrFolder

איתור קובץ או תיקיה (הנקראים גם DriveItem) שהמשתמש יכול לגשת אליהם על-ידי העברת שאילתת חיפוש.

פרמטרים נדרשים:

  • searchQuery: שאילתת חיפוש שעשויה להיות שם הקובץ כולו או החלקי

שנה שם לקובץ או תיקיה

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

פרמטרים נדרשים:

  • documentLibraryId: מזהה ספריית מסמכים (מחרוזת)
  • fileOrFolderId: מזהה קובץ או תיקיה (מחרוזת)
  • newFileOrFolderName: שם חדש עבור הקובץ או התיקיה (מחרוזת)

מחיקת_קובץ_או_תיקיה

מחק קובץ או תיקיה מספריית המסמכים שצוינה.

פרמטרים נדרשים:

  • documentLibraryId: מזהה ספריית מסמכים (מחרוזת)
  • fileOrFolderId: מזהה קובץ או תיקיה (מחרוזת)

readSmallTextFile

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

פרמטרים נדרשים:

  • fileId(string)
  • documentLibraryId(string) – מזהה של ספריית המסמכים (נקראת גם כונן) של הקובץ שברצונך לקרוא. אם המשתמש מבקש ממך לקרוא או להוריד קובץ בכונן שלו או את Onedrive שלו לדוגמה - קרא קובץ ב"הכונן שלי", קרא קובץ ב- "onedrive שלי", עליך לשלוח את "me" כמסמךLibraryId.

moveSmallFile

העבר קובץ הממוקם בספריית המסמכים שצוינה לתיקיה אחרת. כלי זה תומך ב העברה רק עבור קבצים שגודלם פחות מ- 5 MB והעברות הנמצאות באותו אתר. לא ניתן להעביר קבצים בין כוננים באמצעות בקשה זו.

פרמטרים נדרשים:

  • documentLibraryId(string) – מזהה של ספריית המסמכים (נקראת גם כונן) של הקובץ שברצונך להעביר. אם המשתמש מבקש ממך להעביר קובץ בכונן שלו או ב- Onedrive שלו לדוגמה - העבר קובץ ב"הכונן שלי", העבר קובץ ב- "onedrive שלי", עליך לשלוח את "me" כמסמךLibraryId.
  • fileId(string) – מזהה הקובץ לתזוזה
  • newParentFolderId(string) – המזהה של תיקיית היעד להעברת הקובץ. אמור להיכלל באותה ספריית מסמכים שבה נמצא המיקום המקורי של הקובץ.

getFileOrFolderMetadata

קבל מטה-נתונים של קובץ או תיקיה מספריית המסמכים שצוינה באתר Sharepoint.

פרמטרים נדרשים:

  • FileOrFolderId(string) – מזהה של קובץ או תיקיה. הם נקראים גם DriveItems. בנוסף, המזהה שלו יכול להיתייחס לעתים ל- driveItemId.
  • documentLibraryId(string) – מזהה של ספריית המסמכים (נקראת גם ככונן) של הקובץ או התיקיה שאתה זקוק למטה-נתונים שלהם. אם המשתמש מבקש ממך לקבל קובץ או תיקיה בכונן שלו או את Onedrive שלו לדוגמה - "קבל מטה-נתונים של קובץ בכונן שלי" או "קבל מטה-נתונים של תיקיה ב- onedrive שלי", עליך לשלוח את "me" כמסמךLibraryId.

createSmallTextFile

צור או העלה קובץ טקסט הקטן מ- 5 MB לספריית מסמכים ספציפית. אם לא תציין ספריית מסמכים, נעשה שימוש ב- OneDrive של המשתמש. באפשרותך להעלות את הקובץ לתיקיה ספציפית. אם לא תציין תיקיה, הקובץ יועלה אל תיקיית הבסיס.

פרמטרים נדרשים:

  • filename (string) – שם הקובץ ליצירה
  • contentText (string) – תוכן טקסט של הקובץ ליצירה
  • documentLibraryId (string) – מזהה של ספריית המסמכים (נקראת גם כונן) עבור הקובץ. אם משתמש מבקש ממך ליצור קובץ בכונן שלו או ב- OneDrive שלו, כגון "צור קובץ בכונן שלי" או "צור קובץ ב- onedrive שלי", שלח "me" כמסמךLibraryId.

פרמטרים אופציונליים:

  • parentfolderId(string, default = "root") – מזהה תיקיה בכונן כדי להוסיף את הקובץ החדש.

getFileOrFolderMetadataByUrl

קבל מטה-נתונים עבור קובץ או תיקיה מכתובת URL לשיתוף. רק משתמשים בעלי הרשאות מפורשות לגשת לקובץ יכולים לקבל את המטה-נתונים.

פרמטרים נדרשים:

  • fileOrFolderUrl:(string) – כתובת ה- URL של הקובץ או התיקיה (המכונה גם DriveItems). כתובת ה- URL אינה מומשת כדי לשתף אותה עם המשתמש; דרושה להם כבר גישה מפורשת לקובץ.

שיתוף קובץ או תיקייה

שלח הזמנה לשיתוף כדי להעניק הרשאות בקובץ או בתיקיה בתוך ספריית מסמכים שצוינה. תמיכה בהקצאת תפקידים ובהודעות לנמענים.

פרמטרים נדרשים:

  • documentLibraryId: מזהה ספריית מסמכים (מחרוזת, נדרש)
  • fileOrFolderId: מזהה קובץ או תיקיה (מחרוזת, נדרש)
  • recipientEmails:(string[], נדרש) – כתובות דואר אלקטרוני של נמענים להזמין. נדרשת לפחות הודעת דואר אלקטרוני אחת של נמען.

פרמטרים אופציונליים:

  • roles(string[]) – תפקידים להקצאה לנמענים. ערכים מקובלים: קריאה, כתיבה (כתיבה מעניקה הן גישת קריאה והן גישת כתיבה). מצב ברירת המחדל הוא תפקיד קריאה אם לא צוין.
  • sendInvitation(bool, default = true) – מציין אם לשלוח הזמנה לשיתוף. מוגדר כברירת מחדל ל-True אם לא צוין.
  • message(string, default = "Here's the file we're collaborating on.") – הודעה מותאמת אישית שתיכלל בדואר האלקטרוני של ההזמנה. ברירות המחדל מוגדרות להודעה סטנדרטית אם לא נקבע אחרת.

קבל אתFolderChildren

ספירת 20 הקבצים והתיקיות המובילים בתוך תיקיית אב שצוינה בספריית מסמכים. אם לא תציין ספריית מסמכים, נעשה שימוש ב- OneDrive של המשתמש.

פרמטרים נדרשים:

  • documentLibraryId(string) – מזהה של ספריית המסמכים (נקראת גם כונן) עבור תיקיית האב. אם משתמש מבקש ממך לקבל קבצים בתיקיה בכונן שלו או ב- OneDrive שלו, כגון "קבל קבצים בתיקיה בכונן שלי" או "קבל קבצים בתיקיה ב- onedrive שלי", שלח "me" כמסמךLibraryId.

פרמטרים אופציונליים:

  • parentFolderId:(string, default = "root") – מזהה תיקיית האב (DriveItem) שהקבצים והתיקיות שלה מפורטים. ברירות מחדל עבור תיקיית הבסיס של ספריית המסמכים, אם לא צוין.

הד

שליחת ההודעה בחזרה ללקוח.

פרמטרים נדרשים:

  • הודעה: הודעה לשליחה חזרה

setSensitivityLabelOnFile

הגדר את תווית הרגישות של קובץ מספריית המסמכים שצוינה.

פרמטרים נדרשים:

  • documentLibraryId(string) – מזהה ספריית המסמכים, המכונה גם driveId, של ספריית המסמכים
  • fileId(string) – מזהה הקובץ, המכונה גם driveItemId, של הקובץ
  • sensitivityLabelId(string) – נדרש. מזהה של תווית הרגישות להקצאה או מחרוזת ריקה כדי להסיר את תווית הרגישות.

פרמטרים אופציונליים:

  • assignmentMethod(string, default = "privileged") - שיטת ההקצאה של התווית במסמך. ציון אם הקצאת התווית בוצעה באופן אוטומטי, רגילה או כפעולה הרשאה (מקבילה לפעולה של מנהל מערכת). ערכים אפשריים הם רגילים, עם הרשאות, אוטומטיות ו- unknownFutureValue.
  • justificationText(string, default = "Changed by MCPServer") – אופציונלי. טקסט להצדקה למטרות ביקורת, ונדרש בעת הורדה ברמה או הסרה של תווית.

getDefaultDocumentLibraryInSite (קבל את ספריית המסמכים המוגדרת כברירת מחדל באתר)

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

פרמטרים נדרשים:

ללא

פרמטרים אופציונליים:

  • מזהה אתר: מזהה אתר (ברירת מחדל: בסיס)

תכונות מרכזיות

ניהול תיקיות

  • יצירת תיקיות עם פתרון אוטומטי של התנגשויות מתן שמות
  • ספירת צאצאי תיקיות (20 המובילים)
  • העברת קבצים בין תיקיות (בתוך אותו אתר)

פעולות קובץ

  • יצירה העלאה של קבצי טקסט קטנים (< 5MB)
  • קריאה והורדה של קבצי טקסט
  • שינוי שם של קבצים ותיקיות
  • מחיקת קבצים ותיקיות
  • קבלת מטה-נתונים של קבצים ותיקיה לפי מזהה או כתובת URL

גילוי אתר וספריה

  • חיפוש אתרי SharePoint לפי שאילתת חיפוש
  • רשימת ספריות מסמכים באתר
  • קבל ספריית מסמכים המהווה ברירת מחדל

שיתוף והרשאות

  • שיתוף קבצים ותיקיות עם הקצאות תפקידים
  • שליחת הזמנות לשיתוף עם הודעות מותאמות אישית
  • בקרת גישה באמצעות הרשאות מפורשות

אבטחה ותאימות

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

Integration

  • תמיכה עבור OneDrive ו- SharePoint Online
  • חיבור שרת ספציפי לדייר
  • הפשטת DriveItem עבור קבצים ותיקיות

הערות

  1. ספריית המסמכים המהווה ברירת מחדל היא 'me' (OneDrive של המשתמש)
  2. תיקיית האב המהווה ברירת מחדל היא 'בסיס'
  3. התנגשויות שם תיקיה שנפתרו עם סיומות מספריות
  4. העברת קובץ מוגבלת לפחות מ- 5 MB ובאותו אתר
  5. כתובות URL לשיתוף דורשות הרשאות גישה מפורשות
  6. DriveItems מייצגים הן קבצים והן תיקיות
  7. מגבלת 20 המובילים על ספירת ילדים בתיקיה