SuperAPI AI 工具集

glean-sdk-patterns

编程与开发

查看项目

更新于 10-15 23:26

技能介绍

用途:为 Glean 企业搜索平台提供生产级 API 集成模式。Glean 的搜索与索引均使用基于 POST 的 REST 端点,搜索走 Client API,文档写入走 Indexing API。

主要能力:单例客户端集中管理令牌与基础地址;search 方法支持 pageSize 与 datasource 过滤;indexDocuments 与 bulkIndex 支持按批次(默认 100)批量索引;GleanError 与 safeCall 封装错误,对 429 延迟 3 秒重试、401 提示密钥无效;GleanSearchBuilder 链式构建查询、数据源、分页、游标与分面过滤;提供 GleanDocument、GleanSearchResponse、GleanDatasource 等类型,以及 mockDocument、mockSearchResponse 测试工具。

使用方式:从环境变量 GLEAN_DOMAIN 与 GLEAN_API_KEY 构造客户端,缺失即报错;搜索请求带 Authorization Bearer 与 X-Glean-Auth-Type: BEARER 头;批量索引超过 100 条时用 bulkIndex 分批。

适用场景:企业搜索集成、文档批量入库、需要类型化响应与统一错误处理的管道。

限制:资料未提供具体价格、平台支持范围与完整部署步骤;示例中的域名、密钥与数据均为占位或虚构,需替换为真实配置;未知 ACL、目标或响应结构应失败关闭,不得回退到宽泛客户端;不得记录凭据、查询文本或文档正文。