连接器与索引

以 Markdown 格式查看

连接器会将已批准的外部内容引入 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 后续审查。

连接器指南

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

相关页面