OneDrive-referens (förhandsgranskning)

Note

Denna artikel beskriver funktioner i agenter eller agentflöden som använder standard harness.

Important

Det här är en förhandsgranskningsfunktion.

• Microsoft släpper förhandsversionsfunktioner före en officiell version så att kunderna kan få tidig åtkomst och ge feedback.
• Förhandsgranskningsfunktioner har begränsade funktioner och är inte avsedda för produktionsanvändning.
• Microsoft kan ändra mcp-verktygsnamn och parametrar för förhandsversionen. Undvik hårdkodade beroenden. Microsoft underhåller scenariostöd.
• Förhandsgranskningsfunktioner omfattas av Microsoft kompletterande användningsvillkor.

Overview

Server-ID	URL på klientorganisationsnivå	Visningsnamn	Description
mcp_OneDriveRemoteServer	https://agent365.svc.cloud.microsoft/ agents/tenants/{tenantId}/servers/ mcp_OneDriveRemoteServer	OneDrive	Verktyg för OneDrive-operationer. Använd den här servern för att hantera filer och mappar i användarens personliga OneDrive. Alla filåtgärder som är begränsade till ≤5MB.

Tillgängliga verktyg

Hämta OneDrive

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

Inga parametrar krävs.

getFolderChildrenInMyOnedrive

Räknar upp de 20 främsta filerna och mapparna (DriveItems) som finns i en angiven överordnad mapp i användarens OneDrive.

Valfria parametrar:

• parentFolderId: ID för den överordnade mappen vars filer och mappar du vill lista (standard: "root")

findFileOrFolderInMyOnedrive

Söker efter en fil eller mapp (DriveItem) i användarens OneDrive efter sökfråga. Den här metoden är effektivare än att söka i alla tillgängliga filer om du vet att objektet finns i användarens OneDrive.

Obligatoriska parametrar:

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

hämta metadata för fil eller mapp i min OneDrive

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 för att få åtkomst till filen kan hämta metadata.

Obligatoriska parametrar:

• fileOrFolderUrl: URL för filen eller mappen. URL:en löses inte in för att dela den med användaren. de måste redan ha uttrycklig åtkomst.

readSmallTextFileFromMyOnedrive

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

Obligatoriska parametrar:

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

createSmallTextFileInMyOnedrive

Skapar eller laddar upp en textfil som är mindre än 5 MB till användarens OneDrive.

Obligatoriska parametrar:

• Filnamn: Namnet på filen som ska skapas
• innehållText: Textinnehållet i filen.

Valfria parametrar:

• parentFolderId: ID för föräldramappen (standard: 'root').

createFolderInMyOnedrive

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

Obligatoriska parametrar:

• Mappnamn: Namnet på mappen som ska skapas

Valfria parametrar:

• parentFolderId: ID för föräldramappen (standard: 'root').

bytNamnPåFilEllerMappIMinOneDrive

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

Obligatoriska parametrar:

• fileOrFolderId: ID för filen eller mappen som ska byta namn
• newFileOrFolderName: Det nya namnet på filen eller mappen

Valfria parametrar:

• Etag: ETag-värde för samtidighetskontroll. Åtgärden lyckas endast om DriveItem-objektets aktuella ETag stämmer överens med

Ta bort fil eller mapp i Min OneDrive

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

Dela fil eller mapp i min OneDrive

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

Obligatoriska parametrar:

• fileOrFolderId: ID för den fil eller mapp som ska delas
• recipientEmails: Matris med e-postadresser till mottagare som ska bjudas in
• Roller: Matris med roller som ska tilldelas. Godkända värden: "read", "write" (skriv ger både läs- och skrivbehörighet)

Valfria parametrar:

• Meddelande: Anpassat meddelande som ska inkluderas i e-postmeddelandet för inbjudan. Standard: "Här är filen som vi samarbetar med."
• sendInvitation: Om du vill skicka en delningsinbjudan. Standard: sant.

angeKänslighetsetikettPåFilIMinOneDrive

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

Obligatoriska parametrar:

• Fileid: ID för filen (DriveItem)
• sensitivityLabelId: ID för känslighetsetiketten som ska tilldelas eller tom sträng att ta bort

Valfria parametrar:

• assignmentMethod: Tilldelningsmetod: "standard", "privileged", "auto" eller "unknownFutureValue" (standardvärde: "privileged")
• justificationText: Motiveringstext för granskningsändamål. krävs vid nedgradering eller borttagning av en etikett (standard: "Ändrat av MCPServer")

skapa en liten binärfil i min OneDrive

Skapar en binär fil med en storlek som är mindre än 5 MB genom att base64-koda dess innehåll till användarens OneDrive.

Obligatoriska parametrar:

• Filnamn: Namnet på filen som ska skapas, inklusive filnamnstillägget
• base64Content: Det binära filinnehållet som kodas som en base64-sträng

Valfria parametrar:

• parentFolderId: ID för föräldramappen (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 ned

Kopiera fil eller mapp i min OneDrive

Kopierar en fil eller mapp (DriveItem) till en målmapp i användarens OneDrive. Den här åtgärden ä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 målmappen (måste finnas i användarens OneDrive)

Valfria parametrar:

• newfilename: Nytt namn på det kopierade objektet (standardvärdet är det ursprungliga namnet)

moveFileOrFolderInMyOnedrive

Flyttar en fil eller mapp (DriveItem) till en målmapp i användarens OneDrive. Den här åtgärden ä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 målmappen (måste finnas i användarens OneDrive)

Valfria parametrar:

• newfilename: Nytt namn för det flyttade objektet (standardvärdet är det ursprungliga namnet)

kontrolleraÅtgärdsstatusIMinOneDrive

Kontrollerar statusen för en asynkron åtgärd, till exempel kopiera eller flytta, med hjälp av åtgärdstoken som returnerades från den ursprungliga åtgärden. Returnerar förloppsinformation om den fortfarande pågår, felinformation om den misslyckas eller den slutliga filen eller mappmetadata om den har slutförts.

Obligatoriska parametrar:

• operationToken: Åtgärdstoken som returneras från en asynkron åtgärd som copyFileOrFolderInMyOnedrive eller moveFileOrFolderInMyOnedrive

Centrala egenskaper

OneDrive hantering

• Hämtar OneDrive information, till exempel kvot och ägare
• Åtkomst till användarens personliga OneDrive
• Alla åtgärder riktar sig mot autentiserade användares OneDrive

Filsökning och identifiering

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

Filåtgärder

• Skapa text och binära filer (≤5 MB)
• Läsa text och binära filer (≤5 MB)
• Ta bort filer med samtidighetskontroll
• Byt namn på filer med eTag-skydd
• Kopiera och flytta filer och mappar asynkront

Mapphantering

• Skapa mappar med valfria överliggande sökvägar
• Automatiskt numeriskt suffix för duplicerade mappnamn.
• Lista mappinnehåll (upp till 20 objekt)
• Hämta mappmetadata
• 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-postnotiser för delning.
• Anpassade meddelanden i inbjudningar.

Säkerhet och efterlevnad

• Använd och ta bort känslighetsetiketter.
• Använd flera tilldelningsmetoder, inklusive standard, privilegierad och automatisk.
• Stöd för granskningsmotivering.
• Använd samtidighetskontroll med eTags.

Notes

• Alla åtgärder riktar sig till 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.
• Åtgärderna för att ta bort och byta namn 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.
• Mapplistan returnerar som standard högst 20 objekt.