# search_knowledge

Busca revisiones actuales de Knowledge publicadas o lee un elemento autorizado exacto y una revisión inmutable mediante paginación acotada.

- Canonical: https://docs.xmemo.dev/es/docs/tools/search-knowledge
- Locale: es-ES
- Content-Locale: es-ES
- Canonical-Content-Digest: 0310677a87145c1efaa396cd0aa2c2893ad43e7f2bff4548b876ab6d5b61ac0e
- Edition-Digest: bd8f60ba076ac45bc21914c1b898a9eead321914ab9a969c2f042295484f8956
- Source-Revision: sha256:f9db1cd4b6ed36f17d373c2a7c050c7e3ba83004cace01216f0ec51ea5b5b265

## Tool Reference: `search_knowledge`

### Purpose

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.

### Parameters

- `query` (string, optional, default: empty): Consulta en lenguaje natural para la búsqueda clasificada; es obligatoria en modo query y mutuamente excluyente con los identificadores dirigidos.
- `knowledge_base_id` (string, optional, default: empty): ID exacto opcional de Knowledge Base para acotar la búsqueda por consulta o validar un elemento dirigido.
- `knowledge_item_id` (string, optional, default: empty): ID del elemento autorizado exacto para una lectura dirigida.
- `knowledge_revision_id` (string, optional, default: empty): ID opcional de la revisión inmutable exacta del elemento dirigido; requiere knowledge_item_id.
- `offset` (integer, optional, default: 0): Desplazamiento de caracteres desde cero para el contenido dirigido.
- `limit_chars` (integer, optional, default: 4000): Ventana de contenido de la lectura dirigida, de 1 a 10000 caracteres en el límite MCP.
- `max_results` (integer, optional, default: 10): Número máximo de resultados de la consulta, de 1 a 50.
- `mode` (string, optional, default: hybrid): Modo de puntuación de la consulta: hybrid, lexical, semantic o rrf. El texto no reconocido se normaliza a hybrid por el handler MCP.
- `alpha` (number, optional, default: 0.5): Peso léxico híbrido, limitado entre 0.0 y 1.0; el peso semántico es 1-alpha.

### Returns

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.

### Errors

- 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.

### Examples

#### Busca conocimiento publicado actual



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

#### Lee una revisión fijada por partes



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

### Related Tools

- [recall_context](/docs/tools/recall-context): Construye un paquete de contexto acotado a partir de memorias ordinarias de XMemo en lugar de contenido de Knowledge Base.
- [search_memory](/docs/tools/search): Usa una recuperación estrictamente dirigida en la superficie de memoria ordinaria.
- [remember](/docs/tools/remember): Persiste un hecho de memoria durable solicitado explícitamente, no una revisión de Knowledge.

## Elige la forma de lectura antes de llamar

Usa query para una búsqueda clasificada o knowledge_item_id para una lectura dirigida. Añade knowledge_revision_id solo cuando la revisión inmutable exacta forme parte de la solicitud.