检索 API(Retrieve API)
POST /v1/users/:user_id/streams/:stream_id/retrieve
对单个用户和流执行混合检索(Hybrid Retrieval)。
此路由的用途
这是运行时的主要召回路由。它融合多种检索信号,而非依赖单一搜索路径。 可用信号包括:- 语义相似度(Semantic Similarity)
- 文本检索(Text Retrieval)
- 图扩展(Graph Expansion)
- 时间过滤(Time Filtering)
- 组织知识(Organization Knowledge)
- 多模态查询输入(Multimodal Query Input)
请求
请求字段
响应
响应字段
实用说明
- 即使是多模态检索,查询文本也始终是必需的。
- 当提供
org_id时,共享的组织知识可以进入结果集。 graph_depth允许检索通过图链接的邻居进行扩展,而不仅限于直接匹配。agent_id在你希望偏向某个 Agent 的程序性记忆时非常有用。

