# search_knowledge

Recherchez dans les révisions actuelles publiées de Knowledge ou lisez un élément autorisé exact et une révision immuable avec pagination délimitée.

- Canonical: https://docs.xmemo.dev/fr/docs/tools/search-knowledge
- Locale: fr-FR
- Content-Locale: fr-FR
- Canonical-Content-Digest: 0310677a87145c1efaa396cd0aa2c2893ad43e7f2bff4548b876ab6d5b61ac0e
- Edition-Digest: af87be5d59d5a7b8fca7bf059d313a1692f060d49957bd1fe0291725e0755554
- Source-Revision: sha256:f9db1cd4b6ed36f17d373c2a7c050c7e3ba83004cace01216f0ec51ea5b5b265

## Tool Reference: `search_knowledge`

### Purpose

Lire du contenu autorisé de base de connaissances soit par requête classée sur les révisions actuelles publiées, soit par un élément/une révision exact avec pagination de contenu délimitée.

### Parameters

- `query` (string, optional, default: empty): Requête en langage naturel pour la recherche classée ; requise en mode requête et mutuellement exclusive avec les identifiants adressés.
- `knowledge_base_id` (string, optional, default: empty): ID exact de base de connaissances facultatif pour restreindre la recherche par requête ou valider un élément adressé.
- `knowledge_item_id` (string, optional, default: empty): ID exact d'élément autorisé pour la lecture adressée.
- `knowledge_revision_id` (string, optional, default: empty): ID exact de révision immuable facultatif pour l'élément adressé ; requiert knowledge_item_id.
- `offset` (integer, optional, default: 0): Décalage de caractères basé sur zéro pour le contenu adressé.
- `limit_chars` (integer, optional, default: 4000): Fenêtre de contenu de lecture adressée de 1 à 10000 caractères à la limite MCP.
- `max_results` (integer, optional, default: 10): Nombre maximal de résultats de requête de 1 à 50.
- `mode` (string, optional, default: hybrid): Mode d'évaluation de la requête : hybrid, lexical, semantic ou rrf. Le texte non reconnu est normalisé en hybrid par le gestionnaire MCP.
- `alpha` (number, optional, default: 0.5): Poids lexical hybride, restreint entre 0.0 et 1.0 ; le poids sémantique est 1-alpha.

### Returns

La requête renvoie un texte JSON avec {"type":"knowledge_search","results":[...]} où chaque résultat comprend les ID d'élément/révision actuels de knowledge, le titre, un extrait délimité, la source/citation, la référence et les scores. La lecture adressée renvoie un texte JSON avec type='knowledge', owner/team/scope, les ID de base/élément/révision, le titre, le contenu délimité, le localisateur, la source, la référence, content_offset, content_limit, content_total_chars et content_truncated. L'outil ne renvoie aucune enveloppe d'audit.

### Errors

- knowledge_runtime_disabled : le commutateur d'exécution est désactivé et l'outil renvoie une enveloppe knowledge_unavailable ; il s'agit d'un état opérationnel et non d'un basculement vers une mémoire sans restriction.
- knowledge_invalid_request : query a été combiné avec des identifiants adressés, offset/limit_chars/max_results ont dépassé les limites, ou la forme de la requête est par ailleurs invalide.
- knowledge_query_required ou knowledge_item_required : ni une requête ni un élément adressé n'ont été fournis, ou knowledge_revision_id a été fourni sans knowledge_item_id.
- knowledge_resource_unavailable : la base, l'élément ou la révision adressé est absent, non autorisé, inactif ou n'est pas un élément publié.
- Échec d'autorisation ou de validation : l'appelant ne dispose pas de knowledge:read, la requête dépasse sa limite d'entrée, ou une valeur de limite est malformée.

### Examples

#### Rechercher des connaissances publiées actuelles



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

#### Lire une révision épinglée par blocs



```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): Construire un pack de contexte délimité à partir de mémoires XMemo ordinaires plutôt que du contenu de base de connaissances.
- [search_memory](/docs/tools/search): Utiliser une récupération ciblée stricte sur la surface de mémoire ordinaire.
- [remember](/docs/tools/remember): Persister un fait de mémoire durable explicitement demandé, et non une révision de connaissances.

## Choisir la forme de lecture avant d'appeler

Utilisez query pour une recherche classée ou knowledge_item_id pour une lecture adressée. N'ajoutez knowledge_revision_id que lorsque la révision immuable exacte fait partie de la requête.