用途:使用 Glean Client API 构建搜索与聊天体验,覆盖带过滤条件的全文搜索、AI 驱动的聊天回答和自动补全建议,适合构建搜索集成、实现 Glean 聊天等场景。
前置条件:需要受限的搜索身份、已批准的数据源过滤器和无法检索公司敏感材料的合成术语;任何分析、聊天历史或反馈采集需具备用户同意与保留策略;还需可在不修改源文档或连接器 ACL 的情况下禁用客户端或过滤器的回滚路径。
主要能力与用法:
- 带过滤与分面的搜索:向 /client/v1/search 发送 POST 请求,请求体包含 query、pageSize、requestOptions(如 datasourceFilter、facetFilters),结果含 datasource、title、snippets。
- AI 聊天:向 /client/v1/chat 发送 POST 请求,请求体含 messages 与 applicationId,响应提供答案内容与 citations 来源标题。
- 自动补全:向 /client/v1/autocomplete 发送 POST 请求,请求体含 query 与可选 datasourceFilter,返回建议文本。
错误处理:结果为空多因查询过窄或数据源未索引,需放宽查询并检查数据源状态;聊天无引用因内容未为聊天索引,需确认文档含正文;搜索返回 403 为权限问题,需确保令牌具备搜索范围。
输出要求:返回脱敏的工作流凭据,包含数据源范围、关联 ID、结果数量区间、允许/拒绝结果与所用回退方案,绝不记录查询文本、标题、片段、转录或凭据。
限制:资料未提供具体定价、平台支持范围、完整配额或部署细节,暂未提供。