Acota una búsqueda con demasiados resultados
Añade los filtros de alcance y path antes de aumentar el límite; un límite más amplio en una consulta sin alcance devuelve más ruido, no más señal.
search_memory({
query: "token identity fallback",
limit: 5
})Herramienta MCP pública
search_memory
Propósito
Busca memorias XMemo autorizadas con coincidencias estrictamente dirigidas, para que las coincidencias débiles no se traten silenciosamente como respuesta.
Cuándo usar
- El llamador conoce el proyecto, equipo, path o tipo de memoria relevante y necesita una consulta dirigida.
- Una coincidencia semántica débil sería engañosa o insegura como resultado.
- Necesitas filtros explícitos de scope/team, explicaciones de recuperación o un conjunto de resultados más amplio pero controlado.
Cuándo NO usar
- No lo uses para una búsqueda rápida, flexible y sin alcance; usa recall.
- No lo uses para construir un paquete de contexto con varias memorias; usa recall_context.
- No lo uses para modificar o eliminar una memoria.
- La API REST acepta un conjunto de campos más amplio que la herramienta MCP pública; consulta /docs/api/memory para los filtros de scope, bucket, team y provenance.
Ámbito requerido
- Se requiere memory:read; los filtros scope y team_id no pueden ampliar el límite de autorización del llamador.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
query | string · obligatorio | Tema o redacción exactos que se deben comparar. |
limit | integer · predeterminado: 5 | Cantidad de resultados. |
path_filter | string · predeterminado: % | Solo en el perfil del plugin de Claude: filtro ILIKE de path lógico. No se acepta en el perfil público genérico. |
memory_type | string · predeterminado: % | Solo en el perfil del plugin de Claude: filtro de tipo de memoria. No se acepta en el perfil público genérico. |
prefer_working | boolean · predeterminado: false | Solo en el perfil del plugin de Claude: coloca el estado de trabajo activo antes de los resultados vectoriales. |
Esquema de retorno
Respuesta de texto ordenada con referencias opacas, ubicaciones, contenido y metadatos opcionales de explicación o límite del agente. El resultado sigue limitado a las memorias autorizadas.
Ejemplos
search_memory({
query: "token identity fallback",
limit: 5
})Errores
- 401/403: falta memory:read o no se puede acceder al scope/equipo seleccionado.
- Error de validación: query, limit, patrón de path o tipo de memoria no es válido.
- Respuesta sin coincidencias: ningún resultado sólido satisface los filtros objetivo y autorizados; el llamador no debe sustituir silenciosamente la semántica de recall.
Herramientas relacionadas
- recall — Usa recuperación flexible de mejor esfuerzo cuando no sea necesaria una coincidencia estricta.
- recall_context — Usa recuperación acotada de varias memorias para el contexto de un prompt.
- forget — Elimina un registro exacto solo después de revisar la referencia devuelta.
Fuente: Superficie de herramientas MCP