> 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/commencer/organiser-par-niveaux.md). # Organiser ses configurations par niveaux \ **Ce que vous allez apprendre :** comment Mr Sherlock organise les connaissances et les paramètres IA sur plusieurs niveaux pour vous permettre de **configurer une seule fois et appliquer partout,** tout en gardant la liberté de spécifier des règles différentes par logement. *** ## Vue d'ensemble Mr Sherlock AI propose deux types de configuration qui pilotent le comportement de votre assistant IA : * **La base de connaissances** : ce que l'IA sait sur votre logement (informations factuelles) et comment elle doit se comporter face à certaines situations (instructions). * **Les paramètres IA** : comment l'IA s'exprime, à quel moment elle envoie ses messages, qui prévenir, comment elle gère les appels téléphoniques. Pour vous éviter de tout configurer logement par logement, Mr Sherlock organise ces deux familles sur plusieurs niveaux hiérarchiques. **Chaque niveau hérite du niveau supérieur**, et vous pouvez spécialiser au niveau du logement précis quand c'est nécessaire. ### Les deux arborescences en un coup d'œil ``` ┌─────────────────────────────────────────────────────────────────────┐ │ VOTRE WORKSPACE │ └────────────────────────────────────────┬────────────────────────────┘ │ ┌────────────────────────────┴──────────────────────────────┐ │ │ ┌────────▼────────────┐ ┌───────────▼──────────────┐ │ BASE DE │ │ PARAMÈTRES IA │ │ CONNAISSANCES │ │ │ │ (2 niveaux) │ │ (2 ou 3 niveaux │ │ │ │ selon le paramètre) │ └─────────┬───────────┘ └────────────┬─────────────┘ │ │ ┌─────────▼─────────────┐ ┌──────────────▼──────────────┐ │ Groupes de │ │ Niveau Workspace │ │ connaissance │ │ (pour ton, signature, voice)│ │ (mutualisés) │ └──────────────┬──────────────┘ └─────────┬─────────────┘ │ │ ┌────────────▼────────────────┐ ┌─────────▼─────────────┐ │ Groupes de paramètres │ │ Niveau Logement │ │ (mutualisés) │ │ (spécifique) │ └────────────┬────────────────┘ └───────────────────────┘ │ ┌────────────▼────────────────┐ │ Niveau Logement │ │ (spécifique) │ └─────────────────────────────┘ ``` **À retenir :** * La **base de connaissances** fonctionne sur **2 niveaux** : groupes de connaissance → logement. * Les **paramètres IA** fonctionnent sur **2 ou 3 niveaux** selon le paramètre concerné (signature, ton et voix, ainsi que la plupart des paramètres Voice IA : 3 niveaux ; les comportements messaging et l'activation Voice IA : 2 niveaux). * Vous pouvez créer autant de **groupes** que vous voulez et lier un logement à **plusieurs groupes de connaissance** (avec un ordre de priorité), ou à **un seul groupe de paramètres**. ### Pourquoi des niveaux ? | Situation | Le bon niveau | | ------------------------------------------------------------------------------------------- | ------------- | | « Tous mes logements utilisent la même signature en bas de chaque message » | **Workspace** | | « Tous les appels voyageurs doivent être transférés au même numéro d'astreinte » | **Workspace** | | « Mes 12 studios du centre-ville partagent les mêmes règles d'accès et de check-in » | **Groupe** | | « Mes logements premium ont leur propre équipe d'astreinte téléphonique » | **Groupe** | | « Cet appartement précis a une particularité (équipement particulier, logement atypique…) » | **Logement** | | « Pour ce logement haut de gamme, transférer les appels directement au propriétaire » | **Logement** | *** ## La base de connaissances ### Ce qu'elle contient Votre base de connaissances regroupe deux familles d'éléments : #### a) Les informations additionnelles Faits, descriptions et détails que l'IA doit connaître pour répondre aux voyageurs. Organisées par catégories : * **Équipements** (cafetière Nespresso, lave-linge à condensation…) * **Services** (ménage en fin de séjour, baby-sitting…) * **Règles** (pas de fête, animaux acceptés, non-fumeur…) * **Caution** (montant, modalités de retour) * **Check-in / Check-out** (procédure, heures, contact d'urgence) * **Clés / Codes** (code de la porte, emplacement de la boîte à clés) * **Informations pratiques** (Wi-Fi, chauffage, ordures ménagères) * **Activités** (musées, parcs, événements à proximité) * **Transports** (métro, parking, location vélo) * **Restaurants** (recommandations à proximité) * **Autre** Chaque information a un titre (jusqu'à 150 caractères) et une valeur libre (jusqu'à 5 000 caractères). #### b) Les instructions Consignes opérationnelles qui disent à l'IA **comment se comporter** dans une situation donnée. Chaque instruction porte un **comportement** : | Comportement | Effet | | ---------------------------------- | ----------------------------------------------------------------------------------- | | **L'IA gère et notifie** | L'IA répond au voyageur et envoie une notification au gestionnaire pour information | | **L'IA transfère au gestionnaire** | L'IA ne répond pas, transfère la conversation au gestionnaire en l'avertissant | | **L'IA gère en silence** | L'IA traite le sujet de manière autonome, sans alerter le gestionnaire | Les instructions ont deux origines : * **Instructions système** : 18 instructions livrées d'office avec Mr Sherlock (problème majeur, accès au logement, panne d'équipement, perte d'objet…). Elles sont automatiquement présentes sur tout nouveau logement et tout nouveau groupe que vous créez. Vous pouvez les personnaliser ou les désactiver. * **Instructions personnalisées** : règles que vous ajoutez pour des cas spécifiques (ex. : *« Si le voyageur demande à louer une trottinette électrique, répondre que nous proposons un partenariat avec Lime »*). ### Les deux niveaux de la base de connaissances #### Niveau Groupe de connaissance Un **groupe de connaissance** est un conteneur partagé entre plusieurs logements. Vous y mettez les informations et instructions qui s'appliquent à un ensemble de logements similaires. **Exemples de groupes typiques :** * « Maisons centre-ville Lyon » - règles communes à tous vos biens du centre. * « Studios Limoges » - règles spécifiques à votre portefeuille limougeaud. * « Locations longue durée » - règles pour les séjours de plus d'un mois. Vous créez et gérez vos groupes depuis l'onglet **Groupes de connaissance** de votre workspace. {% content-ref url="/pages/sC0d66NGD29oSHPtywxF" %} [Groupes de connaissances](/logements/groupes-de-connaissances.md) {% endcontent-ref %} #### Niveau Logement C'est la connaissance **propre à un logement précis**. Tout ce qui est spécifique : son adresse exacte, sa description, ses photos, ses équipements particuliers, ses règles spéciales. Au niveau logement, vous trouvez : * Les **données de présentation** : titre, description, adresse, capacité, photos, équipements, guide voyageur. * Les **informations additionnelles propres au logement**. * Les **instructions propres au logement**. {% content-ref url="/pages/TfQ3GNOGryXEUa0Uk219" %} [Base de connaissances](/logements/details-dun-logement/base-de-connaissances.md) {% endcontent-ref %} ### Comment un logement utilise ses groupes Vous pouvez lier un logement à **autant de groupes que vous voulez** (aucune limite technique imposée). Quand vous liez plusieurs groupes, vous leur attribuez un **ordre de priorité** : priorité 1, priorité 2, etc. ``` Logement "Appartement Croix-Rousse" │ ┌───────────────┼───────────────┐ │ │ │ Priorité 1 Priorité 2 Priorité 3 │ │ │ "Maisons "Logements "Tous mes centre-ville pet-friendly" logements" Lyon" ``` Cet ordre est important pour la résolution des instructions (voir ci-dessous). ### Comment l'IA résout votre base de connaissances Quand un voyageur envoie un message, l'IA assemble la base de connaissances effective pour ce logement. Deux règles, selon le type de contenu : #### a) Pour les informations additionnelles : toutes sont fusionnées Toutes les informations atteignables (logement + tous ses groupes) sont **agrégées en une seule liste** sans déduplication. L'IA reçoit la totalité. Conséquence pratique : si vous mettez la même information à plusieurs niveaux, l'IA verra les deux versions. Évitez les doublons en plaçant chaque information **au bon niveau** (la spécificité ↔ logement, la généralité ↔ groupe). Pour éviter les informations contradictoires, chaque fois que vous ajoutez ou modifier une information sur un logement ou un groupe de connaissances, l'IA assemble et analyse la base de connaissances et vous prévient de tout conflit potentiel avant une sauvegarde définitive. #### b) Pour les instructions système : règle de priorité avec héritage Pour les 18 instructions système livrées d'office, Mr Sherlock applique une logique de **valeur la plus prioritaire gagne** par sujet. Pour chaque instruction (identifiée par son sujet métier, par exemple « problème majeur signalé ») : 1. **Si vous avez personnalisé cette instruction au niveau du logement** → c'est votre version personnalisée qui s'applique. ✅ 2. **Sinon, si un de vos groupes liés couvre ce sujet** → c'est la version du groupe le plus prioritaire qui s'applique. ✅ 3. **Sinon, c'est la valeur par défaut au niveau du logement qui s'applique** (celle livrée par Mr Sherlock). ✅ Cette logique a un intérêt clé : si vous liez un logement à un groupe « Maisons centre-ville » qui définit une version de l'instruction « problème majeur », **votre logement utilise automatiquement la version du groupe,** sauf si vous avez explicitement personnalisé cette instruction au niveau du logement. #### c) Pour les instructions personnalisées : toutes sont fusionnées Comme pour les informations, vos instructions personnalisées (sans clé système) sont **toutes appliquées en union,** celles du logement et celles de tous les groupes liés. Pas de surcharge entre elles. Pour éviter les instructions contradictoires, chaque fois que vous ajoutez ou modifier une instruction sur un logement ou un groupe de connaissances, l'IA assemble et analyse la base de connaissances et vous prévient de tout conflit potentiel avant une sauvegarde définitive. ### Personnaliser ou réinitialiser une instruction système Sur l'écran **Instructions IA** de chaque logement, vous voyez l'état de chaque instruction : * **Personnalisée** → vous avez explicitement modifié cette instruction au niveau du logement. * **Valeur par défaut système** → l'instruction est à sa valeur d'origine, prête à être remplacée par un groupe. * **Hérité de \[nom du groupe]** → l'instruction effective vient d'un de vos groupes liés. Deux actions sont disponibles : #### « Personnaliser pour ce logement » Sur une instruction héritée d'un groupe (ou en valeur par défaut), vous pouvez créer une version spécifique au logement. Vous écrivez votre version, elle prend immédiatement la priorité sur le groupe. #### « Réinitialiser à l'héritage » Sur une instruction que vous avez personnalisée, vous pouvez **revenir** à la version héritée du groupe (ou à la valeur par défaut). Votre version personnalisée n'est pas supprimée, elle est conservée en base et redeviendra disponible si vous re-personnalisez plus tard. ### Schéma récapitulatif ``` Workspace │ ├── Groupe de connaissance "Maisons centre-ville Lyon" │ ├── Instructions │ │ ├── access-issues (personnalisée pour le groupe) │ │ ├── major-issue-reported (valeur par défaut système) │ │ └── ... (16 autres instructions système par défaut) │ └── Informations additionnelles │ ├── "Parking : 15€/jour, parking St-Antoine à 200m" │ └── "Check-in : 16h, code interphone communiqué la veille" │ ├── Groupe de connaissance "Pet-friendly" │ └── ... │ └── Logement "Appartement Croix-Rousse" ├── Données de présentation (titre, adresse, photos, équipements, capacité...) ├── Liens vers groupes : "Maisons centre-ville Lyon" (P1), "Pet-friendly" (P2) ├── Instructions propres au logement │ ├── access-issues (héritée du groupe → modifiable) │ └── ... (les 17 autres : héritées) └── Informations additionnelles propres au logement └── "Interphone capricieux : sonner 2 fois" ``` ### Détection automatique de conflits Quand vous ajoutez ou modifiez une instruction ou une information, Mr Sherlock vérifie **automatiquement** qu'elle ne contredit pas ce qui existe déjà dans la base de connaissances effective de ce logement (instructions + informations des groupes liés et du logement). Si un conflit est détecté, vous recevez un message d'erreur expliquant **avec quels éléments existants** votre nouvelle entrée entre en contradiction. Vous pouvez : * modifier votre saisie pour résoudre le conflit ; * forcer la sauvegarde si vous savez que la nouvelle règle prime (option **Forcer la sauvegarde**). *** ## Les paramètres IA Les paramètres IA pilotent **comment** votre assistant s'exprime et se comporte. Ils sont organisés sur 2 ou 3 niveaux selon le paramètre concerné. ### Les trois niveaux possibles | Niveau | Quand l'utiliser | | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------- | | **Workspace** | Réglages qui doivent s'appliquer à tous vos logements par défaut (signature, ton, voix de l'hôte). | | **Groupe de paramètres** | Un sous-ensemble de logements partage des réglages communs (ex. : « tous mes logements premium ont une voix plus formelle »). | | **Logement** | Réglages spécifiques à un logement (ex. : « ce logement-ci envoie automatiquement les réponses, les autres restent en mode brouillon »). | {% hint style="info" %} **Différence clé avec la base de connaissances :** un logement ne peut être lié qu'à **un seul groupe de paramètres** (pas plusieurs avec priorité). {% endhint %} {% content-ref url="/pages/SFCw0dbC8hmqh6f0iRGz" %} [Groupes de paramètres](/logements/groupes-de-parametres.md) {% endcontent-ref %} ### Règle d'héritage Pour chaque paramètre : 1. **Si vous l'avez défini explicitement au niveau du logement** → c'est cette valeur qui s'applique. 2. **Sinon, si le logement est lié à un groupe de paramètres et que le groupe le définit** → c'est la valeur du groupe. 3. **Sinon, si le paramètre est disponible au niveau workspace** → c'est la valeur du workspace. 4. **Sinon** → c'est la valeur par défaut de Mr Sherlock. L'interface vous montre toujours, pour chaque paramètre : * la **valeur effective** (celle qui s'applique) ; * la **source** (logement / groupe / workspace / défaut). Vous pouvez donc savoir d'un coup d'œil si un paramètre est hérité ou s'il a été spécialisé pour ce logement. ### Catalogue exhaustif des paramètres IA #### Catégorie 1 - Messaging (style et signature) Ces paramètres pilotent **comment l'IA rédige** ses messages. **Configurables aux 3 niveaux** (workspace → groupe → logement). | Paramètre | Ce que ça fait | Valeurs possibles | Défaut | | -------------------------------------- | -------------------------------------------------------------------- | ------------------------------------- | ------------- | | **Signature** | Texte ajouté en bas de chaque message | Texte libre (max 50 caractères) | *(Prénom)* | | **Signature activée** | Apposer ou non la signature | Oui / Non | Oui | | **Style de ton** | Registre de langue de l'IA | Professionnel / Amical / Personnalisé | Professionnel | | **Voix de l'hôte** | Le pronom utilisé par l'IA | « Nous » / « Je » | « Nous » | | **Instructions de ton personnalisées** | Consignes libres sur le ton (utilisées quand *Style = Personnalisé*) | Texte libre (max 5 000 caractères) | *(vide)* | {% hint style="info" %} **Astuce** : vous pouvez générer des instructions de ton personnalisées **assistées par IA** depuis l'écran de paramètres (workspace, groupe ou logement) en cliquant sur **Générer** et fournissant des indications de style souhaité. {% endhint %} {% content-ref url="/pages/ovBTFRiCu6jPKi3MJUc8" %} [Messagerie IA](/configuration/messagerie-ia.md) {% endcontent-ref %} #### Catégorie 2 - Comportement IA messaging Ces paramètres pilotent **quand** et **comment** l'IA répond. **Configurables sur 2 niveaux** (groupe → logement). Pas de défaut au niveau workspace. | Paramètre | Ce que ça fait | Valeurs possibles | Défaut | | --------------------------------------- | -------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | ------------- | | **Envoi automatique** | L'IA envoie ses réponses automatiquement ou les met en brouillon | Activé / Désactivé | Désactivé | | **Plages horaires d'envoi automatique** | Limiter l'envoi automatique à certaines heures / jours | Planning hebdomadaire | *(aucune)* | | **Délai d'envoi** | Délai en minutes entre la réception et la génération (pour paraître plus humain) | 0 à N minutes | 0 | | **Comportement sur urgence** | Que fait Mr Sherlock si une urgence est détectée ? | Mode copilote (vous propose un brouillon) / Désactiver Mr Sherlock pour ce logement / Aucune action | Mode copilote | #### Catégorie 3 - Voice IA (assistant téléphonique) Ces paramètres pilotent l'**agent vocal** qui prend les appels des voyageurs. **La plupart sont configurables aux 3 niveaux** (workspace → groupe → logement). Seul **Voice IA activé** reste sur 2 niveaux (groupe → logement). | Paramètre | Ce que ça fait | Niveaux | Valeurs possibles | Défaut | | ------------------------------------ | ---------------------------------------------------- | ----------------------------- | --------------------------- | ---------- | | **Voice IA activé** | L'agent vocal IA répond aux appels | Groupe + Logement | Activé / Désactivé | Désactivé | | **Plage horaire Voice IA** | Limiter les heures où l'agent vocal prend les appels | Workspace + Groupe + Logement | Planning hebdomadaire | *(aucune)* | | **Transfert d'appel activé** | Activer le transfert vers un humain | Workspace + Groupe + Logement | Activé / Désactivé | Désactivé | | **Plage horaire de transfert** | Limiter les heures où le transfert est actif | Workspace + Groupe + Logement | Planning hebdomadaire | *(aucune)* | | **Numéro de transfert** | Numéro à appeler en cas de transfert | Workspace + Groupe + Logement | Numéro de téléphone | *(vide)* | | **Membre destinataire du transfert** | Membre de l'équipe à appeler en transfert | Workspace + Groupe + Logement | Sélection parmi les membres | *(aucun)* | {% hint style="info" %} **Configuration recommandée** : définissez vos paramètres voice par défaut **au niveau workspace** (numéro de transfert principal, plages horaires standards). Spécialisez ensuite par **groupe** (ex. : vos studios premium ont un autre numéro de transfert) ou par **logement** quand nécessaire. Tous les logements qui n'ont pas de configuration spécifique hériteront automatiquement du niveau supérieur. {% endhint %} {% hint style="info" %} Vous pouvez configurer **séparément** les plages horaires *Voice IA prend l'appel* et *Voice IA transfère vers humain*. Vous pouvez par exemple décider : entre 22 h et 8 h l'agent prend les appels seul (pas de transfert pour ne pas vous réveiller), entre 8 h et 22 h l'agent peut transférer si nécessaire. {% endhint %} {% hint style="warning" %} **Cas particulier - appels entrants non identifiés** : quand un voyageur appelle depuis un numéro que Mr Sherlock ne reconnaît pas (pas de réservation associée), l'IA ne peut pas savoir de quel logement il s'agit. Dans ce cas, c'est la **configuration voice du workspace** qui est utilisée comme valeur de référence (numéro de transfert, plage horaire, etc.). Configurez donc ce niveau pour couvrir ce scénario. {% endhint %} {% content-ref url="/pages/SmDy9n5WaXsTpDLS90Ly" %} [Voice IA](/configuration/voice-ia.md) {% endcontent-ref %} ### Comportement détaillé du paramètre maître *IA activée* Au niveau du logement, un paramètre spécial **active ou désactive complètement l'IA** : * **IA activée : Oui** → l'IA fonctionne normalement (en suivant les paramètres ci-dessus). * **IA activée : Non** → l'IA est totalement inactive sur ce logement. Aucune réponse, aucun traitement. C'est utile par exemple pour les logements en cours de mise en service ou les biens temporairement indisponibles. ### Personnaliser ou réinitialiser un paramètre Sur chaque écran de paramètres d'un logement, chaque ligne affiche : * la **valeur effective** ; * un indicateur de la **source** : *Défini au logement* / *Hérité du groupe X* / *Hérité du workspace* / *Valeur par défaut*. Pour personnaliser un paramètre au niveau du logement : il suffit de modifier la valeur. Elle devient alors **explicite au niveau du logement**. Pour repasser à l'héritage : vider le champ (ou utiliser l'action **Réinitialiser** si disponible). La valeur effective redevient celle du niveau supérieur (groupe ou workspace). ### Schéma récapitulatif ``` Workspace "Mon agence" │ ├── Paramètres niveau Workspace │ ├── Signature : "Cordialement, l'équipe X" │ ├── Style de ton : Amical │ ├── Voix de l'hôte : "Nous" │ ├── Instructions de ton personnalisées : (vide) │ ├── Numéro de transfert voice : "+33 1 23 45 67 89" │ ├── Membre destinataire transfert : Alice │ └── Plage horaire transfert : 8h-22h, lundi-vendredi │ ├── Groupe de paramètres "Studios premium" │ ├── Signature : (hérité du workspace) │ ├── Style de ton : Professionnel (override !) │ ├── Envoi automatique : Activé entre 8h et 22h │ ├── Délai d'envoi : 5 minutes │ ├── Voice AI activé : Oui │ └── Numéro de transfert voice : "+33 1 99 99 99 99" (override, équipe dédiée premium) │ └── Logement "Studio Vieux-Lyon premium" ├── Groupe de paramètres lié : "Studios premium" ├── Style de ton : (hérité du groupe → Professionnel) ├── Voix de l'hôte : (hérité du workspace → "Nous") ├── Numéro de transfert voice : (hérité du groupe → "+33 1 99 99 99 99") ├── Plage horaire transfert : (hérité du workspace → 8h-22h) ├── Envoi automatique : Désactivé (override local !) └── ... ``` *** ## Les notifications Les notifications sont gérées **différemment** des autres paramètres : il n'y a pas d'héritage workspace → groupe → logement classique. Deux mécanismes coexistent. ### Canaux de notification (par membre de l'équipe) Chaque **membre de votre équipe** configure ses propres canaux de notification depuis son profil. Pour chaque événement déclencheur, il choisit indépendamment : * **Push** (app mobile) * **Email** C'est **par membre**, pas par logement. Si vous avez 3 membres dans votre équipe, chacun choisit ses propres canaux. {% content-ref url="/pages/3M0J5ZImF1f5GftxkUi9" %} [Paramètres de notifications](/gestion-du-profil/parametres-de-notifications.md) {% endcontent-ref %} #### Événements déclencheurs (catégorisés) **Messagerie (par sévérité du message voyageur) :** * Nouveau message informatif * Nouveau message important * Nouveau message prioritaire * Nouveau message urgent **Réponses Mr Sherlock :** * Réponse en attente de validation * Réponse en cours de génération * Réponse envoyée * Échec de génération **Appels téléphoniques (Voice IA) :** * Appel identifié démarré * Appel non identifié démarré * Appel transféré * Appel terminé * Échec d'appel * Nouveau message vocal du voyageur * Message vocal urgent du voyageur * Message vocal de Mr Sherlock **Avis (reviews) :** * Nouvelle réponse aux avis générée par Mr Sherlock **Caution :** * Caution prise avec succès * Échec de prise de caution **Service additionnel :** * Commande de service en attente * Commande de service réussie * Commande de service échouée {% hint style="info" %} Chaque événement peut être activé sur plusieurs canaux simultanément (ex. : Push + email pour les urgences, push uniquement pour les messages informatifs). {% endhint %} ### Critères de sévérité des messages voyageur (3 niveaux) C'est ici qu'intervient la **hiérarchie 3 niveaux** côté notifications. Vous définissez **ce qu'est un message urgent / prioritaire / important / informatif** pour vous, en langage naturel. #### Les 4 niveaux de sévérité | Sévérité | À quoi ça correspond typiquement | | --------------- | ------------------------------------------------------------------------------------- | | **Informatif** | Message qui n'attend pas de réponse urgente (remerciement, info anodine) | | **Important** | Message qui demande une attention rapide (question sur un équipement) | | **Prioritaire** | Message qui doit être traité en priorité (problème technique non bloquant) | | **Urgent** | Message critique nécessitant une réaction immédiate (sécurité, hébergement compromis) | #### Comment vous définissez ces niveaux Pour chaque sévérité, vous écrivez **des critères en langage naturel** (« Tout message mentionnant un problème de sécurité ou de chauffage », « Tout message demandant un dépannage »…). L'IA s'appuie sur ces critères pour classer chaque message entrant. #### Configurables à 3 niveaux ``` Workspace "Mon agence" └── Critères de sévérité : ├── Urgent : "Mention de sécurité, fuite, panne majeure, agression" ├── Prioritaire : "Demande de dépannage, panne d'équipement essentiel" ├── Important : "Question sur équipement, demande de service" └── Informatif : "Remerciement, information anodine" Groupe de paramètres "Studios étudiants" └── Critères de sévérité (override pour ce groupe) : ├── Urgent : "Sécurité, fuite, intrusion" └── (les autres niveaux héritent du workspace) Logement "Studio location longue durée" └── Critères de sévérité (override pour ce logement précis) : └── ... ``` **Règle d'héritage des critères :** * Si le logement définit ses propres critères → on utilise ceux du logement. * Sinon, si le groupe en définit → on utilise ceux du groupe. * Sinon → on utilise ceux du workspace. Cette résolution se fait **par sévérité indépendamment** : vous pouvez par exemple définir *Urgent* au niveau workspace et *Important* au niveau d'un groupe précis. #### Action « Réinitialiser » Vous pouvez supprimer tous les critères d'un niveau pour redonner la main au parent. {% content-ref url="/pages/TdRPW1Z3yYbesXfk8GqT" %} [Notifications](/configuration/notifications.md) {% endcontent-ref %} ### Qui reçoit les notifications ? Pour un événement donné, Mr Sherlock cherche **les membres de votre équipe** qui : 1. Ont accès au logement ou au workspace concerné (selon les permissions de chaque membre). 2. Ont **configuré leur canal pour cet événement** dans leurs préférences personnelles. Les voyageurs ne reçoivent jamais ces notifications, elles sont strictement internes à votre équipe. ### Schéma récapitulatif notifications ``` Workspace │ ├── Critères de sévérité (3 niveaux possibles) │ ├── niveau Workspace │ ├── niveau Groupe de paramètres │ └── niveau Logement │ └── Membres de l'équipe ├── Alice │ └── Notifications configurées par événement : │ ├── Message urgent : Email + Push │ ├── Message prioritaire : Push │ └── ... ├── Bob │ └── ... └── Carole └── ... ``` *** ## Cas pratiques ### Cas 1 - Onboarding d'un portefeuille homogène **Situation :** vous gérez 25 studios similaires à Lyon. **Recommandation :** 1. Au **niveau workspace** : signature, style de ton (amical), voix (« Nous »). 2. Créez **un groupe de paramètres** « Studios Lyon » avec : * Envoi automatique activé 8 h-22 h * Délai d'envoi 3 minutes * Voice IA activé 3. Créez **un groupe de connaissance** « Studios Lyon » avec : * Toutes vos infos pratiques communes (Wi-Fi, ménage, check-in, transports). * Personnalisation éventuelle de quelques instructions système (ex. : ajuster la formulation de *problème mineur*). 4. Liez chacun des 25 logements au groupe de paramètres ET au groupe de connaissance. **Résultat :** 5 minutes par logement supplémentaire pour onboarder. La quasi-totalité de la connaissance est mutualisée. ### Cas 2 - Un logement avec une particularité **Situation :** parmi vos 25 studios, un seul a un chat hypoallergénique présent en permanence (allergiques à signaler aux voyageurs avant de réserver). **Recommandation :** 1. Au **niveau du logement** uniquement, ajoutez **une information additionnelle** : * Catégorie : Règles * Titre : *« Chat hypoallergénique »* * Valeur : *« Ce logement abrite un chat hypoallergénique. Les voyageurs allergiques doivent être prévenus. »* 2. **Tout le reste reste hérité** du groupe - pas de duplication, pas de re-saisie. ### Cas 3 - Saisonnalité des notifications **Situation :** votre studio étudiant en région touristique reçoit en hiver des locations étudiantes (peu d'urgences), en été des locations touristiques (plus de demandes urgentes). **Recommandation :** 1. Au **niveau du logement**, ajustez les **critères de sévérité** pour la haute saison : *Urgent* devient plus large (ex. : « Problème de propreté, équipement clé, accès ») pour réagir plus vite aux problèmes touristes. 2. Hors saison, **Réinitialiser** les critères du logement → le logement reprend les critères du groupe ou du workspace, plus restrictifs. ### Cas 4 - Liaison d'un logement existant à un groupe (post-onboarding) **Situation :** vous avez 10 logements déjà onboardés individuellement. Vous voulez maintenant créer un groupe « Maisons centre-ville » et y rattacher 4 d'entre eux. **Comportement attendu :** 1. Vous créez le groupe de connaissance et y mettez les informations / instructions communes. 2. Vous liez les 4 logements au groupe. 3. **Sur chaque logement lié, l'IA utilise désormais en priorité les instructions du groupe** pour tous les sujets où le logement n'a pas été personnalisé. 4. Sur l'écran **Instructions IA** de chaque logement, vous voyez immédiatement quelles instructions sont héritées du groupe (badge **Hérité de Maisons centre-ville**) et lesquelles restent en valeur par défaut. 5. Si vous aviez personnalisé une instruction sur le logement avant la liaison, **votre version reste prioritaire** - vous pouvez cliquer sur **Réinitialiser à l'héritage** si vous voulez basculer sur la version du groupe. ### Cas 5 - Plusieurs groupes de connaissance pour un même logement **Situation :** un logement appartient à la fois à votre catégorie « Pet-friendly » ET à « Maisons centre-ville Lyon ». Vous voulez que les deux groupes contribuent à sa base de connaissances. **Comportement attendu :** 1. Vous liez le logement aux deux groupes avec un ordre de priorité (ex. : P1 = « Pet-friendly », P2 = « Maisons centre-ville Lyon »). 2. **Pour les informations additionnelles** : toutes celles des deux groupes + celles du logement sont fusionnées et envoyées à l'IA. 3. **Pour les instructions système** : si les deux groupes définissent une même instruction (ex. : *access-issues*), c'est la version du groupe **P1 « Pet-friendly »** qui s'applique (priorité supérieure). {% hint style="info" %} **L'ordre de priorité compte** : placez le groupe le plus spécifique en P1, le plus générique en P2 ou plus. {% endhint %} ### Cas 6 - Configurer le transfert d'appels voyageurs sur tout votre portefeuille **Situation :** vous voulez qu'en cas d'appel voyageur que l'IA ne peut pas traiter, l'appel soit transféré à votre équipe d'astreinte. Vous n'avez pas envie de configurer ce numéro logement par logement. **Recommandation :** 1. Au **niveau workspace**, configurez : * **Numéro de transfert** : le numéro principal de votre équipe d'astreinte. * **Plage horaire de transfert** : par exemple 8 h-22 h tous les jours. * **Transfert activé** : Oui. 2. **Tous vos logements** héritent automatiquement de ces valeurs - pas besoin de re-saisir. 3. Pour un sous-ensemble spécifique (ex. : vos logements premium qui ont leur propre équipe d'astreinte) : * Créez un **groupe de paramètres** « Premium ». * Définissez-y un autre numéro de transfert. * Liez vos logements premium à ce groupe → ils utiliseront ce numéro à la place. 4. Pour un logement isolé avec un cas particulier (ex. : le propriétaire veut recevoir lui-même les appels) : * Au **niveau du logement**, définissez le numéro et le membre destinataire. * Ce logement override le groupe et le workspace. **Bonus - appels d'inconnus :** quand un voyageur appelle depuis un numéro que Mr Sherlock ne reconnaît pas (pas de réservation associée à ce numéro), l'IA utilise la configuration voice du **workspace** car elle ne sait pas à quel logement l'appel correspond. Configurer votre workspace garantit donc qu'aucun appel n'échappe au transfert. *** ## Glossaire | Terme | Définition | | --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Workspace** | Votre espace de travail Mr Sherlock. Contient tous vos logements, groupes, membres d'équipe, paramètres. | | **Logement** | Un bien immobilier géré. Niveau de configuration le plus spécifique. | | **Groupe de connaissance** | Conteneur de connaissances (instructions + informations additionnelles) mutualisé entre plusieurs logements. | | **Groupe de paramètres** | Conteneur de paramètres IA (ton, signature, voice, etc.) mutualisé entre plusieurs logements. Un logement = max 1 groupe de paramètres. | | **Information additionnelle** | Fait, description ou détail destiné à enrichir la base de connaissances de l'IA (équipements, règles, services, etc.). | | **Instruction** | Consigne opérationnelle qui pilote le comportement de l'IA face à un type de situation. | | **Instruction système** | Une des 18 instructions livrées par défaut avec Mr Sherlock (problème majeur, accès, perte d'objet, etc.). | | **Instruction personnalisée** | Instruction que vous créez vous-même pour un cas spécifique. | | **Comportement (d'une instruction)** | Action que l'IA doit prendre : gérer et notifier, transférer au gestionnaire, ou gérer en silence. | | **Effective / héritée / personnalisée** | Statut d'un paramètre ou d'une instruction sur un logement : *effective* = la valeur qui s'applique, *héritée* = vient du niveau supérieur, *personnalisée* = définie au niveau du logement. | | **Override** | Action de définir une valeur à un niveau plus bas que le niveau parent, ce qui remplace la valeur héritée. | | **Source d'un paramètre** | Indication d'où vient la valeur effective : logement, groupe, workspace ou défaut système. | | **Priorité d'un groupe** | Rang explicite (1, 2, …) attribué à un groupe pour un logement, qui détermine l'ordre de résolution quand plusieurs groupes définissent la même chose. | | **Sévérité (d'un message voyageur)** | Niveau d'urgence détecté par l'IA pour un message entrant : informatif, important, prioritaire ou urgent. | | **Critère de sévérité** | Règle en langage naturel qui définit ce qui doit être classé dans tel ou tel niveau de sévérité. | *** **Besoin d'aide ?** Contactez l'équipe Mr Sherlock via le chat du site web, WhatsApp ou par e-mail à . --- # 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/commencer/organiser-par-niveaux.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.