search_knowledge

Herramienta MCP pública

search_knowledge

Propósito

Lee contenido autorizado de Knowledge Base mediante una consulta clasificada sobre revisiones actuales publicadas o mediante un elemento/revisión exactos con paginación acotada.

Cuándo usar

• Busca un tema en una Knowledge Base autorizada cuando el contenido publicado actual deba clasificarse mediante evidencia léxica, semántica, híbrida o RRF.
• Lee un elemento exacto de Knowledge y su revisión actual, o una revisión inmutable dirigida específicamente.
• Usa una ventana de contenido acotada con offset y limit_chars cuando una revisión supera el presupuesto de contexto del caller.

Cuándo NO usar

• No la uses para la recuperación de memoria ordinaria de XMemo; usa recall, search_memory o recall_context para la superficie de memoria.
• No la uses para crear, publicar, actualizar o archivar una Knowledge Base o un elemento; esas son operaciones REST/servicio independientes.
• No mezcles query con knowledge_item_id o knowledge_revision_id; elige búsqueda por consulta o lectura dirigida en cada llamada.
• No trates una revisión histórica dirigida como el resultado actual de una búsqueda por consulta; la búsqueda por consulta sigue deliberadamente el current_revision_id de cada elemento publicado.

Ámbito requerido

• Se requiere knowledge:read; la herramienta es estrictamente de solo lectura y no emite ningún evento de auditoría de Knowledge.
• TOOL_CATALOG clasifica search_knowledge como superficie avanzada con min_tier=free y hidden_but_callable=true; no forma parte de la lista mínima de herramientas de marketplace-app pública.
• El servidor resuelve el contexto autenticado vinculado al propietario o equipo y no acepta filtros de owner o scope proporcionados por el caller.

Parámetros

Esquema de retorno

La consulta devuelve texto JSON con {"type":"knowledge_search","results":[...]} donde cada resultado incluye los IDs actuales del elemento/revisión de Knowledge, el título, un extracto acotado, la fuente/cita, la referencia y las puntuaciones. La lectura dirigida devuelve texto JSON con type='knowledge', owner/team/scope, IDs de base/elemento/revisión, título, contenido acotado, locator, source, reference, content_offset, content_limit, content_total_chars y content_truncated. La herramienta no devuelve ningún sobre de auditoría.

Ejemplos

search_knowledge({
  query: "deployment runbook",
  knowledge_base_id: "<knowledge-base-id>",
  mode: "hybrid",
  alpha: 0.5,
  max_results: 10
})

search_knowledge({
  knowledge_item_id: "<knowledge-item-id>",
  knowledge_revision_id: "<immutable-revision-id>",
  offset: 0,
  limit_chars: 4000
})

Errores

• knowledge_runtime_disabled: el interruptor de ejecución está desactivado y la herramienta devuelve un sobre knowledge_unavailable; es un estado operativo, no un fallback a memoria sin restricciones.
• knowledge_invalid_request: query se mezcló con IDs dirigidos, offset/limit_chars/max_results superó sus límites o la forma de la solicitud no es válida.
• knowledge_query_required or knowledge_item_required: no se proporcionó una query ni un elemento dirigido, o se proporcionó knowledge_revision_id sin knowledge_item_id.
• knowledge_resource_unavailable: la base, el elemento o la revisión dirigida no existe, no está autorizada, activa o publicada.
• Authorization or validation failure: el caller carece de knowledge:read, la consulta supera su límite de entrada o un valor de límite está mal formado.

Herramientas relacionadas

• recall_context — Construye un paquete de contexto acotado a partir de memorias ordinarias de XMemo en lugar de contenido de Knowledge Base.
• search_memory — Usa una recuperación estrictamente dirigida en la superficie de memoria ordinaria.
• remember — Persiste un hecho de memoria durable solicitado explícitamente, no una revisión de Knowledge.