> For the complete documentation index, see [llms.txt](https://docs.bito.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bito.ai/ai-architect/integrating-ai-architect-with-your-tools/integrating-with-google-docs.md). # Integrating with Google Docs Your team's documented intent lives in Google Docs, Sheets, and Slides — design decisions, edge cases, test scenarios, requirement docs, and specs. [**Bito's AI Architect**](/ai-architect/overview.md) reads that documentation and uses it as context whenever it analyzes Jira tickets, answers questions in Slack, or generates implementation plans. It can also create and update Google Docs for you — writing back plans, summaries, and decisions directly from Jira or Slack, without ever switching tabs. Once you connect Google Docs, AI Architect treats your Google documents as a first-class context source alongside your code, Jira/Linear tickets, Confluence docs, and team conversations in Slack. {% hint style="info" %} **Read across Docs, Sheets, Slides, and Drive; write to Docs.** AI Architect can browse Google Drive folders and search Docs, Sheets, and Slides by name or content. It reads Google Docs, Sheets, and Slides, and it can create and update Google Docs. Write support applies to Google Docs only — Sheets and Slides are read-only. {% endhint %} ## What AI Architect does with Google Docs #### Pulls Google Docs into analysis as context * **Automatic context on Jira plans** — When AI Architect generates an implementation plan for a Jira Epic or Story, any Google Docs referenced in that ticket are pulled in automatically. It fetches the relevant details — edge cases, design decisions, and test scenarios — so recommendations, risk assessments, and effort estimates reflect what your team has already documented. * **Grounds your coding agents** — Because the plan carries your documented intent, the code your agents generate is grounded in your team's decisions, not just the code that already exists. * **Reads across Docs, Sheets, Slides, and Drive** — AI Architect can browse Drive folders and search for files by name or content, then read the Google Docs, Sheets, and Slides it finds. Supporting material spread across your documents factors into the plan. * **Surfaces information in Slack** — When you paste a Google Docs link into a Slack thread, the [Bito AI Assistant for Slack](/ai-architect/integrating-ai-architect-with-your-tools/integrating-with-slack.md) reads the linked document and uses it to answer questions, summarize, or compare against the discussion. #### Lets you manage Google Docs from Jira and Slack You can ask AI Architect — through Jira comments or Slack — to create and update Google Docs for you. **Supported operations:** | Operation | What you can ask | Scope | | ------------------- | -------------------------------------------------------- | -------------------- | | **Browse Drive** | Browse folders in Google Drive to locate documents | Drive | | **Search files** | Search Docs, Sheets, and Slides by name or content | Docs, Sheets, Slides | | **Read a document** | Read the contents of a Doc, Sheet, or Slide deck | Docs, Sheets, Slides | | **Create a Doc** | Create a new Google Doc (for example, a plan or summary) | Docs only | | **Update a Doc** | Edit the contents of an existing Google Doc | Docs only | {% hint style="info" %} Write access applies to Google Docs only. AI Architect can read Google Sheets and Google Slides, but it cannot modify them. {% endhint %} ### Setup {% stepper %} {% step %} ### Enable AI Architect for your workspace AI Architect can be set up using one of the following deployment options: #### 1. Bito-hosted AI Architect is managed and maintained by Bito. * Follow the [Bito-hosted AI Architect installation guide](/ai-architect/installation/install-ai-architect-bito-hosted.md) to get started. * If AI Architect isn't already active for your workspace, contact the Bito team at to enable it. #### 2. Self-hosted AI Architect is deployed and managed within your own infrastructure. * Follow the [self-hosted AI Architect installation guide](/ai-architect/installation/install-ai-architect-self-hosted.md) to set up and configure AI Architect for your workspace. {% endstep %} {% step %} ### Connect Bito with Google Docs 1. In your Bito dashboard, go to the [**Manage integrations**](https://alpha.bito.ai/home/cra-integrations) page. 2. Under **Available integrations**, find **Google Docs** and click **Connect**.
3. Click **Authorize with your Google account**. You will be redirected to Google's site to grant Bito access to your documents (Google Docs, Sheets, Slides, and Drive). This uses OAuth to securely link your documents.
4. Review the requested permissions, click the **Select all** checkbox to grant all permissions, and then click **Continue**.
5. After successful authorization, you will be redirected to Bito, where a success message confirms the connection.
{% endstep %} {% endstepper %} ## How to use AI Architect with Google Docs #### Get richer Jira plans automatically If you've already referenced a Google Doc in a Jira ticket — for example, a design doc, test plan, or requirements brief — there's nothing more to do. When AI Architect generates a plan for that ticket, it reads the referenced documents and folds them into the analysis. **Example:** A Story references a Google Doc that documents the edge cases for a payments flow. AI Architect's plan will account for those edge cases directly, instead of assuming a generic happy path. [**Learn more about Jira integration**](/ai-architect/integrating-ai-architect-with-your-tools/integrating-with-jira.md) #### Reference Google Docs in Slack Paste a Google Docs link into a Slack thread and ask AI Architect about it. **Examples:** ``` @Bito summarize this design doc and tell me what's missing [Google Docs link] ``` ``` @Bito do the test scenarios in this doc cover PROJ-456? [Google Docs link] ``` The Bito AI Assistant reads the document, factors it into the thread context, and responds with answers grounded in your documentation. [**Learn more about Slack integration**](/ai-architect/integrating-ai-architect-with-your-tools/integrating-with-slack.md) #### Create and update Google Docs from Jira Ask AI Architect to write to Google Docs directly from a Jira ticket comment. **Examples:** ``` @bito create a Google Doc summarizing the implementation plan above ``` ``` @bito update the linked Google Doc with the decisions made on this ticket ``` #### Create and update Google Docs from Slack The same operations work from Slack threads. **Examples:** ``` @Bito create a Google Doc documenting the conclusions from this thread ``` ``` @Bito update this Google Doc with the API contract we just agreed on: [Google Docs link] ``` {% hint style="info" %} AI Architect can search your Drive to find the right document. If you're unsure of the exact link, ask it by name — for example, `@Bito find the "Checkout redesign" doc and summarize the open questions`. {% endhint %} ## What AI Architect knows about your team Once Google Docs is connected, it becomes one of several context sources AI Architect uses: * **Your codebase** — All your repositories, services, API endpoints, modules, and design patterns are indexed into a knowledge graph. * **Your Jira/Linear history** — Recurring patterns from past tickets: race conditions, fragile services, security gaps, error-handling issues. * **Your Google documentation** — Design docs, requirement briefs, test plans, and specs stored in Google Docs, Sheets, and Slides. * **Other context sources** — Confluence pages, Slack threads, observability data, and custom instructions you provide. [**Learn how Bito builds the knowledge graph**](/ai-architect/knowledge-graph.md) ## Permissions required for Google Docs integration When you connect Google Docs, Bito requests access to your Google account via OAuth. AI Architect needs to read your Google Docs, Sheets, and Slides, browse Drive, and write to Google Docs, so it requests the following access. **Summary of access** | Google product | Access level | What AI Architect can do | | ----------------- | ----------------- | -------------------------------------------------- | | **Google Docs** | Read and write | Read document content; create and update documents | | **Google Sheets** | Read-only | Read spreadsheet content | | **Google Slides** | Read-only | Read presentation content | | **Google Drive** | Browse and search | Browse folders and search files by name or content | {% hint style="info" %} AI Architect only acts on your documents when you ask it to (via Jira or Slack) or when a document is referenced in a ticket it's analyzing. It does not make changes on its own. {% endhint %} ## Troubleshooting #### AI Architect's Jira plan doesn't reflect my Google Doc **Check:** 1. Is Google Docs connected in [**Manage integrations**](https://alpha.bito.ai/home/cra-integrations)? 2. Is the Google Doc actually referenced in the Jira ticket — via a link in the ticket description or comments? 3. Does the Google account used to connect the integration have access to the document? Bito sees only what that account can see. #### AI Architect can't read a document **Check:** 1. Is the file a Google Doc, Sheet, or Slide deck? These are the supported Google file types. 2. Is the document shared with the Google account used to connect the integration? #### AI Architect can't update a document **Check:** 1. Is the file a Google Doc? Write access applies to Google Docs only — Sheets and Slides are read-only. 2. Does the connected Google account have edit permission on that document? #### Authorization errors If Bito reports that it can't access Google Docs: 1. Go to [**Manage integrations**](https://alpha.bito.ai/home/cra-integrations) and reconnect Google Docs. 2. Confirm the Google account used has access to the documents you expect AI Architect to read or write to. ## Frequently Asked Questions #### Does AI Architect read every document in our Google Drive? No. AI Architect reads documents on demand: * Documents **referenced in a Jira ticket** it's analyzing * Documents **referenced by URL** in a Slack thread where it's mentioned * Documents you explicitly ask it to browse, search, read, create, or update It does not crawl or index your entire Google Drive. #### Can AI Architect edit my Google Sheets or Slides? No. AI Architect has read-only access to Google Sheets and Google Slides. It can read their content for context, but it can only create and update Google Docs. #### Can I limit which documents AI Architect can access? Yes — at the Google account level. The Google account used to connect the integration determines what AI Architect can see. Share only the documents and folders you want AI Architect to reach with that account. #### Does AI Architect modify my documents without asking? No. Create and update operations happen only when you explicitly request them through a Jira comment or Slack message. ## Next steps 1. **Connect Google Docs** to your Bito workspace via [**Manage integrations**](https://alpha.bito.ai/home/cra-integrations). 2. **Reference your design docs and test plans** in the Jira tickets that relate to them — AI Architect will pick them up automatically when you ask it to generate an implementation plan. 3. **Try writing back from Slack or Jira** — ask AI Architect to create a Google Doc summarizing a thread or ticket, and see how it reads. 4. **Combine with** [**Jira**](/ai-architect/integrating-ai-architect-with-your-tools/integrating-with-jira.md) **and** [**Slack**](/ai-architect/integrating-ai-architect-with-your-tools/integrating-with-slack.md) **integrations** for the full workflow: plan in Jira, discuss in Slack, document in Google Docs — all driven by AI Architect. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.bito.ai/ai-architect/integrating-ai-architect-with-your-tools/integrating-with-google-docs.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.