> 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/details-dun-logement/base-de-connaissances/instructions-ia-du-logement.md). # Instructions IA du logement Les **Instructions IA** sont les **directives techniques et de process** que l'IA doit suivre lorsqu'elle répond aux voyageurs de ce logement. Contrairement aux *Informations supplémentaires* qui décrivent des **faits** (équipements, codes, règles…), les **Instructions** décrivent **comment se comporter** (étapes à suivre, cas particuliers à gérer, restrictions, escalades, etc.). La carte **Instructions IA du logement** affiche, en un seul endroit, toutes les instructions effectives sur ce logement : celles livrées par défaut, celles héritées des groupes auxquels le logement est rattaché, et celles que vous avez créées vous-même. {% hint style="info" %} Pour comprendre comment les instructions sont héritées et résolues entre logement et groupes, consultez [Organiser ses configurations par niveaux](/commencer/organiser-par-niveaux.md). Pour gérer les groupes liés à ce logement : [Paramètres → Général](/logements/details-dun-logement/parametres/general.md). {% endhint %} ## Deux familles d'instructions La carte distingue deux grandes familles : ### 1. Instructions système Les **18 instructions système** livrées d'office avec Mr Sherlock (problème majeur, accès au logement, panne d'équipement, perte d'objet…). Elles sont **toujours présentes** sur tout nouveau logement et tout nouveau groupe que vous créez. Pour chaque sujet système, **une seule version est effective** sur le logement : c'est la version **la plus prioritaire** parmi les sources disponibles (logement personnalisé > groupe le plus prioritaire > valeur par défaut système). Les autres versions disponibles pour ce sujet sont conservées et **affichées repliées** sous l'instruction effective. ### 2. Instructions de l'hôte Les instructions **personnalisées** que vous créez vous-même pour des cas spécifiques (ex. : *« Si le voyageur demande à louer une trottinette, lui parler du partenariat avec Lime »*). Elles sont organisées en **sous-groupes** selon leur source : * **Logement** : les instructions personnalisées créées directement sur ce logement. * **\[Nom du groupe de connaissances]** : les instructions personnalisées provenant d'un groupe lié. Chaque sous-groupe affiche un **compteur** d'instructions (`X instruction(s)`). *** ## Les badges d'une instruction Chaque ligne d'instruction porte plusieurs **badges colorés** qui permettent d'identifier d'un coup d'œil sa nature, son statut et sa source. #### Badge de famille * 🟪 **Système** *(violet)* : instruction issue des 18 sujets livrés par défaut. * 🟦 **Hôte** *(bleu)* : instruction personnalisée que vous (ou un groupe) avez créée. #### Badge de statut * 🟢 **Utilisée par l'IA** *(vert)* : c'est cette version qui s'applique réellement. * 🔴 **Ignorée par l'IA** *(rouge)* : version supplantée par une version plus prioritaire (visible uniquement quand la liste des versions est dépliée). #### Badge de source Indique d'où provient la valeur effective : * ⚪ **Défaut** *(gris)* : instruction système à sa valeur d'origine, livrée par Mr Sherlock. * 🟧 **Logement** *(orange)* : instruction personnalisée au niveau du logement. * 🟪 **Groupe \[nom]** *(violet)* : instruction héritée du groupe de connaissances indiqué. #### Badge de comportement Affiché en violet, indique la conduite à adopter par l'IA : * **Répond + notifie** *(`ai_handles_and_notifies`)* - l'IA traite la demande et notifie le gestionnaire. * **Ne répond pas + notifie** *(`ai_transfers_to_host`)* - l'IA n'envoie pas de réponse et transfère le sujet au gestionnaire. * **Répond sans notifier** *(`ai_handles_silently`)* - l'IA traite la demande silencieusement. *** ## Lire une carte d'instruction Chaque instruction s'affiche sous forme de **carte** : * **Bandeau de badges** en haut (famille, statut, source, comportement). * **Nom** de l'instruction. * **Aperçu de la valeur** (texte court, 2 lignes maximum). Pour les **instructions système** ayant plusieurs versions disponibles (ex. : version par défaut + version de groupe + version personnalisée logement), une **ligne dépliable** apparaît en bas de la carte effective : > ⌄ **\[N] version(s) ignorée(s)** Cliquez dessus pour voir les versions masquées. Elles s'affichent en dessous, en lecture seule, avec le badge **Ignorée par l'IA**. Pour les **instructions effectives au niveau du logement**, un **interrupteur** *activé / désactivé* permet de suspendre l'instruction sans la supprimer. *** ## Actions disponibles Les actions affichées dépendent du **type** d'instruction et de son **statut**. ### Sur une instruction système #### Personnaliser pour ce logement * **Quand ?** L'instruction effective vient d'un groupe (ou de la valeur par défaut), et vous voulez en créer une **version spécifique** pour ce logement. * **Action** : ouvre le formulaire d'édition. Un message vous rappelle :\ \&#xNAN;*« Vous personnalisez maintenant cette instruction pour ce logement. Le groupe restera inchangé. »* * La nouvelle version prend immédiatement la priorité sur la valeur héritée. #### Revenir à la valeur du groupe * **Quand ?** L'instruction est actuellement personnalisée au niveau du logement, et une version de groupe existe en dessous (visible dans les versions ignorées). * **Action** : une fenêtre de confirmation s'affiche. * Titre : **« Revenir à la valeur du groupe ? »** * Texte : *« Cette instruction reprendra la valeur définie par le groupe \[nom]. Votre version personnalisée sera conservée — vous pourrez la retrouver si vous re-personnalisez plus tard. »* * Boutons : **Annuler** / **Revenir à la valeur du groupe**. * Toast de succès : **« Instruction réinitialisée à la valeur du groupe »**. #### Activer / désactiver L'**interrupteur** sur la carte effective au niveau du logement permet de mettre en pause une instruction sans la supprimer. ### Sur une instruction de l'hôte * **Modifier** *(clic sur la carte)* : ouvre le formulaire d'édition. * **Supprimer** *(icône corbeille rouge)* : supprime définitivement l'instruction (uniquement pour les instructions au niveau du logement). Toast : **« Instruction supprimée »**. Pour une instruction héritée d'un groupe, seule la **consultation** est possible ici. La modification ou la suppression doivent se faire **depuis le groupe** correspondant. *** ## Créer une instruction Plusieurs entrées possibles : * **Barre d'actions rapides** du panneau latéral, icône **cerveau**. * Bouton **+ Créer une instruction** sur la carte des Instructions IA du logement. Le formulaire vous demande : 1. **Nom** *(150 caractères maximum)*. 2. **Valeur** *(5 000 caractères maximum)*. 3. **Comportement** : *L'IA répond et notifie* / *L'IA ne répond pas et notifie* / *L'IA répond sans notifier*. Boutons : **Annuler** / **Sauvegarder**. ### Générer avec l'IA Si vous ne savez pas comment formuler votre instruction, utilisez **Générer avec l'IA**. L'assistant vous demande une description rapide de ce que vous voulez exprimer et propose une instruction prête à l'emploi, que vous pouvez raffiner avant validation. *** ## Bonnes pratiques * **Une instruction = une règle** : évitez de mélanger plusieurs directives dans la même instruction. * **Soyez explicite sur le déclencheur** : *« Quand le voyageur demande X, fais Y. »* * **Choisissez le bon comportement** : préférez *L'IA ne répond pas et notifie* pour les sujets sensibles que vous voulez gérer vous-même. * Pour des instructions **partagées entre plusieurs logements**, créez-les dans un **groupe de connaissances** plutôt que de les dupliquer logement par logement. * Pour les **instructions système**, partez de la **valeur par défaut** ou d'une version de **groupe** : ne personnalisez au niveau du logement que les sujets qui le nécessitent réellement. --- # 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, and the optional `goal` query parameter: ``` GET https://docs.mrsherlock.ai/logements/details-dun-logement/base-de-connaissances/instructions-ia-du-logement.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.