> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.thais-pms.fr/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Assistant IA — tout ce que vous pouvez lui demander (guide complet)

L'**Assistant IA** est intégré directement dans Thaïs : il répond à vos questions en langage normal en allant chercher l'information dans **vos** données. Pas de tableau croisé dynamique à construire, pas d'écran à retrouver — vous posez la question, il travaille.

Ouvrez-le avec le bouton **Assistant IA** (icône ✨) du **menu latéral gauche**, ou par le raccourci clavier **⌘ / Ctrl + I** — depuis n'importe quel écran de Thaïs.

![Le panneau Assistant IA ouvert, prêt à recevoir une question](https://storage.crisp.chat/users/helpdesk/website/-/b/b/b/a/bbba504d0a985800/assistantvide_xhkf2p.jpg)

> ℹ️ **Prérequis** : un fournisseur de modèle doit être configuré dans **CONFIG → Chatbot IA**. Si l'assistant ne répond pas du tout, c'est presque toujours de ce côté qu'il faut regarder (clé API manquante ou compte sans crédit chez le fournisseur).

## Comment ça se passe, concrètement

1. Vous écrivez votre question dans le champ en bas du panneau (ou vous la **dictez** avec le bouton micro).
2. Vous cliquez sur **Envoyer**.
3. L'assistant affiche d'abord *« Réflexion en cours »*, puis *« Rédaction de la réponse »*, et enfin **le nom des outils qu'il a interrogés** — par exemple `list_arrivals` pour les arrivées ou `get_occupancy_forecast` pour le prévisionnel. C'est volontaire : vous voyez toujours d'où vient l'information.
4. La réponse s'affiche : du texte, un **tableau** ou un **graphique** selon la question.

> ⏱️ **Comptez 20 secondes à 2 minutes.** Une question simple (« combien de chambres libres ce soir ? ») revient en une trentaine de secondes ; une analyse croisée (météo + prévisionnel, plan de yield) demande 1 à 2 minutes. C'est normal : l'assistant interroge plusieurs outils avant de rédiger.

![L'assistant répond et affiche l'outil qu'il a interrogé](https://storage.crisp.chat/users/helpdesk/website/-/b/b/b/a/bbba504d0a985800/reponsedispo_12ddxde.jpg)

![Une réponse sous forme de graphique : l'occupation prévisionnelle sur 14 jours, avec l'outil `get_occupancy_forecast` affiché sous la réponse](https://storage.crisp.chat/users/helpdesk/website/-/b/b/b/a/bbba504d0a985800/assistantiagraphique1787749956_3tz2bj.jpg)

Pour obtenir une courbe plutôt qu'un tableau, demandez-le explicitement : « … et affiche un graphique ».

Sur chaque tableau, deux boutons vous font gagner du temps :

* **⛶ Agrandir** — affiche le tableau en plein écran, beaucoup plus confortable à lire.
* **Exporter CSV** — récupère le tableau dans Excel en un clic.

![Un tableau affiché en plein écran grâce au bouton Agrandir](https://storage.crisp.chat/users/helpdesk/website/-/b/b/b/a/bbba504d0a985800/vueagrandie_brlp5u.jpg)

Le bouton **Nouvelle conversation** repart de zéro : à utiliser quand vous changez complètement de sujet, pour éviter que l'assistant garde le contexte précédent en tête.

---

# Tout ce que vous pouvez lui demander

## 🛏️ Disponibilités et prévisionnel

| Ce que vous pouvez demander | Exemple de question |
| ---- |
| Chambres totales, occupées, libres et bloquées (NPL) à une date, globalement ou par type | « Combien de Suites sont libres ce soir ? » |
| Taux d'occupation du jour (source APR, cohérente avec vos OTA) | « Quel est le TO aujourd'hui ? » |
| Courbe d'occupation jour par jour (90 jours par défaut, 1 an maximum) | « Montre-moi l'occupation prévisionnelle sur 30 jours » |
| Repérer les trous ou les jours pleins | « Où sont mes trous en septembre ? » / « Quels jours sont pleins en décembre ? » |

![Le prévisionnel d'occupation jour par jour, suivi des recommandations de l'assistant](https://storage.crisp.chat/users/helpdesk/website/-/b/b/b/a/bbba504d0a985800/previsionnel_ow261o.jpg)

## 💰 Tarifs

| Ce que vous pouvez demander | Exemple de question |
| ---- |
| Prix d'un séjour pour un type de chambre, un régime et des dates, avec le nombre d'adultes, enfants et bébés | « Quel est le tarif pour une Chambre Double en demi-pension du 10 au 15 octobre ? » |

## 📅 Réservations au quotidien

| Ce que vous pouvez demander | Exemple de question |
| ---- |
| **Arrivées** du jour ou d'une date : n° de réservation, chambres attribuées, montant, régime, provenance | « Qui arrive demain ? » |
| **Départs** du jour ou d'une date, avec chambres libérées et montant | « Qui quitte l'hôtel aujourd'hui ? » |
| **Séjours en cours** (clients en house) : chambres occupées, montant restant, régime, date de départ | « Qui est présent dans l'hôtel ce week-end ? » |
| Recherche par **période de séjour**, avec filtres nom, régime, provenance, statut | « Quelles réservations pour le week-end du 15 août ? » |
| Recherche par **date de création** ou d'annulation | « Quelles réservations ont été créées hier ? » / « Combien d'annulations en mars ? » |
| **Détail complet** d'une réservation : hébergements, extras, taxe de séjour, paiements, totaux HT/TTC | « Détaille la réservation #123 » |
| **Options et e-bookings** en attente, avec date d'expiration | « Quelles options expirent cette semaine ? » |

![Les arrivées du lendemain : client, réservation, chambre, montant et statut](https://storage.crisp.chat/users/helpdesk/website/-/b/b/b/a/bbba504d0a985800/tableauarrivees_8o0blo.jpg)

## 📈 Revenue management et pilotage

| Ce que vous pouvez demander | Exemple de question |
| ---- |
| **Chiffres clés** d'une période : CA HT/TTC (hébergement, extras, total), TO moyen, RevPAR, ADR, nuitées, personnes | « Quel est le CA du mois de juillet ? » / « Quel est le RevPAR pour août ? » |
| **Comparaison de deux périodes**, avec variations en % et en points | « Comment se compare juin 2026 à juin 2025 ? » |
| **Répartition du CA** par provenance, régime, type de chambre, nationalité, groupe client, code promo, délai de réservation… | « Quelle part de CA fait Expedia ? » / « D'où viennent mes clients ? » |
| **Pickup** : ce qui a été réservé entre deux dates pour une même période de séjour | « Combien de nuitées ai-je prises pour juillet depuis 7 jours ? » |
| **Plan de yield global** sur les 6 prochains mois : rythme de réservation vs l'an dernier au même stade, lecture par mois et par jour de semaine, périodes à traiter | « Yielde mon hôtel pour les 3 prochains mois » |
| **Recommandations date par date** : occupation, nuitées vs l'an dernier, prix d'appel, séjour minimum, arrêt de vente, avec action conseillée (monter, baisser, vérifier) | « Sur quelles dates dois-je revoir mes prix en septembre ? » |

## 🌦️ Signaux externes

| Ce que vous pouvez demander | Exemple de question |
| ---- |
| **Météo** sur 16 jours : températures, précipitations, ensoleillement | « Quel temps fera-t-il ce week-end ? » |
| **Fréquentation ferroviaire** de votre ville : voyageurs annuels en gare (source SNCF, France uniquement) | « La destination attire-t-elle plus de voyageurs ? » |

## 👤 Clients

| Ce que vous pouvez demander | Exemple de question |
| ---- |
| Recherche par nom, prénom, e-mail ou société (recherche partielle acceptée) | « Trouve le client Jean Dupont » |
| **Fiche détaillée** : coordonnées, historique des séjours passés et à venir, remarques, drapeaux (VIP, indésirable…), factures | « Quels séjours le client Jean Dupont a-t-il faits ? » |
| **Top clients** classés par CA net facturé sur une période | « Qui sont mes 10 meilleurs clients en 2026 ? » |

## 🍽️ Restaurant, extras et services

| Ce que vous pouvez demander | Exemple de question |
| ---- |
| **Extras consommés** sur une période (petits-déjeuners, repas, spa…), quantités et montants | « Combien de petits-déjeuners ont été servis ce mois-ci ? » |
| **Réservations restaurant** : directes et repas réservés en extra depuis une réservation hôtel | « Quelles réservations restaurant pour ce soir ? » |
| **Tickets restaurant** par période, table ou serveur | « Quels tickets ont été ouverts hier ? » |
| **Réservations de services** : spa, activités, day-use | « Quelles réservations spa pour ce week-end ? » |
| **Cartes cadeaux** par acheteur, bénéficiaire, statut ou période | « Liste les cartes cadeaux actives » |
| **Devis événements et séminaires** : détail des lignes, acomptes, et statistiques (nombre, CA, panier moyen, taux de conversion) | « Quel est le CA événementiel en 2026 ? » |

## 🧾 Facturation et encaissements

| Ce que vous pouvez demander | Exemple de question |
| ---- |
| **Factures** par client ou par période, avec détail HT/TTC, TVA, solde et lignes | « Liste les factures du client #42 » |
| **Factures impayées** ou partiellement payées | « Quelles factures sont impayées ce mois-ci ? » |
| **Paiements** encaissés sur une période, avec ventilation par moyen de paiement | « Total des paiements CB en juillet » |
| **Taxe de séjour** collectée, ventilée par période et par pays d'origine — prête pour la déclaration | « Quel est le montant de la taxe de séjour à déclarer pour le 3ᵉ trimestre ? » |

## 🧹 Ménage

| Ce que vous pouvez demander | Exemple de question |
| ---- |
| État ménage des chambres à une date (propre, à faire, en recouche…) | « Quel est l'état ménage des chambres aujourd'hui ? » |
| Personnel de ménage actif | « Qui sont les housekeepers en service ? » |

## ⚙️ Votre paramétrage, en consultation

| Ce que vous pouvez demander | Exemple de question |
| ---- |
| Chambres et types de chambres | « Liste des types de chambres » |
| Régimes de restauration et codes promo (valides ou expirés) | « Liste les codes promo actifs » |
| Moyens de paiement et taux de TVA | « Quels moyens de paiement sont acceptés ? » |
| Provenances et motifs de réservation | « Quelles provenances sont configurées ? » |

## 🔧 Outils transverses

| Ce que vous pouvez demander | Exemple de question |
| ---- |
| **Export CSV** de n'importe quel tableau affiché | « Exporte la liste des arrivées de septembre en CSV » |
| **Logs et audit** : historique des modifications d'une réservation, d'un client, d'une chambre ; logs applicatifs et Channel Manager ; disponibilités et prix envoyés aux OTA | « Qui a modifié la réservation #123 ? » / « Quels logs Channel Manager pour Booking.com ce mois-ci ? » |
| Accès en lecture à n'importe quelle route de l'API Thaïs Hub | « Liste les articles du catalogue » |

---

## Ce qu'il ne fait pas (et c'est volontaire)

| Limite | Ce que ça implique pour vous |
| ---- |
| **Aucune modification de données** | Il ne crée pas, ne modifie pas et n'annule aucune réservation, aucune fiche client. Vous pouvez tout lui demander sans risque : au pire, il répond mal, il ne casse rien. |
| **Aucune donnée inventée** | Il répond à partir des outils listés sous chaque réponse. Quand une information n'est pas renseignée dans votre paramétrage, il le signale au lieu de la deviner (exemple réel : « les libellés des types de chambres ne sont pas renseignés » → il répond alors avec les identifiants). |
| **Aucune action externe** | Il n'envoie pas d'e-mail, n'imprime pas de facture et ne pousse rien vers vos OTA ou votre channel manager. |

## Trois réflexes de vérification

L'assistant est fiable sur la donnée qu'il va chercher, mais trois situations méritent votre œil :

| Situation | Ce que vous voyez | Le bon réflexe |
| ---- |
| **Liste longue tronquée** | « Le tableau ci-dessous affiche les 10 premières factures (sur 75 au total) » — et un total calculé juste en dessous | Le total peut n'être calculé **que sur l'extrait affiché**. Pour un chiffre qui part en comptabilité, demandez l'**export CSV** complet et recoupez avec l'écran Facturation. |
| **Analyse « pourquoi »** | « L'orage du 28 a probablement découragé les réservations de dernière minute » | C'est une **hypothèse**, pas une mesure. L'assistant l'annonce comme telle : traitez-la comme une piste à confirmer. |
| **Comparaison N-1 sur base vide** | « Juillet 2025 : 0 € — évolution non comparable » | L'assistant le signale : ne lisez pas la variation en %. Choisissez une autre période de référence. |

## Bien formuler sa demande

Quatre réflexes qui changent tout :

1. **Soyez précis sur la période.** « Quel est le CA pour juillet 2026 ? » donne un bien meilleur résultat que « Comment se passe juillet ? ».
2. **Donnez des dates plutôt que des repères flous.** « Du 10 au 15 août » vaut mieux que « ce week-end » — en cas d'ambiguïté, l'assistant vous demandera de confirmer.
3. **Demandez l'export** quand la liste est longue : « … et exporte-les en CSV ».
4. **Demandez un graphique** pour une évolution ou une répartition : « … et affiche-moi un graphique ».

| Question floue | Question efficace |
| ---- |
| « Comment va l'été ? » | « Compare le CA de juillet 2026 à juillet 2025 et ventile par provenance » |
| « Mes clients ? » | « Quels sont les 5 meilleurs clients en 2026 et quel est leur panier moyen ? » |
| « J'ai des trous ? » | « Quelles dates en septembre ont un taux d'occupation inférieur à 50 % ? » |

## 8 questions à copier-coller pour démarrer

* « Compare le CA de juillet 2026 à juillet 2025, et ventile par provenance. »
* « Quels sont les 5 meilleurs clients en 2026, et quel est leur panier moyen ? »
* « Quelles dates en septembre ont un taux d'occupation < 50 % ? Dois-je baisser mes prix ? »
* « Liste les réservations créées la semaine dernière pour Noël, et exporte-les en CSV. »
* « Quel est le pickup à 14 jours sur le week-end du 15 août ? »
* « Quels clients en house ce week-end ont réservé en demi-pension ? »
* « Quel est le montant de la taxe de séjour à déclarer pour le 3ᵉ trimestre 2026 ? »
* « Quelles options de réservation expirent dans les 7 prochains jours ? »

---

## Petits dépannages

| Ce que vous voyez | Ce qui se passe | Ce qu'il faut faire |
| ---- |
| *« Trop de requêtes en peu de temps »* | Vous avez enchaîné plusieurs questions très rapidement : l'assistant se protège | Patientez quelques instants avant de relancer |
| L'assistant ne répond à aucune question | Fournisseur de modèle mal configuré, ou compte sans crédit chez le fournisseur | Vérifiez **CONFIG → Chatbot IA** (clé API et fournisseur actif) |
| Une donnée est indiquée comme non renseignée | L'information est réellement absente de votre paramétrage | Complétez la fiche concernée dans **CONFIG** |
| La réponse ne correspond pas à la période voulue | Formulation ambiguë (« ce week-end », « le mois dernier ») | Reposez la question avec des dates explicites |
| L'assistant garde en tête un sujet précédent | La conversation en cours sert de contexte | Cliquez sur **Nouvelle conversation** |

**Une question sans réponse ?** Reformulez avec une date explicite : c'est la correction qui fonctionne dans la grande majorité des cas. Si l'assistant reste muet quelle que soit la question, vérifiez la configuration du fournisseur dans **CONFIG → Chatbot IA**. Notre équipe support reste joignable depuis le chat de Thaïs.