> For the complete documentation index, see [llms.txt](https://docs.mrsherlock.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mrsherlock.ai/logements/groupes-de-connaissances.md).

# Groupes de connaissances

Un **groupe de connaissances** est une **base de connaissance réutilisable** qui regroupe :

* des **Instructions** - les directives techniques et de process que l'IA doit suivre pour répondre aux voyageurs ;
* des **Informations supplémentaires** - des données factuelles sur le logement (équipements, règles, codes, recommandations, etc.).

Un **logement peut être lié à plusieurs groupes de connaissances**, et un groupe peut être lié à plusieurs logements. Cela permet de combiner différentes « briques » de connaissance et de les **mutualiser** entre des logements similaires.

{% hint style="info" %}
Les groupes de connaissances sont l'une des sources d'informations utilisées par l'IA. Pour comprendre comment ils s'articulent avec les autres sources, consultez la page [Base de connaissance de l'IA](/commencer/base-de-connaissance-de-lia.md).
{% endhint %}

### Cas d'usage typiques

* **Logements d'une même résidence** : un groupe partage le même règlement intérieur, les mêmes consignes de check-in/check-out et les mêmes équipements communs.
* **Logements d'une même ville ou d'un même quartier** : un groupe contient les recommandations locales (restaurants, transports, activités) communes à tous les logements de la zone.
* **Logements d'un même type** (studios, T2, villas avec piscine, etc.) : un groupe rassemble les instructions et informations spécifiques à ce type de bien (entretien, équipements particuliers, consignes spécifiques).

### Affichage de la page

La page **Groupes de connaissances** est organisée en deux zones :

* À **gauche** : la **liste des groupes** existants, avec un compteur.
* À **droite** : le **détail du groupe** sélectionné.

Sur mobile, on navigue vers la page de détail d'un groupe en tapant sur sa ligne.

{% hint style="info" %}
**Aucun groupe de connaissances ?** Lorsque vous arrivez pour la première fois, la liste affiche :\
\&#xNAN;*« Aucun groupe de connaissances. Créez-en un pour commencer. »*
{% endhint %}

### Créer un groupe de connaissances

1. Dans la liste, cliquez sur **+ Créer**.
2. Une fenêtre **Créer un groupe de connaissances** s'ouvre.
3. Saisissez le **nom du groupe** (150 caractères maximum, ex. *« Appartement Paris »*).
4. Cliquez sur **Créer**.

Le groupe est immédiatement sélectionné et son panneau de détail s'ouvre, vide.

### Détail d'un groupe

Le détail d'un groupe est composé de trois sections.

#### En-tête

* **Nom du groupe** et meta-info (*« Créé le \[date] · \[N] logement(s) »*).
* **Renommer** (icône crayon) - change le nom du groupe.
* **Supprimer** (icône corbeille) - supprime le groupe (confirmation requise, action irréversible).

#### Logements liés

* Liste des logements rattachés au groupe sous forme de **chips**.
* **+ Ajouter un logement** pour rattacher un nouveau logement.
* **Croix sur une chip** pour détacher un logement du groupe.
* État vide : *« Aucun logement lié à ce groupe. »*

#### Instructions

Les **Instructions** sont les directives techniques que l'IA doit suivre lorsqu'elle traite les messages des voyageurs des logements liés.

* **+ Créer une instruction** ouvre un formulaire :
  * **Nom** - libellé court.
  * **Catégorie** - *Directives techniques*.
  * **Valeur** - le contenu détaillé de la directive (texte multiligne).
  * **Comportement** - choisissez ce que l'IA doit faire :
    * *L'IA gère et notifie*
    * *L'IA transfère à l'hôte*
    * *L'IA gère silencieusement*
* Chaque instruction est affichée sous forme de carte avec :
  * un **badge de catégorie**,
  * un **badge d'auteur** (*Hôte* ou *Système*),
  * son **nom** et un aperçu de la **valeur**,
  * un **interrupteur** pour l'activer / désactiver sans la supprimer,
  * les actions **Modifier** (crayon) et **Supprimer** (corbeille).
* État vide : *« Aucune instruction »*.

#### Informations supplémentaires

Les **Informations supplémentaires** sont des éléments factuels que l'IA peut citer dans ses réponses aux voyageurs des logements liés.

* **+ Créer une information** ouvre un formulaire :
  * **Nom**.
  * **Catégorie** - choisissez parmi : *Équipements*, *Services*, *Règles*, *Arrivée/Départ*, *Clés/Codes*, *Infos pratiques*, *Activités*, *Transport*, *Restaurants*, *Autre*.
  * **Valeur** (texte multiligne).
* Chaque information est affichée sous forme de carte avec son badge de catégorie, son nom, un aperçu de la valeur, et les actions **Modifier** / **Supprimer**.
* État vide : *« Aucune information »*.

### Que se passe-t-il quand un logement est lié à plusieurs groupes ?

Quand un logement est lié à plusieurs groupes de connaissances, l'IA dispose de **l'ensemble cumulé** de toutes les Instructions et Informations supplémentaires des groupes auxquels le logement est rattaché - en plus de celles définies au niveau du logement lui-même.

Vous pouvez ainsi combiner, par exemple, un groupe « Résidence Marina » (consignes spécifiques au bâtiment) et un groupe « Côte d'Azur » (recommandations locales) sur un même logement.

### Sauvegarde

Les modifications (création, édition, suppression d'instruction ou d'information, rattachement de logement) sont **enregistrées automatiquement** - il n'y a pas de bouton « Enregistrer » global.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mrsherlock.ai/logements/groupes-de-connaissances.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
