Skip to main content
使用自然语言查询在工作空间中跨所有记忆源(文档和事实)进行搜索。结果按来源类型分组,便于你在 UI 中分别展示各类别或将其合并。文档只在 project_ids 列出的项目中搜索;其余可选筛选条件用于指定 Actor、Agent 或记忆类型。
所需权限: 工作空间上需要 workspace:memory_search,此外按您指名的对象各需一项——project_ids 里的每个项目需要 project:mem_search 与 project:doc_search;actor_ids 里的每个 Actor 需要 workspace_actor:fact_search;agent_ids 里的每个 Agent 需要 workspace_agent:fact_search。只要指名了您无权搜索的对象,整个请求会被拒绝。

路径参数

string
required
工作空间标识符

请求体

string
required
自然语言搜索查询
array of strings
要搜索的项目。文档只在这里列出的项目中搜索:省略时不搜索任何项目,documents 返回空。事实仍会在请求指定的 Actor 和 Agent 中搜索;actor_ids 和 agent_ids 都未传时,搜索您自己的 Actor。
array of strings
将搜索限定到与特定 Actor 关联的记忆
array of strings
将搜索限定在指定 Agent 的记忆范围内。
array of strings
按记忆类型筛选结果。可接受的值:document、fact。省略时将搜索所有类型。
integer
default:"10"
返回结果的总数上限(1–1000)。所有被搜索的记忆类型共用这一个上限,而不是每种类型各自的上限:top_k=5 可能返回 5 条文档,也可能返回 3 条文档加 2 条事实,具体组合只取决于哪些结果与您的查询最相关。实际返回数量可能少于该值。
string
搜索的深入程度,用结果质量换取速度:
  • max — 执行完整搜索。
  • high — 不根据已存储的事实扩展查询,并使用更轻量的最终排序。通常比 max 明显更快。
  • low — 在 high 的基础上,不再用模型理解查询,并收窄召回范围,速度最快。
级别越低,同一查询返回的结果可能更少或有所不同。省略时使用默认级别。传入其他值返回 400。

响应

object