Referencja do SharePoint (podgląd)

Note

Ten artykuł opisuje cechy stosowane w przepływach agentów lub przepływach agentów zasilanych standardową wiązką.

Important

To jest funkcja w wersji zapoznawczej.

• Microsoft udostępnia funkcje w wersji zapoznawczej przed ich oficjalnym wydaniem, aby klienci mogli uzyskać wcześniejszy dostęp i przekazać opinie.
• Funkcje w wersji zapoznawczej mają ograniczone funkcje i nie są przeznaczone do użytku produkcyjnego.
• Microsoft może zmienić nazwy i parametry narzędzia MCP w wersji zapoznawczej. Unikaj zakodowanych na sztywno zależności. Microsoft obsługuje scenariusze.
• Funkcje w wersji zapoznawczej podlegają dodatkowym warunkom użytkowania firmy Microsoft.

Note

Narzędzia Microsoft 365 MCP specyficzne dla aplikacji (Copilot, Kalendarz, Mail, SharePoint, OneDrive, Teams, User i Word) są przeznaczone wyłącznie do kompatybilności wstecznej i nie powinny być używane w środowiskach produkcyjnych ani nowych projektach. W przypadku nowych projektów wymagających dostępu do zasobów Microsoft 365 użyj Work IQ MCP z Microsoft Copilot harness. Więcej informacji można znaleźć w artykule Work IQ MCP w Copilot Studio.

Overview

Identyfikator serwera	Adres URL na poziomie dzierżawcy	Wyświetlana nazwa	Opis
mcp_SharePointRemoteServer	https://agent365.svc.cloud.microsoft/ agents/tenants/{tenantId}/servers/ mcp_SharePointRemoteServer	SharePoint	Narzędzia do operacji SharePoint. Ten serwer służy do zarządzania witrynami, listami, elementami listy, kolumnami, bibliotekami dokumentów, plikami, folderami i udostępnianiem plików. Operacje na plikach są ograniczone do plików o rozmiarze co najmniej 5 MB.

Dostępne narzędzia

findSite

Znajduje witryny programu SharePoint, do których masz dostęp. Zwraca określone witryny pasujące do zapytania wyszukiwania lub 20 najważniejszych odpowiednich witryn, jeśli nie podasz zapytania.

Parametry opcjonalne:

• searchQuery: Zapytanie wyszukiwania (pełna lub częściowa nazwa witryny). Pomiń zwracanie 20 najważniejszych witryn z ułatwieniami dostępu.

getSiteByPath

Rozpoznaje lokację SharePoint przy użyciu dokładnej nazwy hosta i ścieżki względnej serwera. Użyj tej metody tylko wtedy, gdy masz pełną strukturę adresów URL witryny. Użyj findSite, jeśli znasz tylko nazwę witryny.

Wymagane parametry:

• hostname: Dokładna nazwa hosta (na przykład „contoso.sharepoint.com”)
• serwerRelatywna ścieżka: Ścieżka względna serwera (na przykład 'strony/Marketing'). Ukośnik wiodący jest opcjonalny.

listSubsites

Wyświetla listę wszystkich podwitryn (witryn podrzędnych) witryny SharePoint.

Wymagane parametry:

• siteId: ID nadrzędnej witryny SharePoint (format: 'hostname,siteCollectionId,webId')

wymieńBibliotekiDokumentówNaWitrynie

Wyświetla listę bibliotek dokumentów (dysków) w określonej witrynie SharePoint.

Parametry opcjonalne:

• siteId: ID witryny SharePoint (domyślnie: 'root')

PobierzDomyślnąBibliotekęDokumentówWSerwisie

Pobiera domyślną bibliotekę dokumentów (dysk) w witrynie SharePoint.

Parametry opcjonalne:

• siteId: Identyfikator witryny SharePoint (domyślnie: „root”)

getFolderChildren

Wylicza 20 pierwszych plików i folderów (DriveItems) zawartych w określonym folderze nadrzędnym w bibliotece dokumentów (dysku).

Wymagane parametry:

• documentLibraryId: ID biblioteki dokumentów (dysku)

Parametry opcjonalne:

• parentFolderId: identyfikator folderu nadrzędnego (domyślnie: 'root').

findFileOrFolder

Znajduje plik lub folder (DriveItem) dostępny dla użytkownika przez zapytanie wyszukiwania. Wyszukuje we wszystkich witrynach i bibliotekach dokumentów, do których użytkownik ma dostęp.

Wymagane parametry:

• searchQuery: Zapytanie wyszukiwania (cała lub częściowa nazwa pliku)

getFileOrFolderMetadata

Pobiera metadane pliku lub folderu (DriveItem) z określonej biblioteki dokumentów (dysku) w SharePoint.

Wymagane parametry:

• fileOrFolderId: ID pliku lub folderu (DriveItem)
• documentLibraryId: Identyfikator biblioteki dokumentów (dysku)

getFileOrFolderMetadataByUrl

Pobiera metadane pliku lub folderu (DriveItem) z udostępniającego URL. Metadane mogą uzyskać tylko użytkownicy z istniejącymi jawnymi uprawnieniami dostępu do pliku.

Wymagane parametry:

• fileOrFolderUrl: URL pliku lub folderu. Adres URL nie służy do udostępniania zasobu użytkownikowi; użytkownik musi już mieć wyraźnie przyznany dostęp.

readSmallTextFile

Odczytuje (pobiera) plik tekstowy mniejszy niż 5 MB z konkretnej biblioteki dokumentów (dysku).

Wymagane parametry:

• fileId: ID pliku (DriveItem) do odczytu lub pobrania
• documentLibraryId: Identyfikator biblioteki dokumentów (dysku)

readSmallBinaryFile

Odczytuje plik binarny mniejszy niż 5 MB z określonej biblioteki dokumentów (dysku). Zawartość pliku jest zwracana jako ciąg zakodowany w formacie base64.

Wymagane parametry:

• fileId: ID pliku (DriveItem) do odczytu lub pobrania
• documentLibraryId: Identyfikator biblioteki dokumentów (dysku)

createSmallTextFile

Tworzy lub przesyła plik tekstowy mniejszy niż 5 MB do konkretnej biblioteki dokumentów (dysku).

Wymagane parametry:

• filename: Nazwa pliku wraz z rozszerzeniem.
• contentText: Treść tekstowa pliku.
• documentLibraryId: ID biblioteki dokumentów (dysku)

Parametry opcjonalne:

• parentFolderId: ID folderu nadrzędnego (domyślnie: 'root').

createSmallBinaryFile

Tworzy plik binarny mniejszy niż 5 MB przez kodowanie zawartości base64 do określonej biblioteki dokumentów (dysku).

Wymagane parametry:

• filename: Nazwa pliku wraz z rozszerzeniem.
• base64Content: Binarna zawartość pliku zakodowana jako string base64.
• documentLibraryId: ID biblioteki dokumentów (dysku)

Parametry opcjonalne:

• parentFolderId: ID folderu nadrzędnego (domyślnie: 'root').

utwórzFolder

Tworzy nowy folder (DriveItem) w określonej bibliotece dokumentów (dysku). Jeśli istnieje folder o tej samej nazwie, system dodaje sufiks liczbowy (na przykład NewFolder (1)).

Wymagane parametry:

• folderName: Nazwa folderu
• documentLibraryId: ID biblioteki dokumentów (dysku)

Parametry opcjonalne:

• parentFolderId: ID folderu nadrzędnego (domyślnie: 'root').

zmieńNazwęPlikuLubFolderu

Zmienia nazwę pliku lub folderu (DriveItem) w określonej bibliotece dokumentów (dysku). Nowa nazwa musi być zgodna z konwencjami nazewnictwa.

Wymagane parametry:

• documentLibraryId: ID biblioteki dokumentów (dysku)
• fileOrFolderId: ID pliku lub folderu do zmiany nazwy
• newFileOrFolderName: Nowa nazwa

Parametry opcjonalne:

• etag: ETag do kontroli współbieżności

deleteFileOrFolder

Usuwa plik lub folder (DriveItem) z określonej biblioteki dokumentów (dysku).

Wymagane parametry:

• documentLibraryId: ID biblioteki dokumentów (dysku)
• fileOrFolderId: ID pliku lub folderu do usunięcia

Parametry opcjonalne:

• etag: ETag do kontroli współbieżności

moveFileOrFolder

Przenosi plik lub folder (DriveItem) do folderu docelowego. Obsługuje przenoszenie między różnymi bibliotekami dokumentów (dyskami) w SharePoint. Ta operacja jest asynchroniczna. Użyj checkOperationStatus, aby monitorować postęp.

Wymagane parametry:

• sourcedoclibid: ID biblioteki dokumentów źródłowych (dysku)
• sourcefileid: ID pliku źródłowego lub folderu do przeniesienia
• destdoclibid: ID docelowej biblioteki dokumentów (dysku)
• destfolderid: ID folderu docelowego (musi istnieć)

Parametry opcjonalne:

• newfilename: Nowa nazwa przeniesionego elementu

kopiujPlikLubFolder

Kopiuje plik lub folder (DriveItem) do folderu docelowego. Obsługuje kopiowanie między różnymi bibliotekami dokumentów w SharePoint. Ta operacja jest asynchroniczna. Użyj checkOperationStatus, aby monitorować postęp.

Wymagane parametry:

• sourcedoclibid: ID biblioteki dokumentów źródłowych (dysku)
• sourcefileid: ID pliku źródłowego lub folderu do skopiowania
• destdoclibid: ID docelowej biblioteki dokumentów (dysku)
• destfolderid: Identyfikator folderu docelowego (musi istnieć)

Parametry opcjonalne:

• newfilename: Nowa nazwa skopiowanego elementu

checkOperationStatus

Sprawdza stan operacji asynchronicznej, takiej jak kopiowanie lub przenoszenie, przy użyciu tokenu operacji zwróconego z oryginalnej operacji.

Wymagane parametry:

• operationToken: Token operacji zwracany z operacji asynchronicznej takiej jak copyFileOrFolder lub moveFileOrFolder

uploadFileFromUrl

Przekazuje plik z adresu URL SharePoint lub OneDrive do folderu docelowego w bibliotece dokumentów (dysku). Plik jest kopiowany ze źródłowego adresu URL, więc oryginalny plik nie jest zmieniany.

Wymagane parametry:

• sourceUrl: Źródłowy adres URL (musi być poprawnym adresem SharePoint lub OneDrive)
• destinationDocumentLibraryId: ID docelowej biblioteki dokumentów. Użyj me dla OneDrive użytkownika

Parametry opcjonalne:

• destinationFolderId: ID folderu docelowego (domyślnie: root)
• nazwa pliku: Nowa nazwa pliku; domyślnie przyjmuje oryginalną nazwę pliku

udostępnijPlikLubFolder

Wysyła zaproszenie do udostępniania, aby udzielić uprawnień do odczytu lub zapisu w pliku lub folderze (DriveItem) w określonej bibliotece dokumentów (dysku).

Wymagane parametry:

• documentLibraryId: ID biblioteki dokumentów (dysku)
• fileOrFolderId: ID pliku lub folderu do udostępnienia
• recipientEmails: Zestaw adresów e-mail odbiorców
• Role: Zakres ról: 'czytać', 'pisać' (pisać granty zarówno czytać, jak i pisać)

Parametry opcjonalne:

• Wiadomość: Niestandardowa wiadomość do zaproszenia e-mail (domyślnie: Oto plik, nad którym współpracujemy.)
• wyślijZaproszenie: Czy wysłać zaproszenie do udostępniania (domyślnie: true)

ustawEtykietęCzułościNaPliku

Ustawia etykietę poufności pliku z określonej biblioteki dokumentów (dysku).

Wymagane parametry:

• documentLibraryId: Identyfikator biblioteki dokumentów (dysku)
• fileId: ID pliku (DriveItem)
• sensitivityLabelId: ID etykiety poufności lub pusty ciąg znaków, aby ją usunąć

Parametry opcjonalne:

• Metoda przypisania: Metoda przypisania: 'standard', 'privileged', 'auto' lub 'unknownFutureValue' (domyślnie: 'privileged')
• justificationText: Tekst uzasadnienia do celów audytu; wymagany przy obniżaniu lub usuwaniu etykiety (domyślnie: 'Zmienione przez MCPServer')

listLists

Pobiera wszystkie listy SharePoint dostępne w określonej witrynie. Użyj, aby dowiedzieć się, jakie listy istnieją w witrynie.

Wymagane parametry:

• siteId: ID witryny SharePoint (format: 'hostname,siteCollectionId,webId')

createList

Tworzy nową listę programu SharePoint w witrynie.

Wymagane parametry:

• siteId: ID strony SharePoint
• displayName: Nazwa wyświetlania nowej listy

Parametry opcjonalne:

• kolumny: Zbiór kolumn jako par klucz-wartość: [{ Key: 'JobTitle', Value: 'text' }]. Prawidłowe typy: text, multilineText, number, boolean, dateTime, choice, lookup, personOrGroup, hyperlink, currency, calculated
• szablon: Typ szablonu Listy (domyślnie: 'genericList'). Opcje: lista ogólna, biblioteka dokumentów, wydarzenia, zadania, ogłoszenia, kontakty, linki, ankieta, śledzenie problemów, forum dyskusyjne

deleteList

Usuwa SharePoint list z witryny. Usuwa cały kontener listy i wszystkie elementy w nim. Tej akcji nie można cofnąć.

Wymagane parametry:

• siteId: ID strony SharePoint
• listId: ID listy do usunięcia

Parametry opcjonalne:

• etag: ETag do kontroli współbieżności

sendInviteForList

Wysyła zaproszenie do udostępniania, aby nadać uprawnienia do listy SharePoint.

Wymagane parametry:

• listId: Identyfikator elementu SharePoint list do udostępnienia
• recipientEmails: Zestaw adresów e-mail odbiorców
• Rola: Rola: 'odczyt' (tylko wyświetlanie), 'współtwórz' (wyświetlaj, dodaj, aktualizuj, usuwaj elementy), 'edytuj' (pełna edycja wraz ze strukturą listy)

Parametry opcjonalne:

• siteUrl: URL strony SharePoint zawierającej listę
• sendEmail: Czy wysłać powiadomienie e-mail (domyślnie: true)

listListItems

Pobiera elementy (wiersze/rekordy) z określonej listy SharePoint.

Wymagane parametry:

• siteId: ID strony SharePoint
• listId: ID listy SharePoint

getListItem

Pobiera pojedynczy element (wiersz lub rekord) z listy SharePoint na podstawie jego identyfikatora.

Wymagane parametry:

• siteId: ID witryny SharePoint
• listId: ID listy SharePoint
• itemId: ID konkretnego elementu listy

createListItem

Tworzy nowy element (wiersz lub rekord) na liście SharePoint.

Wymagane parametry:

• siteId: ID strony SharePoint
• listId: ID listy SharePoint
• fields: Pary klucz–wartość określające wartości pól, na przykład [{ Key: 'Title', Value: 'Software Engineer' }, { Key: 'Department', Value: 'Engineering' }]. Zazwyczaj wymagane jest pole 'Tytuł'.

updateListItem

Aktualizuje istniejący element (wiersz lub rekord) na liście SharePoint. Tylko określone pola są aktualizowane; pominięte pola zachowują swoje wartości.

Wymagane parametry:

• siteId: ID strony SharePoint
• listId: Identyfikator SharePoint list
• itemId: ID elementu do aktualizacji
• pola: Pary klucz-wartość pól do zaktualizowania

Parametry opcjonalne:

• etag: ETag do kontroli współbieżności

deleteListItem

Usuwa element (wiersz lub rekord) z listy programu SharePoint.

Wymagane parametry:

• siteId: ID strony SharePoint
• listId: Identyfikator listy SharePoint
• itemId: ID elementu do usunięcia

Parametry opcjonalne:

• etag: ETag do kontroli współbieżności

listColumns (wylistujKolumny)

Pobiera wszystkie kolumny z listy SharePoint.

Wymagane parametry:

• siteId: ID strony SharePoint
• listId: Identyfikator listy SharePoint

createColumn

Tworzy nową kolumnę na liście programu SharePoint. Obsługuje wiele typów kolumn, takich jak tekst, liczba, wybór, data/godzina, wartość logiczna, użytkownik, wyszukiwanie, obliczanie i inne.

Wymagane parametry:

• siteId: ID strony SharePoint
• listId: ID listy SharePoint
• name: Wewnętrzna nazwa kolumny (identyfikator programistyczny)
• columnType: Typ kolumny: text, note, number, integer, boolean, dateTime, choice, multichoice, currency, lookup, user, url, calculated, term, multiterm, location, geolocation, thumbnail, counter, computed, contentTypeId, file, attachment, guid, outcomeChoice, approvalStatus

Parametry opcjonalne:

• columnProperties: Ustawienia specyficzne dla typów (na przykład { "maxLength": 255 } dla tekstu, { "choices": ["A","B","C"] } dla wyboru)
• description: Opis kolumny
• displayName: Nazwa wyświetlana w interfejsie (domyślnie 'nazwa')
• wymagane: Ustaw kolumnę wymaganą (domyślnie: false)
• ukryty: Ukryj kolumnę w widokach (domyślnie: false)

Zaktualizuj kolumnę

Aktualizuje istniejącą kolumnę na liście SharePoint.

Wymagane parametry:

• siteId: ID strony SharePoint
• listId: ID listy SharePoint
• columnId: ID kolumny do aktualizacji

Parametry opcjonalne:

• columnType: Typ kolumny (wymagany przy podawaniu 'columnProperties')
• columnProperties: Właściwości specyficzne dla typu, które można aktualizować
• Opis: Nowy opis
• wyświetlacz Nazwa: Nowa nazwa wyświetlana
• ukryte: Ukryj lub pokaż kolumnę
• wymagane: Ustaw kolumnę obowiązkową lub opcjonalną

Usuń kolumnę

Usuwa kolumnę z SharePoint list. Ostrzeżenie: Ta akcja usuwa wszystkie dane przechowywane w tej kolumnie dla wszystkich elementów.

Wymagane parametry:

• siteId: ID strony SharePoint
• listId: ID SharePoint list
• columnId: Identyfikator kolumny do usunięcia

Kluczowe funkcje

Zarządzanie lokacjami

• Znajdź witryny według nazwy lub przeglądaj dostępne witryny.
• Pobieranie witryny na podstawie dokładnej ścieżki URL.
• Wyświetlanie listy witryn podrzędnych i podwitryn.
• Kompleksowa nawigacja w hierarchii lokacji.

Zarządzanie biblioteką dokumentów

• Wyświetl listę wszystkich bibliotek dokumentów w witrynie.
• Pobierz domyślną bibliotekę dokumentów.
• Przeglądaj zawartość folderów (do 20 pozycji).
• Tworzenie struktur folderów i zarządzanie nimi.

Operacje na plikach

• Twórz pliki tekstowe i binarne (5 MB lub mniej).
• Czytaj tekst i pliki binarne (5 MB lub mniej).
• Usuwanie, zmienianie nazwy i przenoszenie plików i folderów.
• Kopiowanie plików i folderów między bibliotekami dokumentów.
• Przekazywanie plików z adresów URL SharePoint lub OneDrive.
• Wyszukaj pliki i foldery we wszystkich dostępnych witrynach.
• Pobieranie metadanych plików i folderów.

Operacje asynchroniczne

• Kopiowanie i przenoszenie plików i folderów asynchronicznie między bibliotekami dokumentów.
• Sprawdź stan operacji asynchronicznych przy użyciu tokenów operacji.

Lista operacji

• Tworzyć, odczytywać i usuwać listy.
• Obsługa wielu szablonów list, w tym ogólnych, bibliotek dokumentów, zdarzeń i zadań.
• Udostępniaj listy z uprawnieniami opartymi na rolach.
• Zarządzaj elementami listy, tworząc, odczytując, aktualizując i usuwając je.

Zarządzanie kolumnami

• Utwórz kolumny z szeroką gamą typów, takich jak tekst, uwaga, liczba, wartość logiczna, data/godzina, wybór, wyszukiwanie, użytkownik, adres URL, obliczane i inne.
• Aktualizowanie właściwości i metadanych kolumn.
• Konfigurowanie wymagań i widoczności kolumn.
• Ustaw właściwości kolumny specyficzne dla typu.

Udostępnianie i uprawnienia

• Udostępnianie plików, folderów i list użytkownikom.
• Użyj kontroli dostępu opartej na rolach z rolami odczytu, zapisu, współtworzenia i edycji.
• Powiadomienia e-mail o udostępnianiu
• Niestandardowe wiadomości w zaproszeniach.

Zabezpieczenia i zgodność

• Stosuj i usuwaj etykiety poufności.
• Użyj wielu metod przypisywania, w tym standardowych, uprzywilejowanych i automatycznych.
• Obsługa uzasadnienia audytu.
• Użyj kontroli współbieżności za pomocą znaczników ETag.

Uwagi

• Operacje na plikach są ograniczone do plików o rozmiarze 5 MB lub mniejszym podczas przesyłania i pobierania.
• Operacje kopiowania i przenoszenia są asynchroniczne. Użyj checkOperationStatus, aby monitorować postęp.
• Operacje kopiowania i przenoszenia obsługują operacje między bibliotekami w SharePoint.
• uploadFileFromUrlwymaga ważnego adresu źródłowego SharePoint lub OneDrive.
• eTagi zapewniają kontrolę współbieżności dla aktualizacji i usuwania.
• Automatyczny sufiks numeryczny dla duplikatów nazw folderów.
• Nie można cofnąć usuwania listy.
• Usunięcie kolumny usuwa wszystkie dane przechowywane w tej kolumnie.
• Operacje wyszukiwania domyślnie zwracają 20 pierwszych wyników.