SuperAPI AI 工具集

query

通用与其它

查看项目

更新于 10-16 05:49

技能介绍

用途:基于 gbrain 知识库回答用户提问、做查找或综合,采用三层检索与综合,并传播引用。契约保证:答案均基于 brain 内容、每条论断可追溯到具体页面 slug、明确标注信息缺口、遵守来源优先级(用户陈述 > 编译事实 > 时间线 > 外部来源)、冲突来源同时列出双方引用。

主要能力:分解问题为关键词、语义、结构化三类检索策略;执行廉价混合检索(gbrain search,精确词/已知名称)、全混合检索(gbrain query,多查询扩展)、按类型列页或查反向链接;读取前 3-5 页获取上下文;综合答案并附引用;标注缺口。记忆动词(MEMORY_VERBS v1,gbrain ≥ 0.43,经 MCP 连接时优先):recall(query|entity, budget_tokens)、entity(name)、synthesize(question);动词不可用时回退到 search/query/get_page。图遍历(v0.10.1+)用于关系问题:gbrain graph-query <slug> --type <link_type> --depth N --direction in|out|both,链接类型含 attended、works_at、invested_in、founded、advises、mentions、source。

使用方式:按问题类型选择检索;token 预算紧张时可用 recall 并指定 budget_policy: "query_first",例如 gbrain recall --query 'zebra telescope' --budget-tokens 75 --budget-policy query_first --json;需要整页证据时用 gbrain query "when did the launch move?" --return-unit page --token-budget 6000。仅在分块确认页面相关且需更多上下文时才用 gbrain get <slug> 加载整页。

限制与失败处理:检索结果需先检查 notice;empty_retrieval kind=degraded 或 search_degraded 表示仅关键词检索,空结果不等于无笔记;listing_truncated/budget_truncated 表示列表被截断;page_not_found 应先按标题搜索。禁止从通用知识作答、编造事实、静默择一来源、忽略来源优先级。搜索质量异常可运行 gbrain doctor --json 检查索引与嵌入覆盖。query_first 为可选打包策略,不改变相关性模型,也不扩大权限;其采用情况需在新会话中确认,否则报告为未验证。