# search_knowledge

Pesquise revisões atuais publicadas da Knowledge ou leia um item autorizado exato e uma revisão imutável com paginação limitada.

- Canonical: https://docs.xmemo.dev/pt-br/docs/tools/search-knowledge
- Locale: pt-BR
- Content-Locale: pt-BR
- Canonical-Content-Digest: 0310677a87145c1efaa396cd0aa2c2893ad43e7f2bff4548b876ab6d5b61ac0e
- Edition-Digest: a82533848a2c0e2a3b0a6fc7b1d71d90dbcb8dc52d322f92ac49a95b3f08ba0c
- Source-Revision: sha256:f9db1cd4b6ed36f17d373c2a7c050c7e3ba83004cace01216f0ec51ea5b5b265

## Tool Reference: `search_knowledge`

### Purpose

Leia conteúdo autorizado da Knowledge Base por uma consulta classificada sobre revisões atuais publicadas ou por um item/revisão exatos, com paginação de conteúdo limitada.

### Parameters

- `query` (string, optional, default: empty): Consulta em linguagem natural para busca classificada; obrigatória no modo query e mutuamente exclusiva com identificadores endereçados.
- `knowledge_base_id` (string, optional, default: empty): ID exato opcional da Knowledge Base para restringir a busca por query ou validar um item endereçado.
- `knowledge_item_id` (string, optional, default: empty): ID do item autorizado exato para leitura endereçada.
- `knowledge_revision_id` (string, optional, default: empty): ID exato opcional da revisão imutável do item endereçado; exige knowledge_item_id.
- `offset` (integer, optional, default: 0): Offset de caracteres baseado em zero para o conteúdo endereçado.
- `limit_chars` (integer, optional, default: 4000): Janela de conteúdo da leitura endereçada, de 1 a 10000 caracteres no limite MCP.
- `max_results` (integer, optional, default: 10): Número máximo de resultados da consulta, de 1 a 50.
- `mode` (string, optional, default: hybrid): Modo de pontuação da consulta: hybrid, lexical, semantic ou rrf. Texto não reconhecido é normalizado para hybrid pelo handler MCP.
- `alpha` (number, optional, default: 0.5): Peso lexical híbrido, limitado de 0.0 a 1.0; o peso semântico é 1-alpha.

### Returns

A consulta retorna texto JSON com {"type":"knowledge_search","results":[...]} em que cada resultado inclui os IDs atuais do item/revisão da Knowledge, título, trecho limitado, fonte/citação, referência e pontuações. A leitura endereçada retorna texto JSON com type='knowledge', owner/team/scope, IDs de base/item/revisão, título, conteúdo limitado, locator, source, reference, content_offset, content_limit, content_total_chars e content_truncated. A ferramenta não retorna envelope de auditoria.

### Errors

- knowledge_runtime_disabled: a chave de runtime está desligada e a ferramenta retorna um envelope knowledge_unavailable; isso é um estado operacional, não um fallback para memória sem restrições.
- knowledge_invalid_request: query foi combinado com IDs endereçados, offset/limit_chars/max_results ultrapassou os limites ou o formato da solicitação é inválido.
- knowledge_query_required ou knowledge_item_required: não foi fornecida uma query nem um item endereçado, ou knowledge_revision_id foi fornecido sem knowledge_item_id.
- knowledge_resource_unavailable: a base, o item ou a revisão endereçada está ausente, não autorizada, inativa ou não é um item publicado.
- Falha de autorização ou validação: o chamador não possui knowledge:read, a query excede seu limite de entrada ou um valor de limite está malformado.

### Examples

#### Pesquise conhecimento atual publicado



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

#### Leia uma revisão fixada em blocos



```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): Monte um pacote de contexto limitado a partir das memórias comuns do XMemo, não de conteúdo da Knowledge Base.
- [search_memory](/docs/tools/search): Use recuperação estritamente direcionada na superfície de memória comum.
- [remember](/docs/tools/remember): Persista um fato de memória duradouro explicitamente solicitado, não uma revisão da Knowledge.

## Escolha o formato de leitura antes de chamar

Use query para uma busca classificada ou knowledge_item_id para uma leitura endereçada. Adicione knowledge_revision_id somente quando a revisão imutável exata fizer parte da solicitação.