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

# 连接 Google Drive

建议使用权限稳定、方便统一管理的 Google Workspace 账号，例如专门的集成账号。Counso 只能同步该账号能够访问的文件。人员离职或权限调整可能中断同步，因此需要明确连接的维护人。

## 建立连接

1. 打开 **Spaces > Connections**，选择 Google Drive。
2. 使用指定的 Google 账号登录，核对授权范围。
3. 选择需要同步的云端硬盘、文件夹或文件，然后保存。
4. 如需检索 PDF，在连接设置中开启 PDF 文本索引。

连接账号需要具备连接器要求的文档权限及下载权限。如果选择树中找不到文件，请检查 Drive 的共享设置是否禁止下载、打印或复制。只对需要共享的文件开放适当权限。

## 支持的内容与限制

连接可以索引 Google Docs、Slides、DOCX、PPTX、TXT、Markdown，以及包含文字的 PDF。提取文本超过 2 MB 的文档会被跳过。Google 电子表格和 PDF 的文件大小上限为 128 MB；每个工作表最多同步 50,000 行，同一电子表格中的各工作表分别处理。

通过该连接进行表格查询前，需要把原生 Excel 文件转换为 Google Sheets。也可以在 Drive 设置中开启上传 Office 文件时自动转换。

只有扫描图片、不含文本层的文件无法通过该连接建立文本索引。可以把这类 PDF 直接上传到会话，并使用适合该文件的文档读取能力；使用提取结果前应先核对。

## 更新与缺失文件

新增、修改和删除通常需要几分钟才能反映到 Counso。大型 Drive 的首次同步可能超过一天，文件特别多时可能需要几天。账号能访问数万份文件时，建议先同步团队实际需要的文件夹。

找不到内容时，依次检查连接账号、所选范围、下载限制、文件格式、大小和同步状态。文件已经存在于 Drive，并不代表文本已经完成索引。

## 使用 Drive 标签筛选

Drive 标签会作为文档标签同步，供助手筛选资料。如果标签没有出现，请检查连接是否具有标签读取权限；需要新增授权时重新连接。更新文档后，会在重新同步时带入当前标签。