Skip to main content

Overview

The OneDrive Agent Node provides an intelligent agent for managing files in Microsoft OneDrive. This node enables you to:
  • List and search files across your OneDrive
  • Download files for processing
  • Upload files from workflows to OneDrive
  • Create folders and organize files
  • Move, copy, and delete files
  • Get detailed file metadata and properties

Configuration Parameters

To set up the OneDrive Agent Node, you need to authenticate with your Microsoft account. Once authenticated, configure the agent to perform operations based on your workflow requirements.

Node Configuration

  • Prompt: Define the task for the agent to perform with OneDrive.
    List all files in my OneDrive and download the most recent document
    Search for files containing “budget” in the name and move them to the Finance folder
    Create a folder called “Q4 Reports” and upload these files to it
  • Tools Select which tools the OneDrive Agent can use:
    Tool nameDescription
    List FilesList files in a folder
    Search FilesSearch for files by name or content
    Download FileDownload files for processing
    Upload File From ServiceUpload files to OneDrive
    Create FolderCreate new folders
    Get File MetadataGet detailed file information
    Move FileMove files to different folders
    Copy FileCopy files to different locations
    Delete FileRemove files or folders
    Be careful with Delete File - enable only when necessary
  • System Prompt: Customize the agent’s behavior and guidelines.
  • Model: Select the language model for the agent (must support function calling).
  • Max Steps: Set the maximum number of steps the agent can take (1-20).
  • Enable Model Fallbacks: Allow automatic fallback to alternative models if the primary model fails.

Expected Inputs and Outputs

  • Inputs:
    • The node accepts text input that can be referenced in the prompt using format strings.
  • Outputs:
    • output: The final result from the agent’s actions
    • conversation: Detailed log of the agent’s reasoning and operations

Use Case Examples

  1. Automated File Organization: Automatically organize uploaded files into appropriate OneDrive folders based on their content, type, or naming patterns.
  2. Document Processing Pipeline: Search for specific documents in OneDrive, download them for processing, and save results back to OneDrive.
  3. Backup and Archiving: Copy important files to archive folders or move old files to specific locations based on their age or metadata.

Error Handling and Troubleshooting

  • Authentication Issues: Ensure you’ve connected your Microsoft account and granted OneDrive permissions (Files.ReadWrite).
  • File Not Found: Verify that file IDs are still valid and files haven’t been moved or deleted since they were referenced.
  • Permission Errors: Check that your account has the necessary permissions to perform the requested operations on the files or folders.
If you encounter any issues not covered in this documentation, please reach out to our support team for assistance.

Relevant Nodes