הפניה ל-SharePoint (תצוגה מקדימה)

הערה

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

חשוב

‏‫‏‫זוהי תכונת Preview.‬‬

  • Microsoft תצוגה מקדימה לפני מהדורה רשמית כדי שלקוחות יוכלו לקבל גישה מוקדמת ולספק משוב.
  • לתכונות תצוגה מקדימה יש פונקציונליות מוגבלת והן אינן מיועדות לשימוש ייצור.
  • Microsoft עשויה לשנות את השמות והפרמטרים של כלי MCP בגרסת תצוגה מקדימה. הימנע מיתלות עם קוד קשיח. Microsoft שומרת על תמיכת תרחישים.
  • תכונות התצוגה המקדימה כפופות Microsoft תנאי שימוש נוספים.

הערה

כלי MCP של Microsoft 365 ייעודיים ליישום (Copilot, Calendar, Mail, SharePoint, OneDrive, Teams, User ו-Word) מיועדים רק לצורכי תאימות לאחור ואינם אמורים לשמש בסביבות ייצור או פרויקטים חדשים. לפרויקטים חדשים שדורשים גישה למשאבי Microsoft 365, השתמשו ב-Work IQ MCP עם רתמת Microsoft Copilot. למידע נוסף, ראו Work IQ MCP ב-Copilot Studio.

סקירה כללית

מזהה שרת כתובת URL ברמת הדייר שם התצוגה תיאור
mcp_SharePointRemoteServer https://agent365.svc.cloud.microsoft/
agents/tenants/{tenantId}/servers/
mcp_SharePointRemoteServer
SharePoint כלים לתפעול SharePoint. השתמש בשרת זה לניהול אתרים, רשימות, פריטי רשימה, עמודות, ספריות מסמכים, קבצים, תיקיות ושיתוף קבצים. פעולות קבצים מוגבלות לקבצים בנפח של 5 MB או פחות.

כלים זמינים

אתר חיפוש

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

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

  • searchQuery: שאילתת חיפוש (שם אתר מלא או חלקי). השאר ריק כדי להחזיר את 20 האתרים המובילים שניתן לגשת אליהם.

getSiteByPath

פותר אתר SharePoint באמצעות שם המחשב המארח המדויק שלו והנתיב היחסי לשרת. השתמש בשיטה זו רק כאשר ברשותך מבנה כתובת ה- URL המלא של האתר. השתמש findSite כאשר אתה יודע רק שם אתר.

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

  • שם מארח: שם מארח מדויק (לדוגמה, 'contoso.sharepoint.com')
  • serverRelativePath: נתיב יחסי לשרת (למשל, 'sites/Marketing'). קו נטוי מוביל הוא אופציונלי.

רשימהאתרי משנה

פירוט כל אתרי המשנה (אתרי צאצא) של אתר SharePoint זה.

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

  • siteId: מזהה אתר האב SharePoint (פורמט: 'hostname,siteCollectionId,webId')

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

פירוט ספריות מסמכים (כוננים) באתר SharePoint שצוין.

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

  • siteId: מזהה של אתר SharePoint (ברירת מחדל: 'root')

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

מחזיר את ספריית המסמכים (כונן) המוגדרת כברירת המחדל באתר SharePoint.

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

  • siteId: מזהה של אתר SharePoint (ברירת מחדל: 'root')

קבל אתFolderChildren

ספירת 20 הקבצים והתיקיות המובילים (DriveItems) הכלולים בתוך תיקיית אב שצוינה בספריית מסמכים (כונן).

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

  • documentLibraryId: מזהה ספריית המסמכים (כונן)

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

  • parentFolderId: מזהה של תיקיית האב (ברירת מחדל: 'root').

findFileOrFolder

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

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

  • שאילתת חיפוש: שאילתת חיפוש (שם קובץ שלם או חלקי)

getFileOrFolderMetadata

אחזור מטא-נתונים של קובץ או תיקיה (DriveItem) מספריית מסמכים (drive) שצוינה ב-SharePoint.

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

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

getFileOrFolderMetadataByUrl

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

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

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

readSmallTextFile

קורא (מוריד) קובץ טקסט קטן מ-5MB מספריית מסמכים מסוימת (כונן).

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

  • fileId: מזהה הקובץ (DriveItem) לקריאה או הורדה
  • documentLibraryId: מזהה ספריית המסמכים (כונן)

readSmallBinaryFile

קורא את הקובץ הבינארי שגודלו קטן מ-5 MB מספריית מסמכים מסוימת (כונן). תוכן הקובץ מוחזר כמחרוזת בקידוד base64.

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

  • fileId: מזהה הקובץ (DriveItem) לקריאה או הורדה
  • documentLibraryId: מזהה ספריית המסמכים (כונן)

createSmallTextFile

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

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

  • filename: שם הקובץ כולל הסיומת.
  • contentText: תוכן הטקסט של הקובץ.
  • documentLibraryId: מזהה ספריית המסמכים (כונן)

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

  • parentFolderId: מזהה של תיקיית האב (ברירת מחדל: 'root').

createSmallBinaryFile

יצירת קובץ בינארי הקטן מ- 5 MB על-ידי קידוד base64 של התוכן שלו לספריית מסמכים ספציפית (כונן).

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

  • filename: שם הקובץ כולל הסיומת.
  • base64Content: תוכן קובץ בינארי מקודד כמחרוזת base64.
  • documentLibraryId: מזהה ספריית המסמכים (כונן)

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

  • parentFolderId: מזהה של תיקיית האב (ברירת מחדל: 'root').

createFolder

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

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

  • שם התיקייה: שם התיקייה
  • documentLibraryId: מזהה ספריית המסמכים (כונן)

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

  • parentFolderId: מזהה של תיקיית האב (ברירת מחדל: 'root').

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

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

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

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

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

  • etag: ETag לבקרת בו-זמניות

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

מוחק קובץ או תיקיה (DriveItem) מתוך ספריית המסמכים שצוינה (drive).

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

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

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

  • etag: ETag לבקרת בו-זמניות

העבר קובץ או תיקייה

העברת קובץ או תיקיה (DriveItem) אל תיקיית יעד. תומך במעבר בין ספריות מסמכים (כוננים) שונות בתוך SharePoint. פעולה זו אסינכרונית. השתמש ב־checkOperationStatus כדי לנטר את ההתקדמות.

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

  • sourcedoclibid: מזהה ספריית מסמכי המקור (כונן)
  • sourcefileid: מזהה קובץ המקור או התיקייה שיש להעביר
  • destdoclibid: מזהה ספריית המסמכים היעד (הכונן)
  • destfolderid: מזהה תיקיית היעד (חייב להתקיים)

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

  • newfilename: שם חדש לפריט שהועבר

copyFileOrFolder

העתקת קובץ או תיקיה (DriveItem) אל תיקיית יעד. תומך בהעתקה בספריות מסמכים שונות בתוך SharePoint. פעולה זו אסינכרונית. השתמש ב־checkOperationStatus כדי לנטר את ההתקדמות.

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

  • sourcedoclibid: מזהה ספריית מסמכי המקור (כונן)
  • sourcefileid: מזהה של קובץ המקור או התיקייה שיש להעתיק
  • destdoclibid: מזהה ספריית המסמכים היעד (הכונן)
  • destfolderid: מזהה תיקיית היעד (חייב להתקיים)

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

  • newfilename: שם חדש לפריט המועתק

checkOperationStatus

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

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

  • operationToken: טוקן הפעולה שהוחזר מפעולה אסינכרונית כמו copyFileOrFolder או moveFileOrFolder

uploadFileFromUrl

העלאת קובץ מכתובת SharePoint או OneDrive URL לתיקיה המהווה יעד בספריית מסמכים (כונן). הקובץ מועתק מכתובת ה- URL של המקור, כך שהקובץ המקורי אינו משתנה.

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

  • sourceUrl: כתובת המקור (חייב להיות כתובת SharePoint או OneDrive תקפה)
  • destinationDocumentLibraryId: מזהה של ספריית המסמכים של היעד. השתמש me עבור פרטי המשתמש OneDrive

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

  • destinationFolderId: מזהה תיקיית היעד (ברירת מחדל: root)
  • שם הקובץ: שם קובץ חדש; ברירת המחדל הוא שם הקובץ המקורי

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

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

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

  • documentLibraryId: מזהה ספריית המסמכים (כונן)
  • fileOrFolderId: מזהה הקובץ או התיקייה לשיתוף
  • recipientEmails: מערך כתובות דוא"ל של נמענים
  • תפקידים: מערך של תפקידים: 'קריאה', 'כתיבה' (כתיבה מעניקה גם קריאה וגם כתיבה)

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

  • הודעה: הודעה מותאמת אישית למייל ההזמנה (ברירת מחדל: הנה הקובץ שאנחנו משתפים פעולה עליו.)
  • sendInvitation: האם לשלוח הזמנה לשיתוף (ברירת מחדל: true)

setSensitivityLabelOnFile

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

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

  • documentLibraryId: מזהה ספריית המסמכים (כונן)
  • fileId: מזהה הקובץ (DriveItem)
  • sensitivityLabelId: מזהה של תווית הרגישות, או מחרוזת ריקה להסרה

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

  • assignmentMethod: שיטת הקצאה: 'standard', 'privileged', 'auto' או 'unknownFutureValue' (ברירת מחדל: 'privileged')
  • justificationText: טקסט הצדקה לצורכי ביקורת; נדרש בעת הורדת או הסרת תווית (ברירת מחדל: 'שונה על ידי MCPServer')

רשימות רשימה

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

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

  • siteId: מזהה אתר SharePoint (פורמט: 'hostname,siteCollectionId,webId')

createList

יוצר רשימת SharePoint חדשה בתוך אתר.

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

  • siteId: המזהה של אתר SharePoint
  • displayName: שם תצוגה של הרשימה החדשה

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

  • עמודות: אוסף עמודות כזוגות מפתח-ערך: [{ Key: 'JobTitle', Value: 'text' }]. סוגים חוקיים: טקסט, טקסט מרובה שורות, מספר, בוליאני, dateTime, בחירה, בדיקת מידע, personOrGroup, היפר-קישור, מטבע, מחושב
  • תבנית: סוג תבנית רשימה (ברירת מחדל: 'genericList'). אפשרויות: genericList, documentLibrary, events, tasks, announcements, contacts, links, survey, issueTracking, discussionBoard

מחק רשימה

מוחק רשימת SharePoint מהאתר. מחיקת הגורם המכיל של הרשימה כולה וכל הפריטים בתוכו. אין אפשרות לבטל פעולה זו.

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

  • siteId: מזהה אתר SharePoint
  • listId: מזהה של הרשימה שיש למחוק

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

  • etag: ETag לבקרת מקביליות

שלח הזמנה עבור הרשימה

שולח הזמנת שיתוף כדי להעניק הרשאות עבור רשימת SharePoint.

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

  • listId: מזהה של SharePoint list שאותה יש לשתף
  • recipientEmails: מערך כתובות דוא"ל של נמענים
  • תפקיד: תפקיד: 'read' (רק תצוגה), 'contribute' (צפייה, הוספה, עדכון, מחיקת פריטים), 'edit' (עריכה מלאה כולל מבנה הרשימה)

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

  • siteUrl: כתובת האתר של אתר SharePoint המכיל את הרשימה
  • שלח דוא"ל: האם לשלוח הודעת דוא"ל (ברירת מחדל: true)

listListItems

אחזור פריטים (שורות/רשומות) מרשימת SharePoint מסוימת.

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

  • siteId: מזהה אתר SharePoint
  • listId: מזהה של SharePoint list

getListItem

מקבל פריט יחיד (שורה או רשומה) מרשימת SharePoint list לפי מזהה שלו.

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

  • siteId: מזהה אתר SharePoint
  • listId: מזהה של SharePoint list
  • itemId: מזהה של פריט הרשימה הספציפי

createListItem

יוצר פריט חדש (שורה או רשומה) ברשימת SharePoint.

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

  • siteId: מזהה אתר SharePoint
  • listId: מזהה של SharePoint list
  • שדות: זוגות מפתח-ערך עבור ערכי שדה, כגון [{ Key: 'Title', Value: 'Software Engineer' }, { Key: 'Department', Value: 'Engineering' }]. שדה 'תואר' נדרש בדרך כלל.

updateListItem

עדכון פריט קיים (שורה או רשומה) SharePoint list. רק השדות שצוינו מעודכנים; שדות מושמטים שומרים על הערכים שלהם.

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

  • siteId: מזהה אתר SharePoint
  • listId: מזהה של SharePoint list
  • itemId: מזהה של הפריט לעדכון
  • שדות: זוגות מפתח-ערך של שדות לעדכון

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

  • etag: ETag לבקרת מקביליות

deleteListItem

מוחק פריט (שורה או רשומה) מרשימת SharePoint.

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

  • siteId: מזהה אתר SharePoint
  • listId: מזהה של SharePoint list
  • itemId: מזהה של הפריט שיש למחוק

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

  • etag: ETag לבקרת חבילות

עמודות הרשימה

מחזיר את כל העמודות מרשימת SharePoint.

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

  • siteId: מזהה אתר SharePoint
  • listId: מזהה של SharePoint list

צור עמודה

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

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

  • siteId: מזהה אתר SharePoint
  • listId: מזהה של SharePoint list
  • name: שם עמודה פנימית (מזהה פרוגרמטי)
  • columnType: סוג עמודה: text, note, number, מספר שלם, בוליאני, dateTime, choice, multichoice, currency, lookup, user, url, calculated, term, multiterm, location, geolocation, thumbnail, countered, computed, contentTypeId, file, attachment, guid, outcomeChoice, approvalStatus

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

  • columnProperties: הגדרות ספציפיות לסוג (למשל, { "maxLength": 255 } לטקסט, { "choices": ["A","B","C"] } לבחירה)
  • תיאור: תיאור העמודה
  • displayName: שם תצוגה שמוצג בממשק המשתמש (ברירת מחדל היא 'name')
  • required: הפוך את העמודה לחובה (ברירת מחדל: false)
  • מוסתר: הסתרת עמודה מהתצוגות (ברירת מחדל: false)

עמודת עדכון

מעדכן עמודה קיימת ברשימת SharePoint.

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

  • siteId: מזהה אתר SharePoint
  • listId: מזהה של SharePoint list
  • columnId: מזהה של העמודה שברצונך לעדכן

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

  • columnType: סוג עמודה (נדרש בעת מתן 'columnProperties')
  • columnProperties: מאפיינים ספציפיים לסוג לעדכון
  • תיאור: תיאור חדש
  • שם תצוגה: שם תצוגה חדש
  • מוסתר: הסתר או הצג עמודה
  • נדרש: הפוך את הטור לחובה או אופציונלי

מחק עמודה

מחיקת עמודה מעמודה SharePoint list. אזהרה: פעולה זו מסירה את כל הנתונים המאוחסנים בעמודה זו עבור כל הפריטים.

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

  • מזהה siteId: מזהה אתר SharePoint
  • listId: מזהה של SharePoint list
  • columnId: מזהה של העמודה שיש למחוק

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

ניהול אתר

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

ניהול ספריית מסמכים

  • פרט את כל ספריות המסמכים באתר.
  • קבל את ספריית המסמכים המהווה ברירת מחדל.
  • עיין בתוכן התיקיות (עד 20 פריטים).
  • צור ונהל מבני תיקיות.

פעולות קובץ

  • צור קבצי טקסט וקבצים בינאריים (5MB או פחות).
  • קרא טקסט וקבצים בינאריים (5MB או פחות).
  • מחק קבצים ותיקיות, שנה את שמם והעבר אותם.
  • העתק קבצים ותיקיות בין ספריות מסמכים.
  • העלה קבצים מכתובות SharePoint או OneDrive URL.
  • חפש קבצים ותיקיות בכל האתרים הנגישים.
  • קבל מטה-נתונים של קבצים ותיקיה.

פעולות אסינכרוניות

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

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

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

ניהול עמודות

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

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

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

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

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

Notes

  • פעולות קבצים מוגבלות לקבצים שנפחם 5 MB או פחות להעלאה ולהורדה.
  • פעולות העתקה והעברה הן אסינכרוניות. השתמש ב־checkOperationStatus כדי לנטר את ההתקדמות.
  • פעולות העתקה ו העברה תומכות בפעולות בין ספריות בתוך SharePoint.
  • uploadFileFromUrlדורש כתובת מקור תקפה של SharePoint או OneDrive.
  • eTags מספקים בקרת בו-זמניות עבור עדכונים ומחיקות.
  • סיומת מספרית אוטומטית לשמות תיקיות כפולות.
  • לא ניתן לבטל את מחיקת הרשימה.
  • מחיקת עמודות מסירה את כל הנתונים המאוחסנים בעמודה זו.
  • פעולות חיפוש מחזירות את 20 התוצאות המובילות כברירת מחדל.