Odkaz na OneDrive (náhled)

Note

Tento článek popisuje funkce používané v agentech nebo tocích agentů využívajících standardní harness.

Important

Toto je funkce Preview.

• Microsoft uvolňuje funkce ve verzi Preview před oficiálním vydáním, aby k nim zákazníci mohli získat předběžný přístup a poskytnout zpětnou vazbu.
• Funkce ve verzi Preview mají omezené funkce a nejsou určené pro produkční použití.
• Microsoft můžou změnit názvy a parametry nástrojů MCP ve verzi Preview. Vyhněte se pevně zakódovaným závislostem. Microsoft udržuje podporu scénářů.
• Funkce ve verzi Preview podléhají Microsoft dodatečným podmínkám použití.

Přehled

ID serveru	Adresa URL na úrovni tenanta	Zobrazované jméno	Description
mcp_OneDriveRemoteServer	https://agent365.svc.cloud.microsoft/ agents/tenants/{tenantId}/servers/ mcp_OneDriveRemoteServer	OneDrive	Nástroje pro operace na OneDrive. Tento server slouží ke správě souborů a složek v osobních OneDrive uživatele. Všechny operace se soubory omezené na ≤5 MB.

Dostupné nástroje

getOnedrive

Získá informace o OneDrivu uživatele, včetně metadat úložiště, kvóty a informací o majiteli.

Nejsou vyžadovány žádné parametry.

getFolderChildrenInMyOnedrive

Vytvoří výčet 20 nejlepších souborů a složek (DriveItems) obsažených v zadané nadřazené složce v OneDrive uživatele.

Volitelné parametry:

• parentFolderId: ID nadřazené složky, jejíž soubory a složky chcete zobrazit (výchozí hodnota: root)

najít soubor nebo složku na mém OneDrivu

Vyhledá soubor nebo složku (DriveItem) v OneDrive uživatele pomocí vyhledávacího dotazu. Tato metoda je efektivnější než vyhledávání všech přístupných souborů, pokud víte, že položka je v OneDrive uživatele.

Požadované parametry:

• searchQuery: Vyhledávací dotaz; může být celý nebo částečný název souboru.

Získat metadata souboru nebo složky v mém OneDrivu

Získá metadata souboru nebo složky (DriveItem) z OneDrive uživatele.

Požadované parametry:

• fileOrFolderId: ID souboru nebo složky v OneDrive uživatele

getFileOrFolderMetadataByUrl

Získá metadata souboru nebo složky (DriveItem) ze sdílené adresy URL. Metadata můžou získat jenom uživatelé s existujícími explicitními oprávněními pro přístup k souboru.

Požadované parametry:

• fileOrFolderUrl: Adresa URL souboru nebo složky Adresa URL není využita ke sdílení s uživatelem, uživatel již musí mít výslovný přístup.

readSmallTextFileFromMyOnedrive

Přečte (stáhne) textový soubor z OneDrive uživatele.

Požadované parametry:

• fileId: ID souboru (DriveItem) ke čtení nebo stažení

vytvořit malý textový soubor v mém OneDrivu

Vytvoří nebo nahraje textový soubor menší než 5 MB do OneDrive uživatele.

Požadované parametry:

• Název_souboru: Název souboru, který se má vytvořit
• obsahText: Textový obsah souboru.

Volitelné parametry:

• parentFolderId: ID nadřazené složky (výchozí: 'root').

vytvořitSložkuVMémOneDrivu

Vytvoří novou složku (DriveItem) na uživatelském OneDrivu jako podřízenou položku určené nadřazené složky. Pokud složka se stejným názvem již existuje, metoda přidá číselnou příponu (například NewFolder (1)).

Požadované parametry:

• Název_složky: Název složky, která se má vytvořit

Volitelné parametry:

• parentFolderId: ID nadřazené složky (výchozí: 'root').

renameFileOrFolderInMyOnedrive

Přejmenuje soubor nebo složku (DriveItem) v OneDrive uživatele. Nový název musí splňovat zásady vytváření názvů.

Požadované parametry:

• fileOrFolderId: ID souboru nebo složky k přejmenování
• newFileOrFolderName: Nový název souboru nebo složky

Volitelné parametry:

• Etag: Hodnota ETag pro řízení souběžnosti Operace je úspěšná pouze pokud aktuální hodnota ETag položky DriveItem odpovídá.

odstranit soubor nebo složku v mém OneDrivu

Odstraní soubor nebo složku (DriveItem) z OneDrive uživatele.

Požadované parametry:

• fileOrFolderId: ID souboru nebo složky k odstranění

Volitelné parametry:

• Etag: Hodnota ETag pro řízení souběžnosti

Sdílet soubor nebo složku na mém OneDrivu

Odešle pozvánku ke sdílení, která udělí oprávnění ke čtení nebo zápisu souboru nebo složky (DriveItem) v OneDrive uživatele.

Požadované parametry:

• fileOrFolderId: ID souboru nebo složky ke sdílení
• recipientEmails: Pole e-mailových adres příjemců k pozvání
• Role: Pole rolí, které se mají přiřadit Povolené hodnoty: 'read', 'write' ('write' zahrnuje čtení i zápis)

Volitelné parametry:

• zpráva: Vlastní zpráva, která se zahrne do e-mailu s pozvánkou. Výchozí: Tady je soubor, na kterém spolupracujeme.
• sendInvitation: Jestli chcete poslat pozvánku ke sdílení. Výchozí hodnota: true.

nastavitPopisekCitlivostiNaSouboruVMémOneDrivu

Nastaví popisek citlivosti souboru v OneDrive uživatele.

Požadované parametry:

• fileId: ID souboru (DriveItem)
• sensitivityLabelId: ID štítku citlivosti, který se má přiřadit, nebo prázdný řetězec pro odebrání

Volitelné parametry:

• assignmentMethod: Metoda přiřazení: "standard", "privileged", "auto" nebo "unknownFutureValue" (výchozí hodnota: privilegovaná)
• justificationText: Text odůvodnění pro účely auditu; vyžadováno při snížení úrovně nebo odebrání štítku (výchozí hodnota: 'Změnil MCPServer')

createSmallBinaryFileInMyOnedrive

Vytvoří binární soubor menší než 5 MB kódováním base64 jeho obsahu do OneDrive uživatele.

Požadované parametry:

• Název_souboru: Název souboru, který se má vytvořit, včetně přípony souboru
• base64Content: Obsah binárního souboru kódovaný jako řetězec base64

Volitelné parametry:

• parentFolderId: ID nadřazené složky (výchozí: 'root').

readSmallBinaryFileFromMyOnedrive

Načte binární soubor menší než 5 MB z OneDrive uživatele. Vrátí obsah souboru jako řetězec s kódováním base64.

Požadované parametry:

• fileId: ID souboru (DriveItem) ke čtení nebo stažení

copyFileOrFolderInMyOnedrive

Zkopíruje soubor nebo složku (DriveItem) do cílové složky v rámci OneDrive uživatele. Tato operace je asynchronní. Slouží checkOperationStatusInMyOnedrive k monitorování průběhu.

Požadované parametry:

• sourcefileid: ID zdrojového souboru nebo složky (DriveItem) ke zkopírování
• destfolderid: ID cílové složky (musí existovat v OneDrive uživatele)

Volitelné parametry:

• newfilename: Nový název zkopírované položky (výchozí hodnota je původní název)

moveFileOrFolderInMyOnedrive

Přesune soubor nebo složku (DriveItem) do cílové složky v rámci OneDrive uživatele. Tato operace je asynchronní. Slouží checkOperationStatusInMyOnedrive k monitorování průběhu.

Požadované parametry:

• sourcefileid: ID zdrojového souboru nebo složky (DriveItem) pro přesunutí
• destfolderid: ID cílové složky (musí existovat v OneDrive uživatele)

Volitelné parametry:

• newfilename: Nový název přesunuté položky (výchozí hodnota je původní název)

zkontrolovat stav operace na mém OneDrivu

Zkontroluje stav asynchronní operace, například kopírování nebo přesunutí, pomocí tokenu operace vráceného z původní operace. Vrátí informace o průběhu, pokud stále probíhá, podrobnosti o chybě, pokud selhal, nebo poslední metadata souboru nebo složky, pokud byla úspěšně dokončena.

Požadované parametry:

• operationToken: Token operace vrácený asynchronní operací, například copyFileOrFolderInMyOnedrive nebo moveFileOrFolderInMyOnedrive

Klíčové funkce

správa OneDrive

• Získá OneDrive informace, jako je například kvóta a vlastník.
• Přístup k osobním OneDrive uživatele
• Všechny operace cílí na OneDrive ověřeného uživatele.

Hledání a zjišťování souborů

• Hledání souborů a složek podle jména v OneDrive uživatele
• Získání metadat souborů nebo složek podle ID nebo adresy URL pro sdílení
• Prohledejte obsah složek (až 20 položek).

Operace se soubory

• Vytvoření textových a binárních souborů (≤5 MB)
• Čtení textových a binárních souborů (≤5 MB)
• Odstranění souborů pomocí řízení souběžnosti
• Přejmenování souborů pomocí ochrany eTag
• Asynchronní kopírování a přesouvání souborů a složek

Správa složek

• Vytváření složek s volitelnými nadřazenými cestami
• Automatická číselná přípona pro duplicitní názvy složek.
• Obsah složky seznamu (až 20 položek)
• Získání metadat složek
• Odstranit složky s řízením souběžnosti
• Přejmenování složek pomocí ochrany eTag

Sdílení a oprávnění

• Sdílení souborů a složek s uživateli
• Řízení přístupu na základě role (čtení, zápis)
• E-mailová upozornění ke sdílení.
• Vlastní zprávy v pozvánkách.

Zabezpečení a dodržování předpisů

• Použití a odebrání popisků citlivosti
• Použijte více metod přiřazení, včetně standardních, privilegovaných a automatických.
• Podpora odůvodnění auditu
• Používejte řízení souběhu pomocí značek eTag.

Poznámky

• Všechny operace cílí na osobní OneDrive ověřeného uživatele.
• Operace se soubory jsou omezené na soubory, které jsou 5 MB nebo méně pro nahrávání a stahování.
• Operace odstranění a přejmenování podporují značky eTag pro řízení souběžného přístupu.
• Sdílení vyžaduje platné e-mailové adresy a příslušná oprávnění.
• Popisky citlivosti vyžadují správné licencování a konfiguraci.
• Ve výchozím nastavení vrátí výpis složky maximálně 20 položek.