mirror of
https://github.com/crewAIInc/crewAI.git
synced 2025-12-16 04:18:35 +00:00
bf9e0423f2
Some checks failed
* WIP: v1 docs (#3626) (cherry picked from commit d46e20fa09bcd2f5916282f5553ddeb7183bd92c) * docs: parity for all translations * docs: full name of acronym AMP * docs: fix lingering unused code * docs: expand contextual options in docs.json * docs: add contextual action to request feature on GitHub * chore: tidy docs formatting
54 lines
1.8 KiB
Plaintext
54 lines
1.8 KiB
Plaintext
---
|
|
title: "OneDrive Trigger"
|
|
description: "Automate responses to OneDrive file activity"
|
|
icon: "cloud"
|
|
mode: "wide"
|
|
---
|
|
|
|
## Overview
|
|
|
|
Start automations when files change inside OneDrive. You can generate audit summaries, notify security teams about external sharing, or update downstream line-of-business systems with new document metadata.
|
|
|
|
<Tip>
|
|
Connect OneDrive in **Tools & Integrations** and toggle the trigger on for your deployment.
|
|
</Tip>
|
|
|
|
## Enabling the OneDrive Trigger
|
|
|
|
1. Open your deployment in CrewAI AMP
|
|
2. Go to the **Triggers** tab
|
|
3. Locate **OneDrive** and switch the toggle to enable
|
|
|
|
<Frame caption="Microsoft OneDrive trigger connection">
|
|
<img src="/images/enterprise/onedrive-trigger.png" alt="Enable or disable triggers with toggle" />
|
|
</Frame>
|
|
|
|
## Example: Audit file permissions
|
|
|
|
```python
|
|
from onedrive_file_crew import OneDriveFileTrigger
|
|
|
|
crew = OneDriveFileTrigger().crew()
|
|
crew.kickoff({
|
|
"crewai_trigger_payload": onedrive_payload,
|
|
})
|
|
```
|
|
|
|
The crew inspects file metadata, user activity, and permission changes to produce a compliance-friendly summary.
|
|
|
|
## Sample payloads & crews
|
|
|
|
The [OneDrive examples](https://github.com/crewAIInc/crewai-enterprise-trigger-examples/tree/main/onedrive) showcase how to:
|
|
|
|
- Parse file metadata, size, and folder paths
|
|
- Track who created and last modified the file
|
|
- Highlight permission and external sharing changes
|
|
|
|
`onedrive-file-crew.py` bundles the analysis and summarization tasks so you can add remediation steps as needed.
|
|
|
|
## Troubleshooting
|
|
|
|
- Ensure the connected account has permission to read the file metadata included in the webhook
|
|
- If the trigger fires but the payload is missing `permissions`, confirm the site-level sharing settings allow Graph to return this field
|
|
- For large tenants, filter notifications upstream so the crew only runs on relevant directories
|