> 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 可使用的文档集。

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

## 知识接入路径

企业知识接入应先确认来源范围，再创建连接器。不要先大范围同步，再靠 Agent 指令约束使用范围。

| 阶段       | 关键问题               | 建议做法                   |
| -------- | ------------------ | ---------------------- |
| 来源审批     | 哪些空间、仓库、网页或文件可被索引？ | 由内容 owner 明确授权范围。      |
| 凭据准备     | 使用个人账号还是服务账号？      | 优先使用受控服务账号，并只授予最小读取权限。 |
| 连接器配置    | 同步哪些路径、频道、项目或文件类型？ | 从小范围开始，验证后再扩大。         |
| 索引验证     | 文档是否成功解析、分块和检索？    | 检查索引尝试，并用代表性问题测试命中。    |
| Agent 附加 | 哪些 Agent 可以使用该文档集？ | 只附加给有明确业务需求的 Agent。    |

## 概念

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

## Standard 模式要求

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

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

## 添加连接器

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

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

对于普通连接器和文档集，Curator 的可编辑范围限于自己负责的群组；Global Curator 可对自己所属群组使用同类控制项。

## 监控索引

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

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

## 管理文档集

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

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

## 索引设置

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

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

## 连接器指南

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

* 协作文档与知识库：[飞书](/aivis/knowledge/connectors/feishu)、[钉钉](/aivis/knowledge/connectors/dingtalk)、[TAPD](/aivis/knowledge/connectors/tapd)、[语雀](/aivis/knowledge/connectors/yuque)。
* 代码与研发管理：[GitLab](/aivis/knowledge/connectors/gitlab)、[Gitee](/aivis/knowledge/connectors/gitee)、[禅道](/aivis/knowledge/connectors/zentao)。
* 数据库：[MySQL](/aivis/knowledge/connectors/mysql)、[PostgreSQL](/aivis/knowledge/connectors/postgresql)。
* 对象存储：[阿里云 OSS](/aivis/knowledge/connectors/aliyun-oss)、[腾讯云 COS](/aivis/knowledge/connectors/tencent-cos)、[华为云 OBS](/aivis/knowledge/connectors/huawei-obs)、[MinIO](/aivis/knowledge/connectors/minio)。
* 文件与网页：[坚果云与 WebDAV](/aivis/knowledge/connectors/nutstore-webdav)、[Web](/aivis/knowledge/connectors/web)和[File](/aivis/knowledge/connectors/file)。

## 相关页面

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