用途:该技能面向 Glean 的二级工作流,用于构建自定义 Glean 连接器,包括创建数据源、批量索引文档、管理内容生命周期以及配置文档权限。
主要能力与用法:
- 创建自定义数据源:向 ${GLEAN}/index/v1/adddatasource 发送 POST 请求,设置 name、displayName、datasourceCategory、urlRegex、isOnPrem 等字段。
- 批量索引文档:向 ${GLEAN}/index/v1/bulkindexdocuments 发送 POST 请求,使用 uploadId 标识一次上传,按 isFirstPage/isLastPage 分页,建议每批 100 条。资料提示批量索引会替换数据源中的全部文档。
- 设置文档权限:向 ${GLEAN}/index/v1/indexdocuments 发送 POST 请求,可通过 permissions.allowedUsers 指定可访问用户邮箱,控制文档在搜索结果中的可见性。
- 删除文档:向 ${GLEAN}/index/v1/deletedocument 发送 POST 请求,指定 datasource、objectType 和 id。
错误处理:uploadId 重复使用需每次生成唯一值;文档过大需将正文截断至约 100KB;权限格式错误需使用有效邮箱地址。
前置条件:需指定数据源负责人、已批准的分类与保留策略、限定范围的索引凭证,以及含虚构文档的沙箱源;还需不透明文档 ID、幂等策略和两个合成身份以测试源 ACL 传播,并准备仅限测试群体的删除或回滚方案,且不能削弱源权限。
输出:返回索引回执,包含数据源、批次、接受与隔离数量、幂等版本、源到索引的 ACL 对比、允许/拒绝结果、保留日期与回滚引用,且不得包含文档正文、标题、凭证或用户成员信息。
限制:资料未提供具体收费、平台覆盖或效果数据;实际接口字段与限制以 Glean 官方文档为准。