agentdb-query

AgentDB 查询

通过控制器桥接查询和管理 AgentDB。AgentDB 提供 20 个 agentdb_* MCP 工具；本技能列出标准使用流程。

适用场景

当你需要在多个 Agent 会话间存储、检索或搜索知识时。AgentDB 提供分层存储、因果知识图谱、语义路由和上下文综合功能。

步骤

1. 检查运行状况 — mcp__plugin_ruflo-core_ruflo__agentdb_health。检查 available: true 是否正常。
2. 启动会话 — 如果当前尚未启动会话，调用 mcp__plugin_ruflo-core_ruflo__agentdb_session-start。
3. 存储知识 — 使用 mcp__plugin_ruflo-core_ruflo__agentdb_hierarchical-store 存储按层级键组织的结构化数据（层级：working|episodic|semantic）。
4. 回忆知识 — 使用查询调用 mcp__plugin_ruflo-core_ruflo__agentdb_hierarchical-recall。
5. 搜索模式 — 调用 mcp__plugin_ruflo-core_ruflo__agentdb_pattern-search 搜索已学习的模式（由 ReasoningBank 路由）。
6. 综合上下文 — 调用 mcp__plugin_ruflo-core_ruflo__agentdb_context-synthesize，组合多条记忆。
7. 构建因果图 — 调用 mcp__plugin_ruflo-core_ruflo__agentdb_causal-edge，关联相关知识。

可用的控制器组

调用 mcp__plugin_ruflo-core_ruflo__agentdb_controllers 列出运行时注册表。20 个 MCP 工具提供的功能类别：

• 分层 — agentdb_hierarchical-store、_recall（按层级路由）
• 模式 — agentdb_pattern-store、_search（由 ReasoningBank 路由）
• 语义 — agentdb_semantic-route、_context-synthesize
• 因果 — agentdb_causal-edge（图节点后端，桥接失败时回退）
• 生命周期 — agentdb_health、_controllers、_session-start、_session-end
• 批量 — agentdb_batch（≤500 条）、_consolidate
• 质量 — agentdb_feedback
• 图查询 — agentdb_graph-query（从带域前缀的节点 ID（例如 entity:xyz）进行 k 跳／语义／pagerank 查询）；SQL k 跳查询最多为 3 跳，请检查 appliedDepth 和 truncated）和 agentdb_graph-pathfinder
• 删除（具有破坏性） — agentdb_hierarchical-delete、agentdb_causal-edge-delete、agentdb_causal-node-delete。调用前请与用户确认确切的 ID；这些操作无法通过此插件撤销。

重要：命名空间处理

命名空间字符串仅适用于 memory_* 和 embeddings_search。agentdb_hierarchical-*、agentdb_pattern-* 和 agentdb_causal-edge 工具按层级或控制器路由，而不是按命名空间路由。不要向这些工具传递 namespace: 'foo'——该参数会被静默忽略。参见插件 README 中的“命名空间约定”。

操作回退（根据以下情况分支处理）

• controller: 'memory-store-fallback' — 模式已通过 memory_store --namespace pattern 持久化。这不是失败。
• _graphNodeBackend: true — 因果边由 @ruvector/graph-node 处理。
• success: false, error: '...Use memory_store/memory_search instead.' — 桥接不可用；请根据 README 中的替代表切换到 memory_* 工具。

CLI 替代方案

npx @claude-flow/cli@latest memory search --query "your query" --namespace patterns
npx @claude-flow/cli@latest memory store --key "key" --value "value" --namespace patterns
npx @claude-flow/cli@latest memory list --namespace patterns