Work IQ OneDrive-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_OneDriveRemoteServer	https://agent365.svc.cloud.microsoft/ agents/tenants/{tenantId}/servers/ mcp_OneDriveRemoteServer	Work IQ OneDrive	MCP-server för OneDrive-åtgärder. Använd denna server för att hantera filer och mappar i användarens personliga OneDrive. Alla filåtgärder är begränsade till ≤5 MB.

Tillgängliga verktyg

getOnedrive

Hämtar information om användarens OneDrive, inklusive enhetsmetadata, kvot och ägarinformation.

Inga parametrar krävs.

getFolderChildrenInMyOnedrive

Listar de 20 första filerna och mapparna (DriveItems) som finns i ett angivet överordnat objekt i användarens OneDrive.

Valfria parametrar:

• parentFolderId: ID för det överordnat objekt vars filer och mappar du vill lista (standard: 'root'):

findFileOrFolderInMyOnedrive

Hittar en fil eller mapp (DriveItem) i användarens OneDrive med hjälp av en sökfråga. Denna metod är effektivare än att söka bland alla tillgängliga filer om du vet att filen eller mappen finns i användarens OneDrive.

Obligatoriska parametrar:

• searchQuery: Sökfråga; kan vara hela eller delar av filnamnet

getFileOrFolderMetadataInMyOnedrive

Hämtar metadata för en fil eller mapp (DriveItem) från användarens OneDrive.

Obligatoriska parametrar:

• fileOrFolderId: ID för filen eller mappen i användarens OneDrive

getFileOrFolderMetadataByUrl

Hämtar metadata för en fil eller mapp (DriveItem) från en delnings-URL. Endast användare med befintliga explicita behörigheter att komma åt filen kan 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.

readSmallTextFileFromMyOnedrive

Läser (laddar ner) en textfil från användarens OneDrive.

Obligatoriska parametrar:

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

createSmallTextFileInMyOnedrive

Skapar eller laddar upp en textfil under 5 MB på användarens OneDrive.

Obligatoriska parametrar:

• filnamn: namn på filen som ska skapas
• contentText: Textinnehåll i filen

Valfria parametrar:

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

createFolderInMyOnedrive

Skapar en ny mapp (DriveItem) i användarens OneDrive som ett barn till den angivna överordnade mappen. Om en mapp med samma namn redan finns lägger metoden till ett numeriskt suffix (till exempel NewFolder (1)).

Obligatoriska parametrar:

• folderName: Namnet på den mapp som ska skapas

Valfria parametrar:

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

renameFileOrFolderInMyOnedrive

Byter namn på en fil eller mapp (DriveItem) i användarens OneDrive. Det nya namnet måste följa namngivningskonventioner.

Obligatoriska parametrar:

• fileOrFolderId: ID för filen eller mappen som ska döpas om
• newFileOrFolderName: Det nya namnet på filen eller mappen

Valfria parametrar:

• etag: ETag-värde för samtidighetskontroll. Åtgärden lyckas endast om DriveItems aktuella ETag matchar.

deleteFileOrFolderInMyOnedrive

Tar bort en fil eller mapp (DriveItem) från användarens OneDrive.

Obligatoriska parametrar:

• fileOrFolderId: ID för filen eller mappen som ska tas bort

Valfria parametrar:

• etag: ETag-värde för samtidighetskontroll

shareFileOrFolderInMyOnedrive

Skickar en delningsinbjudan för att ge läs- eller skrivbehörighet på en fil eller mapp (DriveItem) i användarens OneDrive.

Obligatoriska parametrar:

• fileOrFolderId: ID för filen eller mappen som ska delas
• recipientEmails: Array av e-postadresser till mottagare som ska bjudas in
• roller: Array med roller att tilldela. Godkända värden: 'read', 'write' (write ger både läs- och skrivbehörighet)

Valfria parametrar:

• meddelande: Anpassat meddelande att inkludera i inbjudningsmejlet. Standard: "Här är filen som vi samarbetar med."
• sendInvitation: Anger om en delningsinbjudan ska skickas. Standardvärde: SANT.

setSensitivityLabelOnFileInMyOnedrive

Tilldelar känslighetsetiketten för en fil i användarens OneDrive.

Obligatoriska parametrar:

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

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')

createSmallBinaryFileInMyOnedrive

Skapar en binär fil som är mindre än 5 MB genom att base64-koda dess innehåll och spara den i användarens OneDrive.

Obligatoriska parametrar:

• filnamn: Namnet på filen som ska skapas, inklusive filändelsen
• base64Content: Det binära filinnehållet kodad som en base64-sträng

Valfria parametrar:

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

readSmallBinaryFileFromMyOnedrive

Läser en binär fil som är mindre än 5 MB från användarens OneDrive. Returnerar filinnehållet som en base64-kodad sträng.

Obligatoriska parametrar:

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

copyFileOrFolderInMyOnedrive

Kopierar en fil eller mapp (DriveItem) till en målmapp inom användarens OneDrive. Denna åtgärd är asynkron. Använd checkOperationStatusInMyOnedrive för att övervaka förloppet.

Obligatoriska parametrar:

• sourcefileid: ID för källfilen eller mappen (DriveItem) som ska kopieras
• destfolderid: ID för destinationsmappen (måste finnas i användarens OneDrive)

Valfria parametrar:

• newfilename: Nytt namn för det kopierade objektet (standard är originalnamnet)

moveFileOrFolderInMyOnedrive

Flyttar en fil eller mapp (DriveItem) till en destinationsmapp inom användarens OneDrive. Denna åtgärd är asynkron. Använd checkOperationStatusInMyOnedrive för att övervaka förloppet.

Obligatoriska parametrar:

• sourcefileid: ID för källfilen eller mappen (DriveItem) som ska flyttas
• destfolderid: ID för destinationsmappen (måste finnas i användarens OneDrive)

Valfria parametrar:

• newfilename: Nytt namn för det flyttade objektet (standard är originalnamnet)

checkOperationStatusInMyOnedrive

Kontrollerar statusen för en asynkron åtgärd, såsom kopiering eller flytt, genom att använda operationstoken som returneras från den ursprungliga åtgärden. Returnerar statusuppdateringar om processen fortfarande pågår, feldetaljer om den misslyckades, eller slutlig metadata för fil eller mapp om den har slutförts framgångsrikt.

Obligatoriska parametrar:

• operationToken: Operationstoken som returnerats från en asynkron åtgärd som copyFileOrFolderInMyOnedrive eller moveFileOrFolderInMyOnedrive

Viktiga funktioner

OneDrive-hantering

• Hämtar OneDrive-information, såsom kvot och ägare
• Få åtkomst till användarens personliga OneDrive
• Alla åtgärder utförs på den autentiserade användarens OneDrive.

Filsökning och identifiering

• Sök filer och mappar efter namn inom användarens OneDrive
• Hämta fil- eller mappmetadata med hjälp av ID eller delnings-URL
• Bläddra i mappens innehåll (upp till 20 objekt)

Filåtgärder

• Skapa text- och binärfiler (≤5 MB)
• Läs text och binärfiler (≤5 MB)
• Radera filer med samtidighetskontroll
• Byt namn på filer med eTag-skydd
• Kopiera och flytta filer och mappar asynkront

Mapphantering

• Skapa mappar med valfria föräldrasökvägar
• Automatiskt numeriskt suffix för mappar med samma namn
• Lista mappens innehåll (upp till 20 objekt)
• Hämta metadata för mapp
• Ta bort mappar med samtidighetskontroll
• Byt namn på mappar med eTag-skydd

Delning och behörigheter

• Dela filer och mappar med användare
• Rollbaserad åtkomstkontroll (läsa, skriva)
• 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

• Alla åtgärder riktar sig mot den autentiserade användarens personliga OneDrive.
• Filåtgärder är begränsade till filer som är 5 MB eller mindre för uppladdning och nedladdning.
• Raderingsåtgärder och namnbytesåtgärder stöder eTags för samtidighetskontroll.
• Delning kräver giltiga e-postadresser och lämpliga behörigheter.
• Känslighetsetiketter kräver korrekt licensiering och konfiguration.
• Mapplistning returnerar maximalt 20 objekt som standard.