> ## Documentation Index
> Fetch the complete documentation index at: https://docs.duckie.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Drive

> Sync Google Drive documents to your Duckie knowledge base

Connect Google Drive to sync documents, sheets, and slides as knowledge for your agents.

## Capabilities

| Capability             | Supported                |
| ---------------------- | ------------------------ |
| **Knowledge Source**   | ✓ Sync files and folders |
| **Deployment Trigger** | ✗                        |
| **Tool Actions**       | ✗                        |

## Setup

### Connect via OAuth

1. Go to **Settings → Connections** in Duckie
2. Find **Google Drive** and click **Connect**
3. Sign in with your Google account
4. Grant Duckie read access to Drive
5. You'll be redirected back to Duckie

<Info>
  Duckie requests read-only access to your Google Drive files.
</Info>

## Selecting Content to Sync

After connecting:

1. Go to **Train → Knowledge**
2. Click **Add Source**
3. Select **Google Drive**
4. Browse and select folders or files
5. Click **Start Sync**

### Supported File Types

| File Type             | How It's Processed          |
| --------------------- | --------------------------- |
| **Google Docs**       | Full text content extracted |
| **Google Sheets**     | Data converted to text      |
| **Google Slides**     | Text from slides extracted  |
| **PDFs**              | Text extracted via OCR      |
| **Word docs (.docx)** | Text content extracted      |
| **Text files**        | Direct content              |

### What Doesn't Sync

* Images (unless they contain text via OCR)
* Videos
* Audio files
* Binary files

## Best Practices

### Create a Dedicated Folder

Organize knowledge content in a dedicated folder:

```
📁 Duckie Knowledge
  ├── 📁 Product Docs
  │   ├── User Guide.gdoc
  │   └── API Reference.gdoc
  ├── 📁 Support Materials
  │   ├── FAQs.gdoc
  │   └── Troubleshooting.gdoc
  └── 📁 Policies
      ├── Refund Policy.gdoc
      └── Terms of Service.gdoc
```

### Use Google Docs for Easy Updates

Google Docs are ideal because:

* Easy to edit and update
* Changes sync automatically
* Team collaboration built-in

### Leverage Shared Drives

For team knowledge, use Shared Drives:

* Content persists even if employees leave
* Clear ownership and permissions
* Better organization

## Sync Behavior

* **Automatic sync**: Files checked for updates periodically
* **Folder recursion**: Subfolders are included
* **Permission-based**: Only files you can access are synced

## Example Use Cases

### Product Documentation

Sync your product documentation folder so agents can answer product questions.

### Policy Documents

Sync HR policies, terms of service, and legal documents for accurate policy-related responses.

### Training Materials

Sync onboarding and training docs to help answer procedural questions.

## Troubleshooting

### "File not syncing"

* Verify you have access to the file
* Check that the file type is supported
* Ensure the file isn't in trash

### "Content seems outdated"

* Click **Sync Now** to force refresh
* Check when the source was last synced

### "Cannot connect Google account"

* Try signing out and back into Google
* Clear browser cookies and try again
* Ensure you're using the correct Google account