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

הערה

המאפיינים במאמר זה מופעלים על ידי הרתמה הסטנדרטית, המשתמשת באפשרויות החיוב המתוארות ברישוי לסוכנים המופעלים על ידי הרתמה הסטנדרטית. למד כיצד לגשת לתכונות סטנדרטיות בסוכנים ובזרימות הסוכנים הסטנדרטיים של Access (Consumer Flows).

חשוב

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

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

סקירה כללית

מזהה שרת	כתובת 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: נתיב יחסי לשרת (לדוגמה, 'אתרים/שיווק'). קו נטוי מוביל הוא אופציונלי.

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

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

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

• siteId: מזהה אתר האב של SharePoint (תבנית: 'hostname,siteCollectionId,webId')

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

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

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

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

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

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

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

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

קבל אתFolderChildren

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

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

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

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

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

findFileOrFolder

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

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

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

getFileOrFolderMetadata

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

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

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

getFileOrFolderMetadataByUrl

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

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

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

readSmallTextFile

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

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

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

readSmallBinaryFile

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

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

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

createSmallTextFile

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

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

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

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

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

createSmallBinaryFile

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

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

• שם הקובץ: שם הקובץ כולל הסיומת.
• 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: מזהה של ספריית המסמכים המשמשת כמקור (כונן)
• מזהה מקור: מזהה של קובץ המקור או התיקיה המשמשים ל העברה
• destdoclibid: מזהה ספריית המסמכים המהווה יעד (כונן)
• destfolderid: מזהה תיקיית היעד (חייב להיות קיים)

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

• שם קובץ חדש: שם חדש עבור הפריט שהועבר

copyFileOrFolder

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

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

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

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

• שם קובץ חדש: שם חדש עבור הפריט שהועתק

checkOperationStatus

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

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

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

uploadFileFromUrl

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

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

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

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

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

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

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

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

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

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

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

setSensitivityLabelOnFile

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

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

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

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

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

רשימות רשימה

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

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

• siteId: מזהה אתר SharePoint (תבנית: 'hostname,siteCollectionId,webId')

createList

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

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

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

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

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

מחק רשימה

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

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

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

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

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

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

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

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

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

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

• siteUrl: כתובת ה- URL של אתר SharePoint המכיל את הרשימה
• שלח דואר אלקטרוני: אם לשלוח הודעת דואר אלקטרוני (ברירת מחדל: true)

listListItems

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

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

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

getListItem

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

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

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

createListItem

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

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

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

updateListItem

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

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

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

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

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

deleteListItem

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

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

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

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

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

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

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

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

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

צור עמודה

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

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

• siteId: מזהה אתר SharePoint זה
• listId: מזהה של SharePoint list
• שם: שם עמודה פנימית (מזהה תוכניתי)
• סוג עמודה: סוג עמודה: טקסט, הערה, מספר, מספר שלם, בוליאני, תאריך ושעה, בחירה, בחירה מרובה, מטבע, בדיקת מידע, משתמש, כתובת URL, מחושב, מונח, מונחים מרובים, מיקום, מיקום גיאוגרפי, תמונה ממוזערת, מונה, מחושב אוטומטית, מזהה סוג תוכן, קובץ, קובץ מצורף, GUID, בחירת תוצאה, מצב אישור

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

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

עמודת עדכון

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

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

• siteId: מזהה אתר SharePoint זה
• listId: מזהה של SharePoint list
• מזהה עמודה: מזהה העמודה לעדכון

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

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

מחק עמודה

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

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

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

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

ניהול אתר

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

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

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

פעולות קובץ

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

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

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

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

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

ניהול עמודות

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

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

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

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

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

הערות

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