OpenNomos文档
工具记忆

memory_search

搜索这个项目的记忆。

搜索这个项目的记忆。返回原始记录,不带摘要。q 为空则列出最近的条目;kind 和 tags 是可选的过滤条件。

以上是服务端发布的英文描述的译文;英文原文见英文页。工具名、参数名和取值保持原样。

字段值
工具包Core (core)
每次调用的预估成本$0
工具包每月上限无
项目按顺序确定:显式的 project → 请求头 → 凭据默认项目 → 工作区默认项目

参数

参数必填类型说明
q否string搜索文本,例如 'pricing'。为空则列出最近的记忆。 默认:""。
kind否string只要这个 kind 的记忆,例如 'decision'。
tags否string[]只要带有这些标签的记忆,例如 ['reddit']。
limit否integer (≥ 1, ≤ 100)最多返回多少条记忆。默认 50。
project否string项目 slug 或 id。省略则用凭据或工作区的默认项目。

示例调用

{
  "q": "reddit",
  "kind": "insight",
  "limit": 10
}

REST:POST https://service.opennomos.com/v1/tools/memory_search,以上 JSON 作为请求体。MCP:tools/call,name: "memory_search",以上 JSON 作为 arguments。

示例结果

示例里的值是示意性的;结构来自服务端代码。

{
  "project": {
    "id": "prj_k3Vd9aQx2",
    "slug": "acme-crm"
  },
  "memories": [
    {
      "id": "mem_Zr81nQw3",
      "kind": "insight",
      "content": "Reddit r/SaaS ignores self-promo; reply with help first.",
      "tags": [
        "reddit",
        "rules"
      ],
      "source": "Claude Code",
      "created_at": "2026-10-16T09:00:00.000Z",
      "updated_at": "2026-10-16T09:00:00.000Z"
    }
  ]
}

说明

  • 这里的查询参数叫 q(其他工具用 query)。q 为空则列出最近的记忆。
  • 搜索使用全文匹配,也能匹配中文。修改后立刻就能搜到。
  • 搜索按工作区限流(每分钟 120 次,按服务实例计)。

错误

被拒绝的调用(输入有误、id 未知、触发限流)返回 message 和 code;走 MCP 时结果带 isError: true。见错误。

本页目录