Work IQ SharePoint-referens (förhandsversion)

Viktigt

Detta är en förhandsgranskningsfunktion.

  • Microsoft släpper förhandsgranskningsfunktioner finns tillgängliga före den officiella utgåvan så att kunderna kan få åtkomst tidigare och lämna feedback.
  • Förhandsgranskningsfunktioner har begränsad funktionalitet och är inte avsedda för användning i produktion.
  • Microsoft kan komma att ändra namn och parametrar på MCP-verktyg i förhandsversioner. Undvik hårdkodade beroenden. Microsoft upprätthåller scenariostöd.
  • Förhandsgranskningsfunktioner omfattas av Microsoft kompletterande användningsvillkor.

Översikt

Server-ID URL på klientorganisationsnivå Visningsnamn beskrivning
mcp_SharePointRemoteServer https://agent365.svc.cloud.microsoft/
agents/tenants/{tenantId}/
servers/mcp_SharePointRemoteServer		 Work IQ SharePoint MCP-server för SharePoint-hantering. Använd denna server för att hantera webbplatser, listor, listobjekt, kolumner, dokumentbibliotek, filer, mappar och fildelning. Filåtgärder är begränsade till filer som är 5 MB eller mindre.

Tillgängliga verktyg

findSite

Hittar SharePoint-sajter som du kan komma åt. Returnerar specifika SharePoint-webbplatser som matchar en sökfråga, eller de 20 mest relevanta webbplatserna om du inte anger någon sökfråga.

Valfria parametrar:

  • Sökfråga: (helt eller delvis webbplatsnamn) Utelämna för att returnera de 20 åtkomliga webbplatserna.

getSiteByPath

Identifierar en SharePoint-webbplats genom att använda dess exakta värdnamn och serverrelativa sökväg. Använd denna metod endast när du har hela webbplatsens URL-struktur. Använd findSite när du bara känner till ett webbplatsnamn.

Obligatoriska parametrar:

  • värdnamn: Exakt värdnamn (till exempel 'contoso.sharepoint.com')
  • serverRelativePath: Server-relativ sökväg (till exempel 'sites/Marketing'). Det ledande snedstrecket är valfritt.

listSubsites

Listar alla undersajter (underordnade objekt) av en SharePoint-webbplats.

Obligatoriska parametrar:

  • siteId: ID för den överordnade SharePoint-webbplatsen (format: 'hostname,siteCollectionId,webId')

listDocumentLibrariesInSite

Listar dokumentbibliotek (drives) på den angivna SharePoint-webbplatsen.

Valfria parametrar:

  • siteId: ID för SharePoint-webbplatsen (standard: 'root')

getDefaultDocumentLibraryInSite

Hämtar standarddokumentbiblioteket (drive) i en SharePoint-webbplats.

Valfria parametrar:

  • siteId: ID för SharePoint-webbplatsen (standard: 'root')

getFolderChildren

Listar de första 20 filer och mappar (DriveItems) som finns i en specificerad överordnat element-mapp i ett dokumentbibliotek (drive).

Obligatoriska parametrar:

  • dokumentbibliotekId: ID för dokumentbiblioteket (drive)

Valfria parametrar:

  • parentFolderId: ID för överordnade mappen (standard: 'root')

findFileOrFolder

Hittar en fil eller mapp (DriveItem) som är tillgänglig för användaren med hjälp av en sökfråga. Sökning sker bland alla webbplatser och dokumentbibliotek som användaren har tillgång till.

Obligatoriska parametrar:

  • searchQuery: Sökfråga: (helt eller delvis filnamn)

getFileOrFolderMetadata

Hämtar metadata för en fil eller mapp (DriveItem) från ett specificerat dokumentbibliotek (drive) i SharePoint.

Obligatoriska parametrar:

  • fileOrFolderId: ID för filen eller mappen (DriveItem)
  • dokumentbibliotekId: ID för dokumentbiblioteket (drive)

getFileOrFolderMetadataByUrl

Hämtar metadata för en fil eller mapp (DriveItem) från en delnings-URL. Endast användare som redan har uttryckliga behörigheter att komma åt filen får hämta metadata.

Obligatoriska parametrar:

  • fileOrFolderUrl: URL till filen eller mappen. URL:en är inte avsedd att dela med användaren. Den måste redan ha uttrycklig åtkomst.

readSmallTextFile

Läser (hämtar) en textfil mindre än 5 MB från ett specifikt dokumentbibliotek (drive).

Obligatoriska parametrar:

  • fileId: ID för filen (DriveItem) som ska läsas eller laddas ner
  • dokumentbibliotekId: ID för dokumentbiblioteket (drive)

readSmallBinaryFile

Läser en binär fil som är mindre än 5 MB från ett specifikt dokumentbibliotek (drive). Filinnehållet returneras som en Base64-kodad sträng.

Obligatoriska parametrar:

  • fileId: ID för filen (DriveItem) som ska läsas eller laddas ner
  • dokumentbibliotekId: ID för dokumentbiblioteket (drive)

createSmallTextFile

Skapar eller laddar upp en textfil mindre än 5 MB från ett specifikt dokumentbibliotek (drive).

Obligatoriska parametrar:

  • filename: Namnet på filen inklusive tillägget
  • contentText: Textinnehåll i filen
  • dokumentbibliotekId: ID för dokumentbiblioteket (drive)

Valfria parametrar:

  • parentFolderId: ID för överordnade mappen (standard: 'root')

createSmallBinaryFile

Skapar en binärfil mindre än 5 MB genom att Base64-koda dess innehåll och lagra den i ett specifikt dokumentbibliotek (drive).

Obligatoriska parametrar:

  • filename: Namnet på filen inklusive tillägget
  • base64Content: Filens binära innehåll kodat som en Base64-kodad sträng.
  • dokumentbibliotekId: ID för dokumentbiblioteket (drive)

Valfria parametrar:

  • parentFolderId: ID för överordnade mappen (standard: 'root')

createFolder

Skapar en ny mapp (DriveItem) inom ett angivet dokumentbibliotek (drive). Om en mapp med samma namn finns, lägger systemet till ett numeriskt suffix (till exempel NewFolder (1)).

Obligatoriska parametrar:

  • Mappnamn: Namnet på mappen
  • dokumentbibliotekId: ID för dokumentbiblioteket (drive)

Valfria parametrar:

  • parentFolderId: ID för överordnade mappen (standard: 'root')

renameFileOrFolder

Ändrar namn på en fil eller mapp (DriveItem) inom ett angivet dokumentbibliotek (drive). Det nya namnet måste följa namngivningskonventioner.

Obligatoriska parametrar:

  • dokumentbibliotekId: ID för dokumentbiblioteket (drive)
  • fileOrFolderId: ID för filen eller mappen som ska döpas om
  • newFileOrFolderName: Nytt namn

Valfria parametrar:

  • etag: ETag för samtidighetskontroll

deleteFileOrFolder

Tar bort en fil eller mapp (DriveItem) från ett angivet dokumentbibliotek (drive).

Obligatoriska parametrar:

  • dokumentbibliotekId: ID för dokumentbiblioteket (drive)
  • fileOrFolderId: ID för filen eller mappen som ska tas bort

Valfria parametrar:

  • etag: ETag för samtidighetskontroll

moveFileOrFolder

Flyttar en fil eller mapp (DriveItem) till en målmapp. Stöder att flytta mellan olika dokumentbibliotek (enheter) inom SharePoint. Denna åtgärd är asynkron. Använd checkOperationStatus för att övervaka förloppet.

Obligatoriska parametrar:

  • sourcedoclibid: ID för källdokumentbiblioteket (enhet)
  • sourcefileid: ID för källfilen eller mappen som ska flyttas
  • destdoclibid: ID för måldokumentbiblioteket (enhet)
  • destfolderid: ID för målmapp (måste finnas)

Valfria parametrar:

  • newfilename: Nytt namn för det flyttade objektet

copyFileOrFolder

Kopierar en fil eller mapp (DriveItem) till en destinationsmapp. Stöder kopiering mellan olika dokumentbibliotek inom SharePoint. Denna åtgärd är asynkron. Använd checkOperationStatus för att övervaka förloppet.

Obligatoriska parametrar:

  • sourcedoclibid: ID för källdokumentbiblioteket (enhet)
  • sourcefileid: ID för källfilen eller mappen som ska kopieras
  • destdoclibid: ID för måldokumentbiblioteket (enhet)
  • destfolderid: ID för målmapp (måste finnas)

Valfria parametrar:

  • nyttfilnamn: Nytt namn för det kopierade objektet

checkOperationStatus

Kontrollerar statusen för en asynkron åtgärd, såsom en kopia eller flytt, genom att använda åtgärdstoken som returnerats från den ursprungliga åtgärden.

Obligatoriska parametrar:

  • åtgärdToken: Åtgärdstoken som returnerats från en asynkron åtgärd som copyFileOrFolder eller moveFileOrFolder

uploadFileFromUrl

Laddar upp en fil från en SharePoint- eller OneDrive-URL till en destinationsmapp i ett dokumentbibliotek. Filen kopieras från käll-URL:en, så originalfilen ändras inte.

Obligatoriska parametrar:

  • käll-URL: Käll-URL (måste vara en giltig SharePoint- eller OneDrive-URL)
  • destinationsdokumentbiblioteket: ID för destinationsdokumentbiblioteket. Använd me för användarens OneDrive

Valfria parametrar:

  • destinationFolderId: ID för destinationsmappen (standard: root)
  • filenamn: Nytt filnamn; går tillbaka till originalfilnamnet

shareFileOrFolder

Skickar en delningsinbjudan för att ge läs- eller skrivbehörighet på en fil eller mapp (DriveItem) inom ett angivet dokumentbibliotek (drive).

Obligatoriska parametrar:

  • dokumentbibliotekId: ID för dokumentbiblioteket (drive)
  • fileOrFolderId: ID för filen eller mappen som ska delas
  • recipientEmails: Array av mottagares e-postadresser
  • roles: Array av roller: 'läs', 'skriv' (skriv ger både läs- och skrivbehörighet)

Valfria parametrar:

  • message: Anpassat meddelande för inbjudningsmejlet (standard: Här är filen vi samarbetar med.)
  • sendInvitation: Om en delningsinbjudan ska skickas (standard: true)

setSensitivityLabelOnFile

Anger känslighetsetiketten för en fil från det angivna dokumentbiblioteket (drive).

Obligatoriska parametrar:

  • dokumentbibliotekId: ID för dokumentbiblioteket (drive)
  • fileId: ID för filen (DriveItem)
  • sensitivityLabelId: ID för känslighetsetiketten, eller en tom sträng för att ta bort den

Valfria parametrar:

  • tilldelningsmetod: Tilldelningsmetod: 'standard', 'privilegierad', 'auto' eller 'unknownFutureValue' (förval: 'privilegierad')
  • motiveringstext: Motiveringstext för granskningsändamål; krävs vid nedgradering eller borttagning av en etikett (standard: 'Ändrat av MCPServer')

listLists

Hämtar alla SharePoint-listor som är tillgängliga på en specifik webbplats. Använd för att ta reda på vilka listor som finns på en webbplats.

Obligatoriska parametrar:

  • siteId: ID för SharePoint-webbplatsen (format: 'hostname,siteCollectionId,webId')

createList

Skapar en ny SharePoint-lista på en webbplats.

Obligatoriska parametrar:

  • siteId: ID för SharePoint-webbplatsen
  • displayName: Visningsnamn på den nya listan

Valfria parametrar:

  • kolumner: Samling av kolumner som nyckel-värdepar: [{ Key: 'JobTitle', Value: 'text' }]. Giltiga typer: text, multilineText, number, boolesk, dateTime, choice, lookup, personOrGroup, hyperlink, currency, calculated
  • mall: listmalltyp (standard: 'genericList'). Alternativ: genericList, documentLibrary, evenemang, uppgifter, meddelanden, kontakter, länkar, enkät, issueTracking, diskussionsforum

deleteList

Tar bort en SharePoint-lista från en webbplats. Tar bort hela listbehållaren och alla poster i den. Detta kan inte ångras.

Obligatoriska parametrar:

  • siteId: ID för SharePoint-webbplatsen
  • listId: ID för listan som ska tas bort

Valfria parametrar:

  • etag: ETag för samtidighetskontroll

sendInviteForList

Skickar en delningsinbjudan för att ge behörigheter på en SharePoint-lista.

Obligatoriska parametrar:

  • listId: ID för den SharePoint-lista som ska delas
  • recipientEmails: Array av mottagares e-postadresser
  • role: Roll: 'läsa' (endast visning), 'bidra' (visa, lägga till, uppdatera, ta bort objekt), 'redigera' (fullständig redigering inklusive listans struktur)

Valfria parametrar:

  • siteUrl: URL till SharePoint-webbplatsen som innehåller listan
  • sendEmail: Anger om en e-postavisering ska skickas (förval: sant)

listListItems

Hämtar poster (rader/objekt) från en specifik SharePoint-lista.

Obligatoriska parametrar:

  • siteId: ID för SharePoint-webbplatsen
  • listId: ID för SharePoint-listan

getListItem

Hämtar ett enskilt objekt (rad/post) från en SharePoint-lista med dess ID.

Obligatoriska parametrar:

  • siteId: ID för SharePoint-webbplatsen
  • listId: ID för SharePoint-listan
  • itemId: ID för det specifika listobjektet

createListItem

Skapar ett nytt objekt (rad eller post) från en SharePoint-lista.

Obligatoriska parametrar:

  • siteId: ID för SharePoint-webbplatsen
  • listId: ID för SharePoint-listan
  • fält: Nyckelvärdespar för fältvärden: [{ Key: 'Title', Value: 'Software Engineer' }, { Key: 'Department', Value: 'Engineering' }]. Fältet "Titel" är vanligtvis obligatoriskt

updateListItem

Uppdaterar ett befintligt objekt (rad eller post) i en SharePoint-lista. Endast specificerade fält uppdateras; utelämnade fält behåller sina värden.

Obligatoriska parametrar:

  • siteId: ID för SharePoint-webbplatsen
  • listId: ID för SharePoint-listan
  • itemId: ID för objektet som ska uppdateras
  • fields: Nyckel-värdepar för fält som ska uppdateras

Valfria parametrar:

  • etag: ETag för samtidighetskontroll

deleteListItem

Tar bort ett objekt (rad eller post) från en SharePoint-lista.

Obligatoriska parametrar:

  • siteId: ID för SharePoint-webbplatsen
  • listId: ID för SharePoint-listan
  • itemId: ID för posten som ska tas bort

Valfria parametrar:

  • etag: ETag för samtidighetskontroll

listColumns

Hämtar alla kolumner från en SharePoint-lista.

Obligatoriska parametrar:

  • siteId: ID för SharePoint-webbplatsen
  • listId: ID för SharePoint-listan

createColumn

Skapar en ny kolumn i en SharePoint-lista. Stöder många kolumntyper, inklusive text, nummer, val, datum/tid, boolesk, användare, uppslag, beräknad och flera andra.

Obligatoriska parametrar:

  • siteId: ID för SharePoint-webbplatsen
  • listId: ID för SharePoint-listan
  • namn: Internt kolumnnamn (programmatisk identifierare)
  • kolumnTyp: Kolumntyp: text, anteckning, nummer, heltal, boolesk, datumTid, val, flerval, valuta, uppslag, användare, url, beräknad, term, flervalsterm, plats, geoplats, miniatyr, räknare, beräknad, innehållstypId, fil, bilaga, guid, resultatval, godkännandestatus

Valfria parametrar:

  • columnProperties: Typspecifika inställningar (till exempel { "maxLength": 255 } för text, { "choices": ["A","B","C"] } för val)
  • description: En beskrivning av verktyget
  • Visningsnamn: Visningsnamn som visas i användargränssnittet (standardvärde är "name")
  • obligatorisk: Gör kolumnen obligatorisk (standard: falsk)
  • dold: Dölj kolumn från vyer (standard: falsk)

updateColumn

Uppdaterar en befintlig kolumn i en SharePoint-lista.

Obligatoriska parametrar:

  • siteId: ID för SharePoint-webbplatsen
  • listId: ID för SharePoint-listan
  • columnId: ID för kolumnen som ska uppdateras

Valfria parametrar:

  • columnType: Kolumntyp (krävs när du anger 'columnProperties')
  • columnProperties: Typspecifika egenskaper att uppdatera
  • description: Ny beskrivning
  • displayName: Nytt visningsnamn
  • dolt: Dölj eller visa kolumn
  • krävs: Gör kolumn obligatorisk eller valfri

deleteColumn

Tar bort en kolumn från en SharePoint-lista. Varning: Denna åtgärd tar bort all data som lagrats i den kolumnen för alla objekt.

Obligatoriska parametrar:

  • siteId: ID för SharePoint-webbplatsen
  • listId: ID för SharePoint-listan
  • columnId: ID för kolumnen som ska tas bort

Viktiga funktioner

Platshantering

  • Hitta webbplatser efter namn eller bläddra bland tillgängliga webbplatser.
  • Hämta en webbplats med en exakt URL-sökväg.
  • Visa en lista över underordnade webbplatser och underwebbplatser.
  • Omfattande navigering i webbplatshierarkin.

Dokumentbibliotekshantering

  • Lista alla dokumentbibliotek på en webbplats
  • Hämta standarddokumentbiblioteket.
  • Bläddra i mappens innehåll (upp till 20 objekt)
  • Skapa och hantera mappstrukturer.

Filåtgärder

  • Skapa text- och binärfiler (≤5 MB).
  • Läs text- och binärfiler (≤5 MB).
  • Ta bort, byt namn och flytta filer och mappar.
  • Kopiera filer och mappar mellan dokumentbibliotek.
  • Ladda upp filer från SharePoint- eller OneDrive-URL:er.
  • Sök efter filer och mappar på alla tillgängliga webbplatser.
  • Hämta fil- och mappmetadata.

Asynkrona åtgärder

  • Kopiera och flytta filer och mappar asynkront mellan dokumentbibliotek.
  • Kontrollera statusen för asynkrona åtgärder med hjälp av åtgärdstoken.

Liståtgärder

  • Skapa, läs och ta bort listor.
  • Stöd för flera listmallar, inklusive generiska, dokumentbibliotek, händelser och uppgifter.
  • Dela listor med rollbaserade behörigheter.
  • Hantera listobjekt genom att skapa, läsa, uppdatera och ta bort dem.

Kolumnhantering

  • Skapa kolumner med en mängd olika typer, såsom text, anteckningsfält, nummer, boolesk, datum/tid, val, uppslag, användare, URL, beräknad och mycket mer.
  • Uppdatera kolumnegenskaper och metadata.
  • Konfigurera kolonnekrav och synlighet.
  • Konfigurera typspecifika kolumnegenskaper.

Delning och behörigheter

  • Dela filer, mappar och listor med användare.
  • Använd rollbaserad åtkomstkontroll med läs-, skriv-, bidra- och redigeringsroller.
  • E-postaviseringar om delning
  • Anpassade meddelanden i inbjudningar

Säkerhet och regelefterlevnad

  • Tillämpa och ta bort känslighetsbeteckningar.
  • Använd flera tilldelningsmetoder, inklusive standard, privilegierad och automatisk.
  • Stöd revisionsmotivering.
  • Använd samtidighetskontroll med eTags.

Anteckningar

  • Filåtgärder är begränsade till filer som är 5 MB eller mindre för uppladdning och nedladdning.
  • Kopierings- och flyttåtgärder är asynkrona. Använd checkOperationStatus för att övervaka förloppet.
  • Kopierings- och flyttåtgärder stöder åtgärder mellan olika dokumentbibliotek inom SharePoint.
  • uploadFileFromUrl kräver en giltig SharePoint- eller OneDrive-käll-URL.
  • eTags används för samtidighetskontroll vid uppdatering och radering.
  • Automatiskt numeriskt suffix för mappar med samma namn
  • Listradering kan inte ångras.
  • Kolumnradering tar bort all data som lagrats i den kolumnen.
  • Sökåtgärder returnerar som standard de 20 första resultaten.
  • Last updated on