OneDrive

OneDrive é o serviço de armazenamento em nuvem e sincronização de arquivos da Microsoft que permite aos usuários armazenar, acessar e compartilhar arquivos com segurança entre dispositivos. Integrado profundamente ao ecossistema Microsoft 365, o OneDrive oferece colaboração fluida, controle de versão e acesso em tempo real ao conteúdo em equipes e organizações.

Saiba como integrar a ferramenta OneDrive no Zoen para puxar, gerenciar e organizar automaticamente seus arquivos na nuvem dentro dos seus fluxos de trabalho. Este tutorial mostra como conectar o OneDrive, configurar o acesso a arquivos e usar o conteúdo armazenado para alimentar automações. Ideal para sincronizar documentos e mídias essenciais com seus agentes em tempo real.

Com o OneDrive, você pode:

  • Armazenar arquivos com segurança na nuvem: Enviar e acessar documentos, imagens e outros arquivos de qualquer dispositivo
  • Organizar seu conteúdo: Criar pastas estruturadas e gerenciar versões de arquivos com facilidade
  • Colaborar em tempo real: Compartilhar arquivos, editá-los simultaneamente com outras pessoas e acompanhar mudanças
  • Acessar em vários dispositivos: Usar o OneDrive em desktop, mobile e plataformas web
  • Integrar com o Microsoft 365: Trabalhar de forma fluida com Word, Excel, PowerPoint e Teams
  • Controlar permissões: Compartilhar arquivos e pastas com configurações de acesso personalizadas e controles de expiração

No Zoen, a integração OneDrive permite que seus agentes interajam diretamente com seu armazenamento na nuvem. Os agentes podem enviar novos arquivos para pastas específicas, recuperar e ler arquivos existentes e listar o conteúdo de pastas para organizar e acessar informações dinamicamente. Esta integração permite que seus agentes incorporem operações de arquivo em fluxos de trabalho inteligentes — automatizando a entrada de documentos, análise de conteúdo e gerenciamento estruturado de armazenamento. Ao conectar o Zoen ao OneDrive, você capacita seus agentes a gerenciar e usar documentos na nuvem de forma programática, eliminando etapas manuais e aprimorando a automação com acesso seguro a arquivos em tempo real.

Usage Instructions

Integrate OneDrive into the workflow. Can create text and Excel files, upload files, download files, list and search files, move or rename files, copy files, create sharing links, and delete files or folders.

Actions

onedrive_upload

Upload a file to OneDrive

Input

ParameterTypeRequiredDescription
fileNamestringYesThe name of the file to upload (e.g., "report.pdf", "data.xlsx")
filefileNoThe file to upload (binary)
contentstringNoThe text content to upload (if no file is provided)
mimeTypestringNoThe MIME type of the file to create (e.g., text/plain for .txt, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet for .xlsx)
folderIdstringNoFolder ID to upload the file to (e.g., "01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36M")

Output

ParameterTypeDescription
successbooleanWhether the file was uploaded successfully
fileobjectThe uploaded file object with metadata including id, name, webViewLink, webContentLink, and timestamps

onedrive_create_folder

Create a new folder in OneDrive

Input

ParameterTypeRequiredDescription
folderNamestringYesName of the folder to create (e.g., "My Documents", "Project Files")
folderIdstringNoParent folder ID to create the folder in (e.g., "01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36M")

Output

ParameterTypeDescription
successbooleanWhether the folder was created successfully
fileobjectThe created folder object with metadata including id, name, webViewLink, and timestamps

onedrive_download

Download a file from OneDrive

Input

ParameterTypeRequiredDescription
fileIdstringYesThe ID of the file to download (e.g., "01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36M")
fileNamestringNoOptional filename override (e.g., "report.pdf", "data.xlsx")

Output

ParameterTypeDescription
filefileDownloaded file stored in execution files

onedrive_list

List files and folders in OneDrive

Input

ParameterTypeRequiredDescription
folderIdstringNoFolder ID to list files from (e.g., "01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36M")
querystringNoFilter files by name prefix (e.g., "report", "invoice_2024")
pageSizenumberNoMaximum number of files to return (e.g., 10, 50, 100)
pageTokenstringNoContinuation URL from a previous response's nextPageToken, used to fetch the next page

Output

ParameterTypeDescription
successbooleanWhether files were listed successfully
filesarrayArray of file and folder objects with metadata
nextPageTokenstringToken for retrieving the next page of results (optional)

Search for files and folders across OneDrive by name, metadata, or content (recursive)

Input

ParameterTypeRequiredDescription
querystringNoSearch text matched against file name, metadata, and content. Not required when paginating with pageToken
pageSizenumberNoMaximum number of results to return (e.g., 10, 50, 100)
pageTokenstringNoContinuation URL from a previous response's nextPageToken, used to fetch the next page

Output

ParameterTypeDescription
successbooleanWhether the search completed successfully
filesarrayArray of file and folder objects matching the search query
nextPageTokenstringToken for retrieving the next page of results (optional)

onedrive_get_item

Get metadata for a specific OneDrive file or folder by ID, or the drive root

Input

ParameterTypeRequiredDescription
fileIdstringNoThe ID of the file or folder to retrieve (e.g., "01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36M"). Leave empty to get the drive root folder

Output

ParameterTypeDescription
successbooleanWhether the item metadata was retrieved
fileobjectThe file or folder metadata, including id, name, webViewLink, size, and timestamps

onedrive_get_drive_info

Get information about the OneDrive drive, including storage quota

Input

ParameterTypeRequiredDescription

Output

ParameterTypeDescription
successbooleanWhether the drive info was retrieved
driveIdstringThe ID of the drive
driveTypestringThe type of drive (e.g., "personal", "business")
webUrlstringURL to the drive in the browser
ownerstringDisplay name of the drive owner
quotaobjectStorage quota information in bytes (total, used, remaining, deleted, state)

onedrive_move

Move a file or folder to a new parent folder, rename it, or both

Input

ParameterTypeRequiredDescription
fileIdstringYesThe ID of the file or folder to move or rename
destinationFolderIdstringNoThe ID of the destination parent folder (omit to only rename in place)
newNamestringNoThe new name for the file or folder (omit to only move)

Output

ParameterTypeDescription
successbooleanWhether the move or rename was successful
fileobjectThe updated file object with its new name and/or parent folder

onedrive_copy

Copy a file or folder to another location within OneDrive

Input

ParameterTypeRequiredDescription
fileIdstringYesThe ID of the file or folder to copy
destinationFolderIdstringYesThe ID of the destination parent folder
destinationFileNamestringNoOptional new name for the copy (defaults to the original name)

Output

ParameterTypeDescription
successbooleanWhether the copy request was accepted
sourceFileIdstringThe ID of the file or folder that was copied
namestringThe requested name for the copy, if provided
monitorUrlstringURL to poll for the status of the asynchronous copy operation (copy completes in the background)

Create a view or edit sharing link for a OneDrive file or folder

Input

ParameterTypeRequiredDescription
fileIdstringYesThe ID of the file or folder to share
linkTypestringNoType of link to create: "view" (read-only), "edit" (read-write), or "embed"
linkScopestringNoWho can use the link: "anonymous" (anyone), "organization" (tenant members), or "users" (specific people)

Output

ParameterTypeDescription
successbooleanWhether the sharing link was created successfully
linkobjectThe created sharing link, including its type, scope, and URL

onedrive_delete

Delete a file or folder from OneDrive

Input

ParameterTypeRequiredDescription
fileIdstringYesThe ID of the file or folder to delete (e.g., "01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36M")

Output

ParameterTypeDescription
successbooleanWhether the file was deleted successfully
deletedbooleanConfirmation that the file was deleted
fileIdstringThe ID of the deleted file

On this page