连接器与索引
连接器与索引
连接器会将已批准的外部内容引入 OpenCore 知识库。Admin 可以管理全部连接器和文档集;Curator 可以管理自己负责群组内的这些资源,Global Curator 可以管理自己所属群组内的这些资源。Agent 只能使用已附加给它的已索引文档集。
概念
Standard 模式要求
Lite 模式没有向量数据库,不能索引文档。因此,连接器、文档集和索引设置都需要 Standard 模式。
添加连接器前,请使用 Standard 模式。确认部署具备所需存储,并且内容来源管理员已批准预期的访问范围。
添加连接器
- 以 Admin 或 Curator 身份登录并打开“文档与知识”。
- 选择已批准的内容来源,然后选择认证方式及自己获准范围内可用的凭据。
- 将索引范围限制在该部署获准使用的内容内。
- 保存连接器并启动一次索引尝试。
不要将凭据放入 Agent 指令、对话消息、源代码管理或共享文档。请让每个连接器只服务于一个已批准的内容来源和访问边界。
对于普通连接器和文档集,Curator 的可编辑范围限于自己负责的群组;Global Curator 可对自己所属群组使用同类控制项。Google Drive 使用特殊凭据流程:Google 凭据由 Admin 创建和维护,并由 Admin 按 Google Drive 指南为连接器选择或关联。
监控索引
每次索引尝试运行后都应检查结果。确认尝试已完成,查看报告的错误,并在 Agent 依赖这些内容前验证预期文档已可用。
索引尝试记录的是一次运行;它不保证内容来源会始终可达,也不保证之后的来源变更已被索引。变更连接器范围、凭据或相关来源内容后,请重新运行一次尝试。
管理文档集
按清晰的访问和检索用途将已索引文档组织为文档集。只将 Agent 所需的文档集附加给它;当来源范围或目标受众变更时,请重新检查该集合。
文档集用于组织已索引内容;它们不会授予内容来源访问权,也不能替代来源本身的权限控制。不再需要时,请从 Agent 移除相应文档集。
索引设置
只有 Admin 可以修改部署级 Index Settings。对于连接器级范围和更新节奏,请使用与已批准内容来源相匹配的设置,并先从较小且有代表性的范围开始。验证索引结果后,再仅在内容所有者和部署策略允许时扩大范围。
修改索引设置后,更新结果可能需要新的索引尝试才会可用。请记录选择某个范围或设置的原因,以便其他 Admin 后续审查。
连接器指南
请根据需要索引的已批准内容来源选择相应指南:
- Google 服务:Google Drive和 Gmail。
- 协作平台:Slack、Confluence、SharePoint、Notion和 Microsoft Teams。
- 云存储:Dropbox、Amazon S3和 Google Cloud Storage。
- 工单与支持:Jira和 Zendesk。
- 销售与客户洞察:Salesforce、HubSpot和 Gong。
- 代码仓库:GitHub和 GitLab。
- 其他来源:Web和文件。