Google Drive Folder Sync

Sync a Google Drive folder into the Knowledge Hub so your agents always work from up-to-date documents.

Folder Sync lets you connect a Google Drive folder to the Knowledge Hub. Odeus keeps the folder synchronized in the background, so the indexed content stays current as files in Drive change. This goes beyond attaching individual files — you can work with a whole folder while Odeus handles re-indexing for you.

Folder Sync requires the Google Drive integration to be connected. Contact your admin if it is not available in your workspace.

Microsoft 365 / SharePoint is browse-only, not synced. You can browse and read SharePoint and OneDrive files live through the Microsoft 365 connector, but those sources are not ingested into the Knowledge Hub via Folder Sync. Only Google Drive is a sync source today. OneDrive and Dropbox sync are not available.

How Folder Sync Works

Unlike direct file attachments that send entire documents to the model, a synced folder is ingested into the Knowledge Hub and retrieved with semantic search. Only the most relevant passages are returned to the model, so you can work with large collections while staying within the model's context window. Retrieved passages come back with inline citations (file, page, and location).

* **Processing method**: Semantic search retrieves the relevant passages
* **Best for**: Large document collections, FAQ agents, department knowledge bases
* **Updates**: Automatic background synchronization
* **Context**: Only relevant passages are sent to the model, with citations



* **Processing method**: Entire documents are made available to the model
* **Best for**: Small, frequently referenced documents
* **Updates**: Manual re-upload required
* **Context**: Complete documents available to the model

Setting Up Folder Sync

Make sure your Google Drive account is connected in your integrations. You will use this connection to authorize the folder.



In the Library, create a folder for the content, then choose to link a Google Drive folder to it.



Search for and select the Google Drive folder you want to sync. Odeus begins the initial ingestion in the background.



Add the folder to an agent's Knowledge or attach it as an action so the agent can search it. You can also @-mention the folder in chat.

> Once the initial sync completes, the folder is searchable by your agents and in chat.

Supported File Types

The Knowledge Hub ingests a broad set of document types, including:

• PDF (with layout extraction and OCR, including Arabic)
• Word (DOC, DOCX)
• Excel (XLS, XLSX) and CSV
• PowerPoint (PPT, PPTX)
• Plain text and Markdown (TXT, MD)
• HTML
• Images

The per-file size limit is 50 MB.

Sync Behavior and Timing

Automatic Updates

Synced folders refresh automatically in the background so agents have access to the latest versions. The sync:

• Detects newly added files
• Re-indexes files that have been modified
• Removes files that have been deleted from the source folder

Initial Sync Duration

The first synchronization can take a while depending on folder size and file complexity. Subsequent updates only process what changed and are typically much faster.

During the initial sync, Odeus downloads each file, processes it (including OCR and chunking where applicable), and builds the searchable index.

Connection Ownership and User Removal

When you sync a Google Drive folder, Odeus uses your personal Google OAuth connection to authenticate and read the files. This connection is tied to your user account.

If the user who originally connected the folder is removed from the Odeus workspace, syncing will stop. Already-indexed files remain available, but updates will no longer occur.

How to Restore Syncing

Open the Knowledge Hub folder and remove the link that is no longer syncing.



Have another user with access to the same Drive folder re-link it.



The new user's Google connection will be used for all future synchronization.

For business-critical agents, make sure more than one team member has access to the source Drive folder so syncing survives if the original connector leaves.

Troubleshooting Common Issues

**Possible causes**: Google Drive not connected, insufficient permissions on the folder, or the initial sync is still running.

**Solutions**: Verify your Google Drive connection is active, check folder permissions in Drive, and wait for the initial sync to finish.



**Possible causes**: An unsupported file type, a file over the 50 MB limit, or a sync still in progress.

**Solutions**: Confirm the file type is supported, reduce file size if needed, and wait for the sync to complete.



**Cause**: The user who connected the folder was removed from Odeus, so their Google OAuth connection — used to refresh the sync — was deleted.

**Solutions**: Remove the folder link, have another user with Drive access re-link the folder, and the new connection will be used going forward.

Start with your most frequently accessed, well-organized Drive folders for the best initial experience.