> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.alephant.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.alephant.io/_mcp/server.

# 连接器与索引

> 连接已批准的内容来源、跟踪索引，并管理 Agent 可使用的文档集。

连接器会将已批准的外部内容引入 OpenCore 知识库。Admin 可以管理全部连接器和文档集；Curator 可以管理自己负责群组内的这些资源，Global Curator 可以管理自己所属群组内的这些资源。Agent 只能使用已附加给它的已索引文档集。

## 概念

| 概念   | 含义                      |
| ---- | ----------------------- |
| 连接器  | 指向一个内容来源及其索引范围的已保存连接。   |
| 凭据   | 让连接器访问其内容来源的受保护认证资料。    |
| 索引尝试 | 一次发现、读取并为连接器索引内容的已记录运行。 |
| 文档集  | 可供 Agent 选择的已索引文档的命名集合。 |

## Standard 模式要求

Lite 模式没有向量数据库，不能索引文档。因此，连接器、文档集和索引设置都需要 Standard 模式。

添加连接器前，请使用 Standard 模式。确认部署具备所需存储，并且内容来源管理员已批准预期的访问范围。

## 添加连接器

1. 以 Admin 或 Curator 身份登录并打开“文档与知识”。
2. 选择已批准的内容来源，然后选择认证方式及自己获准范围内可用的凭据。
3. 将索引范围限制在该部署获准使用的内容内。
4. 保存连接器并启动一次索引尝试。

不要将凭据放入 Agent 指令、对话消息、源代码管理或共享文档。请让每个连接器只服务于一个已批准的内容来源和访问边界。

对于普通连接器和文档集，Curator 的可编辑范围限于自己负责的群组；Global Curator 可对自己所属群组使用同类控制项。Google Drive 使用特殊凭据流程：Google 凭据由 Admin 创建和维护，并由 Admin 按 Google Drive 指南为连接器选择或关联。

## 监控索引

每次索引尝试运行后都应检查结果。确认尝试已完成，查看报告的错误，并在 Agent 依赖这些内容前验证预期文档已可用。

索引尝试记录的是一次运行；它不保证内容来源会始终可达，也不保证之后的来源变更已被索引。变更连接器范围、凭据或相关来源内容后，请重新运行一次尝试。

## 管理文档集

按清晰的访问和检索用途将已索引文档组织为文档集。只将 Agent 所需的文档集附加给它；当来源范围或目标受众变更时，请重新检查该集合。

文档集用于组织已索引内容；它们不会授予内容来源访问权，也不能替代来源本身的权限控制。不再需要时，请从 Agent 移除相应文档集。

## 索引设置

只有 Admin 可以修改部署级 **Index Settings**。对于连接器级范围和更新节奏，请使用与已批准内容来源相匹配的设置，并先从较小且有代表性的范围开始。验证索引结果后，再仅在内容所有者和部署策略允许时扩大范围。

修改索引设置后，更新结果可能需要新的索引尝试才会可用。请记录选择某个范围或设置的原因，以便其他 Admin 后续审查。

## 连接器指南

请根据需要索引的已批准内容来源选择相应指南：

* Google 服务：[Google Drive](/opencore/knowledge/google-drive/overview)和 [Gmail](/opencore/knowledge/gmail/overview)。
* 协作平台：[Slack](/opencore/knowledge/connectors/slack)、[Confluence](/opencore/knowledge/connectors/confluence)、[SharePoint](/opencore/knowledge/connectors/sharepoint)、[Notion](/opencore/knowledge/connectors/notion)和 [Microsoft Teams](/opencore/knowledge/connectors/microsoft-teams)。
* 云存储：[Dropbox](/opencore/knowledge/connectors/dropbox)、[Amazon S3](/opencore/knowledge/connectors/s3)和 [Google Cloud Storage](/opencore/knowledge/connectors/google-cloud-storage)。
* 工单与支持：[Jira](/opencore/knowledge/connectors/jira)和 [Zendesk](/opencore/knowledge/connectors/zendesk)。
* 销售与客户洞察：[Salesforce](/opencore/knowledge/connectors/salesforce)、[HubSpot](/opencore/knowledge/connectors/hubspot)和 [Gong](/opencore/knowledge/connectors/gong)。
* 代码仓库：[GitHub](/opencore/knowledge/connectors/github)和 [GitLab](/opencore/knowledge/connectors/gitlab)。
* 其他来源：[Web](/opencore/knowledge/connectors/web)和[文件](/opencore/knowledge/connectors/file)。

## 相关页面

* [管理 Agent](/opencore/agents/agents) 介绍如何将文档集附加到 Agent。
* [部署模式](/opencore/deployment-modes) 对比 Lite 和 Standard 模式。