SuperAPI AI 工具集

cognee-recall

通用与其它

查看项目

更新于 10-16 06:15

技能介绍

用途:recall() 是 cognee 的查询 API,用于向记忆提问。它选择搜索策略,检索图(有会话时也检索会话缓存),并返回带标签的结果列表,例如 results = await cognee.recall("Where was Einstein born?")。

搜索类型选择:显式传入 query_type=SearchType.X 时始终优先。无可用 LLM key 时用 CHUNKS(纯向量搜索)。否则默认走路由器 auto_route=True,仅两条正则规则、无 LLM 调用:整条查询是一个引号短语则 CHUNKS_LEXICAL;提到编码规则/标准/约定或代码评审指南则 CODING_RULES;其余为 HYBRID_COMPLETION。被路由的类型(非固定类型)若被后端拒绝,或路由得到的 CHUNKS_LEXICAL/CODING_RULES 无结果,会以 HYBRID_COMPLETION 重试一次。路由器不会选 CYPHER。

常用类型:HYBRID_COMPLETION 为默认,适合一般问题;GRAPH_COMPLETION 从图关系作答;GRAPH_COMPLETION_COT、_CONTEXT_EXTENSION、_DECOMPOSITION 适合更难的多跳问题;GRAPH_SUMMARY_COMPLETION 在查询时先总结图边;RAG_COMPLETION 为经典分块 RAG;TRIPLET_COMPLETION 用于主谓宾事实;TEMPORAL 用于时间问题;CHUNKS、CHUNKS_LEXICAL、SUMMARIES、CODE、SKILLS、CYPHER 不需要 LLM;NATURAL_LANGUAGE 由 LLM 写 Cypher 再执行;GRAPH_REPORT 生成图洞察报告;FEELING_LUCKY 由 LLM 选类型;AGENTIC_COMPLETION 是多步循环,只支持单数据集,应通过 search() 传参。

范围与限制:scope 可为 graph、session、session_first、trace、session_context、all、tools、code,all 不隐式包含 tools 和 code。无 session_id 只搜图;仅传 session_id 则优先会话,命中会话即跳过图;session_id 加 datasets 时两者都参与;session_id 加 query_type 时只搜图。无 datasets 时搜索用户可读的全部数据集,按名称或 UUID 限定更快。top_k 按数据集而非总量计算;node_name 可限定节点集。权限会影响结果,不可读的数据集会触发错误。空图上仅图检索会返回状态为 memory_warming_up 的 system 条目。SKILLS 和 AGENTIC_COMPLETION 需恰好一个数据集。多数完成类型会产生一次 LLM 调用,部分类型调用更多。优先使用 recall(),只有需要 agentic 参数、原始 SearchResult 或固定类型时才用 cognee.search()。