Skip to main content

Documentation Index

Fetch the complete documentation index at: https://relevanceai.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Connect your Google Drive account to Relevance AI and configure your Agents to respond automatically when files change, or give them tool steps to read, create, and manage files directly in Drive.
The Google Drive trigger is currently rolling out in early access. If you don’t see it in your account yet, it will become available soon.

​
Connect the integration

  1. Navigate to the “Integrations & API Keys” page in the sidebar of your Relevance AI dashboard.
  2. Click on “Google Drive” from the available integrations.
  3. Click the + Connect account button.
  4. In the pop-up window, sign into your Google account and authorize the connection.
  5. Once authorized, your Google account will appear in the connected accounts list.

​
Setting up triggers

The Google Drive integration lets you trigger Agents automatically when files in a Google Drive change. The trigger fires on every change within the drive (or folders) you watch — created, modified, trashed, or removed — and the event type is included in the message your Agent receives.

​
What fires the trigger

A Google Drive trigger fires on each of the following events within the drive or folders you’ve selected:
  • File created — a new file is added
  • File modified — an existing file is updated
  • File deleted — a file is moved to trash or permanently removed
Each Google Drive file gets its own ongoing conversation. When the same file changes again, your Agent picks up where it left off rather than starting a new conversation — so it has the full history for each file.

​
How to set up a Google Drive trigger

The setup process differs slightly depending on whether you’re configuring a trigger for an Agent or a Workforce.

​
For Agents

  1. Open the Agent you want to configure in the Agent builder.
  2. In the left sidebar, click the “Triggers” section.
  3. Click + Add trigger and select “Google Drive” from the trigger types.
  4. Choose the connected Google account you want to use. If you haven’t connected one yet, set it up first in the Integrations & API Keys page.
  5. Select a Drive — defaults to “My Drive”, or pick any shared drive you have access to.
  6. Optionally, select one or more Folders to restrict the watch to only those folders. Leave empty to watch the entire drive.
  7. Optionally, enable Watch for file property changes to also trigger on changes to custom file properties (not just content changes).
  8. Save the trigger.

​
For Workforces

  1. Open the Workforce you want to configure in the Workforce builder.
  2. From the node tray at the bottom of the screen, drag a trigger node onto the canvas.
  3. Click the trigger node to open its configuration panel on the left, then select “Google Drive” as the trigger type.
  4. Choose the connected Google account you want to use. If you haven’t connected one yet, set it up first in the Integrations & API Keys page.
  5. Select a Drive — defaults to “My Drive”, or pick any shared drive you have access to.
  6. Optionally, select one or more Folders to restrict the watch.
  7. Optionally, enable Watch for file property changes.
  8. Drag a connection line from the trigger node to the Agent that should respond when the trigger fires.

​
Tool steps

Beyond triggers, the Google Drive integration provides pre-built tool steps your Agents can use to read, create, and manage files in Drive. Add these in the Tool builder by searching “Google Drive” in the tool-step picker.

​
File operations

  • Google Drive: Upload File — upload a file to Google Drive
  • Google Drive: Download File — download a file from Google Drive (specify a MIME type to export Google Workspace files like Docs, Sheets, or Slides)
  • Google Drive: Create File from Text — create a new file from plain text
  • Google Drive: Create File from Template — create a new Google Doc from a template, replacing placeholders
  • Google Drive: Update File — update a file’s metadata or content
  • Google Drive: Copy File — duplicate a file
  • Google Drive: Move File — move a file from one folder to another
  • Google Drive: Move to Trash — send a file or folder to trash
  • Google Drive: Delete File — permanently delete a file or folder

​
Search and discovery

  • Google Drive: List Files — list files from a specific folder
  • Google Drive: Find File — search for a file by name
  • Google Drive: Find Folder — search for a folder by name
  • Google Drive: Find Forms — list or search Google Form documents
  • Google Drive: Find Spreadsheets — search for Google Sheets by name
  • Google Drive: Get File by ID — fetch file metadata by ID
  • Google Drive: Get Folder ID for Path — resolve a folder path to its ID

​
Folders

  • Google Drive: Create Folder — create a new empty folder

​
Shared drives

  • Google Drive: Create Shared Drive — create a new shared drive
  • Google Drive: Get Shared Drive — fetch metadata for a shared drive
  • Google Drive: Search Shared Drives — search for shared drives
  • Google Drive: Update Shared Drive — update an existing shared drive
  • Google Drive: Delete Shared Drive — delete an empty shared drive

​
Sharing and permissions

  • Google Drive: Share File or Folder — add a sharing permission and return a sharing URL
  • Google Drive: List Access Proposals — list pending requests for access to a file or folder
  • Google Drive: Resolve Access Proposal — accept or deny a request for access

​
Use the Google Drive API tool step (advanced)

For actions that aren’t covered by a dedicated tool step, the Google Drive API call tool step lets your Agent make authorized requests directly to the Google Drive API.
  1. Create a new Tool in Relevance AI.
  2. Scroll to the Tool steps section.
  3. Add the Google Drive API call tool step.
  4. Select your connected Google account in the dropdown.
  5. Configure the request — endpoint, method, parameters, and body — based on the Google Drive API reference.

​
Frequently asked questions (FAQs)

Triggers fire your Agent automatically when files in Google Drive change — created, modified, or deleted. A Knowledge source gives your Agent read access to specific files so it can reference them during a conversation. You can use both together: a trigger to start the conversation, and a Knowledge source to give the Agent ongoing context.
Both. The trigger config supports selecting either My Drive or any shared drive you have access to, and the tool steps include a full set of shared-drive actions for creating, searching, and updating shared drives.
Yes. Connect each account in the Integrations & API Keys page, then choose which connected account each trigger or tool step uses.
Both work. Sign in with whichever account has access to the files or folders you want your Agent to watch or act on.

​
Google Drive as a Knowledge source

You can also use Google Drive as a Knowledge source, giving your Agents direct read access to files for retrieval and reference. Learn more about Google Drive as a Knowledge source.