Skip to main content

检索 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 的程序性记忆时非常有用。

相关页面