连接器与索引
连接器与索引
连接器会将已批准的外部内容引入艾维斯知识库。Admin 可以管理全部连接器和文档集；Curator 可以管理自己负责群组内的这些资源，Global Curator 可以管理自己所属群组内的这些资源。Agent 只能使用已附加给它的已索引文档集。
知识接入路径
企业知识接入应先确认来源范围，再创建连接器。不要先大范围同步，再靠 Agent 指令约束使用范围。
概念
Standard 模式要求
Lite 模式没有向量数据库，不能索引文档。因此，连接器、文档集和索引设置都需要 Standard 模式。
添加连接器前，请使用 Standard 模式。确认部署具备所需存储，并且内容来源管理员已批准预期的访问范围。
添加连接器
- 以 Admin 或 Curator 身份登录并打开“文档与知识”。
- 选择已批准的内容来源，然后选择认证方式及自己获准范围内可用的凭据。
- 将索引范围限制在该部署获准使用的内容内。
- 保存连接器并启动一次索引尝试。
不要将凭据放入 Agent 指令、对话消息、源代码管理或共享文档。请让每个连接器只服务于一个已批准的内容来源和访问边界。
对于普通连接器和文档集，Curator 的可编辑范围限于自己负责的群组；Global Curator 可对自己所属群组使用同类控制项。
监控索引
每次索引尝试运行后都应检查结果。确认尝试已完成，查看报告的错误，并在 Agent 依赖这些内容前验证预期文档已可用。
索引尝试记录的是一次运行；它不保证内容来源会始终可达，也不保证之后的来源变更已被索引。变更连接器范围、凭据或相关来源内容后，请重新运行一次尝试。
管理文档集
按清晰的访问和检索用途将已索引文档组织为文档集。只将 Agent 所需的文档集附加给它；当来源范围或目标受众变更时，请重新检查该集合。
文档集用于组织已索引内容；它们不会授予内容来源访问权，也不能替代来源本身的权限控制。不再需要时，请从 Agent 移除相应文档集。
索引设置
只有 Admin 可以修改部署级 Index Settings。对于连接器级范围和更新节奏，请使用与已批准内容来源相匹配的设置，并先从较小且有代表性的范围开始。验证索引结果后，再仅在内容所有者和部署策略允许时扩大范围。
修改索引设置后，更新结果可能需要新的索引尝试才会可用。请记录选择某个范围或设置的原因，以便其他 Admin 后续审查。
连接器指南
请根据需要索引的已批准内容来源选择相应指南：
- 协作文档与知识库：飞书、钉钉、TAPD、语雀。
- 代码与研发管理：GitLab、Gitee、禅道。
- 数据库：MySQL、PostgreSQL。
- 对象存储：阿里云 OSS、腾讯云 COS、华为云 OBS、MinIO。
- 文件与网页：坚果云与 WebDAV、Web和File。