Google Drive
Overview
Section titled “Overview”Connect Google Drive as a context source so Promptless reuses the specs, numbers, and rationale your team keeps in Google Docs, Sheets, and Slides. While Promptless drafts a suggestion, it can:
- Search files by name and full text across My Drive and shared drives.
- Read a file’s content: Google Docs as Markdown, Sheets as CSV, and Slides as plain text.
- Resolve Google Drive and Google Docs URLs that a trigger references. When a linked file isn’t accessible to the connected account but is publicly shared, Promptless reads it as a public web page.
Promptless reads only the files the connected Google account can read, and you can narrow that further. See Connect Google Drive and Limit Promptless to specific shared drives or folders.
Google Drive access is read-only. Promptless connects with read-only Drive scopes and never creates, updates, or deletes files. It queries Drive in real time when a documentation task needs it, and doesn’t store your Drive content. It caches results briefly during a documentation session, then discards them.
Example
Section titled “Example”A developer merges a GitHub PR that lowers the default API rate limit from 1,000 to 600 requests per minute. A code comment in the PR links to the “Rate Limiting v2” design doc in Google Docs. Promptless resolves the linked doc and reads the rollout thresholds and the reasoning behind the new limit. Its update to the rate-limit reference page reuses those exact numbers and that rationale.
Before you start
Section titled “Before you start”- An admin role in your Promptless organization, to connect Google Drive and edit the Configuration page.
Connect Google Drive
Section titled “Connect Google Drive”The Google account that authorizes the connection decides what Promptless can read. For least-privilege access, connect through a dedicated Google account that acts as a service account for Promptless. Promptless then reads only what you share with that account.
-
Optional. Create a dedicated Google account for Promptless.
-
Optional. Share with the dedicated account only the shared drives and folders you want Promptless to read.
-
On the Integrations page, select Connect Google Drive.
-
In Google, authorize read-only access with the account you want Promptless to use.
-
On the Google Drive card, check that the header names the account you intended, with its email address under its name. If the header shows no account, select Check access on the card, or reconnect the integration.
-
Check that the card lists only the shared drives and folders you expect Promptless to read.
Limit Promptless to specific shared drives or folders
Section titled “Limit Promptless to specific shared drives or folders”Promptless can read everything the connected account can access. To point Promptless at specific shared drives or folders, scope the Google Drive context source. For example, scope it to your product team’s shared drive or a folder of current-quarter specs:
-
On the Context sources tab of the Configuration page, expand the Google Drive source. If it isn’t listed, select Add a context source, and then select Google Drive.
-
In Which Google Drive shared drives should Promptless read?, add each shared drive.
-
Optional. In Specific folders (optional), add individual folders.
-
Select Save changes. For a new source, select Add context source.
In YAML, the scope is the drive_ids and folder_ids lists on an entry with source_type: google_drive. An entry’s key uses hyphens, such as google-drive:
context_sources: google-drive: source_type: google_drive drive_ids: - 0AExampleDriveIdUk9PVA folder_ids: - 1BExampleFolderIdXyZAn entry with no drive or folder IDs, or no entry, gives Promptless everything the connected account can read. For every context source field, see the Configuration Reference.
See also
Section titled “See also”- Notion, to read specs your team keeps in Notion pages and databases
- Connection health, to check and restore a context source that lost access
- Context sources, to compare every context source Promptless supports