用途:该技能演示 Glean 的自定义数据接入流程,分两步完成——先用 Indexing API 建立自定义数据源,再用 Client API 查询索引结果,适合在搭建新 Glean 自定义连接器或验证搜索质量时参考。
主要能力:包含创建/配置自定义数据源、批量索引文档、按查询返回结果三个环节。示例中数据源通过 /index/v1/adddatasource 创建,文档经 /index/v1/indexdocuments 写入,搜索调用 /client/v1/search 并可通过 requestOptions.datasourceFilter 限定数据源,结果含 title、url、score 字段。
使用方式:需准备已批准的沙箱数据源、范围受限的非生产凭据,以及虚构的示例文档。设置 GLEAN_DOMAIN、GLEAN_INDEXING_TOKEN、GLEAN_CLIENT_TOKEN 环境变量;索引头部使用 Bearer 令牌,搜索头部额外带 X-Glean-Auth-Type: BEARER。先调 adddatasource,再调 indexdocuments,最后调用 search 验证。
适用场景:新连接器起步、搜索质量测试。
限制与安全要求:仅使用沙箱数据源、非生产凭据和虚构样例,不使用生产 wiki、员工身份或真实结果片段;需准备一个允许看到样例的身份和一个必须被拒绝的身份,并保留测试记录的删除路径,测试 ID 仅存本地。索引后搜索可能需等待 1-2 分钟才生效;文档必须包含 id、title、url 等必需字段,否则报 invalid document;数据源未创建会报 datasource not found。