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