主题
连接器（connector）会把文件从你原本存放它们的地方复制进 LlamaCloud project 里的一个文件夹，并让这个文件夹与源头保持一致。文件一旦进入文件夹，你就可以为它建索引、或在其上跑批量任务，与手工上传的文件夹完全一样。
连接器取代了较早的数据源。数据源绑定在单个索引上；连接器喂给的是一个文件夹，而 project 里的任何东西都能读这个文件夹。
支持的连接器
| 源头 | 认证方式 | 一个文件夹同步的范围 |
|---|---|---|
| Google Drive | Google 账号登录，或 service account 密钥文件 | 一个 Drive 文件夹，含子文件夹 |
| SharePoint | Microsoft 账号登录，或 Entra 应用注册 | 文档库中的一个文件夹 |
| S3 | 一组 IAM access key | 一个 bucket，可选收窄到某个前缀 |
| Confluence | Atlassian 账号登录，或 API token | 一个 space，其中每个页面及其附件 |
OneDrive、Azure Blob Storage、Box、Notion、Slack 与 Jira 在列表里标着“Coming soon”，目前无法连接。
连接与已连接文件夹
要配的东西有两样，把这两件事分清会更容易理解：
- 一个连接是某个源头上的一个已授权账号：一次 Google 登录、一组 S3 密钥、一个 Confluence token。每个账号只需在 Files 页的 Connections 标签上配一次。
- 一个已连接文件夹是 project 里从某个连接的某一部分同步过来的文件夹：一个 Drive 文件夹、一个 S3 前缀、一个 Confluence space。它在 Files → New folder → Connected folder 里创建。
一个连接可以喂给任意多个文件夹，但源头的每一处位置在每个连接下只能同步进一个文件夹。连接归属于 project，换另一个 project 就得再建一个。同一个账号在一个 project 里只能连接一次。
Connections 标签与已连接文件夹只在包含文件夹同步的套餐上可用。没有该能力时，Files 页只显示你自己上传的文件夹。
添加连接
- 打开 project 里的 Files，进入 Connections 标签。
- 点击 Add connection，选择源头，再点击 Continue。
- 在弹出的窗口里登录（Authorize），或填写凭据表单（Connect）。
手工填写凭据时，LlamaCloud 会先向提供方校验再保存，因此密钥写错或权限缺失会当场失败并给出提供方的原因，而不是等到第一次同步才暴露。各连接器页面列出了具体校验什么。密钥以加密方式存储，且不会再显示第二次。
创建已连接文件夹
- 在 Folders 标签上点开 New folder，选择 Connected folder。
- 选择连接。如果你还没有该源头的连接，可以直接在这个对话框里完成授权。
- 选择要同步的内容。Google Drive 与 SharePoint 的登录方式会打开提供方自己的文件夹选择器；基于密钥的连接以及 S3、Confluence 则要求你输入或粘贴位置。
- 给文件夹命名并点击 Create folder。
在创建任何东西之前，LlamaCloud 会先确认该连接能读取这个位置，所以 bucket 名打错、或文件夹没共享给你，会立刻以“not found”或“not accessible”返回。文件夹一建立，首次同步就开始了。
用 API 配置连接器
Connections 标签以及 New folder → Connected folder 里的所有操作都能通过 REST API 完成，包括在同步来的文件夹上建索引或跑批量任务。用 API 配置连接器 以 S3 为例完整走了一遍。
同步是怎么进行的
每个已连接文件夹大约各自每天同步一次，没有逐文件夹的定时配置可调。想早点拉到变更，就打开该文件夹点 Sync now，几秒内就会开始同步。
每次同步时：
- 源头新增的文件会被加入。
- 有改动的文件会重新下载并替换旧副本。
- 在源头被删除、或被移出同步范围的文件，会从文件夹里移除。
Google Drive 与 SharePoint 只读取自上次同步以来的变更；S3 与 Confluence 每次都会完整列出整个位置，因此即使几乎没变，很大的 bucket 或 space 每次同步也更耗时。
同步失败时，文件夹会显示 Last sync failed 并给出原因，之后自行重试，且每次重试之间的等待更长。
停止同步、断开连接或删除
这三种操作对 project 里已有文件的影响各不相同：
| 操作 | 位置 | 对已同步文件的影响 |
|---|---|---|
| 对文件夹停止同步 | 文件夹的同步横幅 | 保留。文件夹不再接收变更。连接及其其他文件夹照常运行。 |
| 断开一个连接 | Connections 标签，行菜单 | 保留。该连接下的每个文件夹都立即停止同步。 |
| 删除一个文件夹 | Folders 标签 | 连同文件夹一起删除。此操作无法撤销。 |
停止后再想同步同一个文件夹，需要重新创建一个已连接文件夹并再次选择位置。
连接失效时
如果密码变了、token 过期，或有人在源头撤了权限，该连接会在 Connections 标签上显示 Expired 或 Revoked，其下每个文件夹显示 Not syncing。这些文件夹不会自行恢复。
Reconnect 菜单项目前还不可用。在它可用之前，办法是：断开失效的连接、重新添加，然后重建已连接文件夹。断开时已同步的文件仍留在原处，所以要重建的只有这些新文件夹。