mintlify__docs/fr/ai/assistant.mdx

---
title: "Assistant"
description: "Ajoutez à votre documentation un chat propulsé par l’IA qui répond aux questions, cite ses sources et génère des exemples de code."
keywords: ["chat", "RAG", "assistance utilisateur"]
---

<Info>
  L’Assistant est automatiquement activé sur les [offres Pro et Enterprise](https://mintlify.com/pricing?ref=assistant).
</Info>

<div id="about-the-assistant">
  ## À propos de l’Assistant
</div>

L’Assistant répond aux questions sur votre documentation via des requêtes en langage naturel. Les utilisateurs accèdent à l’Assistant directement sur votre site de documentation, afin qu’ils puissent trouver rapidement des réponses et réussir avec votre produit, même s’ils ne savent pas où chercher.

L’Assistant utilise un RAG agentique (retrieval-augmented generation) avec appel d’outils. Lorsque les utilisateurs posent des questions, l’Assistant :

* **Recherche et extrait** le contenu pertinent de votre documentation pour fournir des réponses précises.
* **Cite ses sources** et fournit des liens navigables pour amener les utilisateurs directement aux pages référencées.
* **Génère des exemples de code copiables** pour aider les utilisateurs à mettre en œuvre des solutions à partir de votre documentation.

Vous pouvez consulter l’utilisation de l’Assistant depuis votre Dashboard pour comprendre le comportement des utilisateurs et l’efficacité de votre documentation. Exportez et analysez les données de requête pour vous aider à identifier :

* Les questions fréquemment posées qui pourraient nécessiter une meilleure couverture.
* Les lacunes de contenu où les utilisateurs peinent à trouver des réponses.
* Les sujets populaires qui pourraient bénéficier de contenu supplémentaire.

<div id="how-indexing-works">
  ### Fonctionnement de l’indexation
</div>

L’Assistant indexe automatiquement votre documentation publiée afin de répondre précisément aux questions. Lorsque vous publiez des modifications, l’Assistant indexe immédiatement le contenu ajouté, mis à jour ou supprimé. L’Assistant n’indexe pas les branches de brouillon ni les déploiements de prévisualisation.

Par défaut, l’Assistant n’indexe pas les pages masquées. Pour inclure les pages masquées dans l’index de l’Assistant, définissez `seo.indexing: "all"` dans votre `docs.json`. Consultez [Pages masquées](/fr/organize/hidden-pages#search-seo-and-ai-indexing) pour plus d’informations.

<div id="how-the-assistant-handles-unknown-questions">
  ### Comment l’Assistant gère les questions inconnues
</div>

L’Assistant répond uniquement aux questions en s’appuyant sur les informations présentes dans votre documentation. S’il ne trouve aucune information pertinente après sa recherche, il indique qu’il n’a pas suffisamment d’informations pour répondre.

Vous pouvez [configurer un e-mail de redirection](/fr/ai/assistant#set-deflection-email) pour que l’Assistant fournisse votre adresse e-mail de support aux utilisateurs lorsqu’il ne peut pas répondre à leurs questions. Cela donne aux utilisateurs une voie à suivre, même si la documentation ne traite pas leur question spécifique.

<div id="configure-the-assistant">
  ## Configurer l’assistant
</div>

L’assistant est activé par défaut pour les offres Pro et Enterprise.

Gérez l’assistant depuis la page [Assistant Configurations](https://dashboard.mintlify.com/products/assistant/settings) de votre Dashboard. Activez ou désactivez l’assistant, configurez la gestion des réponses, ajoutez des questions par défaut et gérez votre quota de messages.

<div id="enable-or-disable-the-assistant">
  ### Activer ou désactiver l’Assistant
</div>

Activez ou désactivez l’Assistant pour votre site de documentation à l’aide de l’interrupteur dédié.

<Frame>
  <img src="/images/assistant/status-light.png" alt="L’interrupteur d’état de l’Assistant dans le Dashboard." className="block dark:hidden" />

  <img src="/images/assistant/status-dark.png" alt="L’interrupteur d’état de l’Assistant dans le Dashboard." className="hidden dark:block" />
</Frame>

<div id="set-deflection-email">
  ### Définir l’adresse e‑mail de redirection
</div>

Dans la section de gestion des réponses, activez l’Assistant pour rediriger vers votre équipe d’assistance les questions restées sans réponse.

Indiquez l’adresse e‑mail que l’Assistant communiquera aux utilisateurs lorsqu’il ne peut pas répondre à leur question. Vous pouvez également activer un bouton « Contacter l’assistance » pour qu’il apparaisse dans le panneau de discussion de l’Assistant.

<Frame>
  <img src="/images/assistant/deflection-light.png" alt="Le panneau de redirection de l’Assistant dans le Dashboard. La redirection de l’Assistant est activée et support@mintlify.com est défini comme adresse e‑mail de redirection." className="block dark:hidden" />

  <img src="/images/assistant/deflection-dark.png" alt="Le panneau de redirection de l’Assistant dans le Dashboard. La redirection de l’Assistant est activée et support@mintlify.com est défini comme adresse e‑mail de redirection." className="hidden dark:block" />
</Frame>

<div id="search-domains">
  ### Rechercher sur des domaines
</div>

Dans la section de traitement des réponses, configurez les domaines que l’Assistant peut utiliser pour la recherche web afin de trouver un contexte supplémentaire lorsqu’il répond aux questions.

* Les domaines doivent être publiquement accessibles.
* Les domaines qui nécessitent JavaScript pour se charger ne sont pas pris en charge.

<Frame>
  <img src="/images/assistant/search-domains-light.png" alt="Le panneau de recherche de domaines de l’Assistant activé dans le Dashboard. L’Assistant est configuré pour rechercher sur le domaine mintlify.com/pricing." className="block dark:hidden" />

  <img src="/images/assistant/search-domains-dark.png" alt="Le panneau de recherche de domaines de l’Assistant activé dans le Dashboard. L’Assistant est configuré pour rechercher sur le domaine mintlify.com/pricing." className="hidden dark:block" />
</Frame>

Pour contrôler plus précisément ce que l’Assistant peut rechercher, utilisez la syntaxe de filtrage.

* **Filtrage au niveau du domaine**
  * `example.com` : Rechercher uniquement sur le domaine `example.com`
  * `docs.example.com` : Rechercher uniquement sur le sous-domaine `docs.example.com`
  * `*.example.com` : Rechercher sur tous les sous-domaines de `example.com`
* **Filtrage au niveau du chemin**
  * `docs.example.com/api` : Rechercher sur toutes les pages sous le sous-chemin `/api`
* **Modèles multiples**
  * Ajoutez plusieurs entrées pour cibler différentes sections de sites

<div id="add-sample-questions">
  ### Ajouter des exemples de questions
</div>

Aidez vos utilisateurs à lancer des conversations avec l’Assistant en ajoutant des questions de départ. Ajoutez des questions fréquemment posées ou des questions sur des sujets que vous souhaitez que vos utilisateurs connaissent. Cliquez sur **Ask AI** pour obtenir des questions recommandées en fonction de votre documentation.

<Frame>
  <img src="/images/assistant/search-suggestions-light.png" alt="Le panneau Suggestions de recherche dans le Dashboard, avec les questions de départ activées et rempli de trois questions." className="block dark:hidden" />

  <img src="/images/assistant/search-suggestions-dark.png" alt="Le panneau Suggestions de recherche dans le Dashboard, avec les questions de départ activées et rempli de trois questions." className="hidden dark:block" />
</Frame>

<div id="manage-billing">
  ## Gérer la facturation
</div>

L’Assistant utilise des allocations de messages par palier. Un message correspond à toute interaction utilisateur avec l’Assistant qui reçoit une réponse correcte. Si vous avez des messages inutilisés, jusqu’à la moitié de votre allocation de messages peut être reportée sur le cycle de facturation suivant. Par exemple, si vous disposez d’une allocation de 1 000 messages et que vous en utilisez 300, 500 messages sont reportés sur le cycle de facturation suivant, ce qui vous donne un total de 1 500 messages pour le prochain cycle de facturation.

Par défaut, l’Assistant autorise les dépassements. Vous pouvez désactiver les dépassements pour éviter d’engendrer des coûts supplémentaires liés à une utilisation dépassant votre palier. Si vous atteignez votre allocation de messages et que les dépassements sont désactivés, l’Assistant devient indisponible jusqu’à la réinitialisation de votre allocation de messages. Si vous autorisez les dépassements, chaque message au-delà de votre allocation entraîne des frais de dépassement, mais des dépassements occasionnels peuvent être moins coûteux qu’une mise à niveau vers un palier supérieur, selon votre utilisation.

<div id="change-your-assistant-tier">
  ### Modifier le niveau de votre Assistant
</div>

Les niveaux de l’Assistant déterminent votre quota mensuel de messages et vos prix.

Consultez et modifiez votre niveau actuel dans l’[onglet Billing](https://dashboard.mintlify.com/products/assistant/settings/billing) de la page de l’Assistant dans votre Dashboard.

Dans la section **Spending Controls**, sélectionnez le niveau de votre choix dans le menu déroulant.

**Passer à un niveau supérieur :**

* Votre nouveau quota de messages s’applique immédiatement.
* Vous payez une différence calculée au prorata pour le cycle de facturation en cours.

**Passer à un niveau inférieur :**

* Votre quota de messages est mis à jour immédiatement.
* Les changements de prix prennent effet au début de votre prochain cycle de facturation.
* Les messages inutilisés de votre niveau actuel **ne sont pas** reportés.

<div id="allow-overages">
  ### Autoriser les dépassements
</div>

Si vous souhaitez interdire les dépassements, désactivez-les dans la section **Billing Controls** de l’[onglet Billing](https://dashboard.mintlify.com/products/assistant/settings/billing) de la page Assistant de votre Dashboard.

<div id="set-usage-alerts">
  ### Configurer des alertes d’utilisation
</div>

Dans la section Billing Controls, configurez des alertes d’utilisation pour recevoir un e-mail lorsque vous atteignez un certain pourcentage de votre quota de messages.

<div id="connect-apps">
  ## Connecter des applications
</div>

Dans la section Connecter des applications, ajoutez l&#39;Assistant à votre serveur [Discord](/fr/ai/discord) et à votre espace de travail [Slack](/fr/ai/slack-bot) pour permettre aux utilisateurs d&#39;obtenir des réponses à partir de votre documentation directement depuis ces plateformes.

<div id="assistant-insights">
  ## Informations de l’Assistant
</div>

Utilisez les insights de l’Assistant pour comprendre comment les utilisateurs interagissent avec votre documentation et identifier des opportunités d’amélioration.

La [page Assistant](https://dashboard.mintlify.com/products/assistant) affiche les tendances d’utilisation depuis le début du mois. Consultez des insights plus détaillés sur la page [Analytics](/fr/optimize/analytics#assistant).

<div id="make-content-ai-ingestible">
  ## Rendre le contenu exploitable par l’IA
</div>

Structurez votre documentation pour aider l’Assistant à fournir des réponses précises et pertinentes. Une organisation claire et un contexte complet profitent à la fois aux lecteurs humains et à la compréhension de l’IA.

<Card title="Structure et organisation">
  * Utilisez un balisage sémantique.
  * Rédigez des titres descriptifs pour les sections.
  * Créez une hiérarchie logique de l’information.
  * Utilisez une mise en forme cohérente dans toute votre documentation.
  * Incluez des métadonnées complètes dans le frontmatter de la page.
  * Scindez les longs blocs de texte en paragraphes plus courts.
</Card>

<Card title="Contexte">
  * Définissez les termes spécifiques et les acronymes lors de leur première apparition.
  * Fournissez un contenu conceptuel suffisant sur les fonctionnalités et les procédures.
  * Incluez des exemples et des cas d’usage.
  * Faites des renvois vers les sujets connexes.
  * Ajoutez des [pages cachées](/fr/organize/hidden-pages) avec du contexte supplémentaire dont les utilisateurs n’ont pas besoin, mais auquel l’Assistant peut se référer.
</Card>

Si vous souhaitez autoriser les dépassements, activez cette option dans la section **Billing Controls** de la page [Assistant Configurations](https://dashboard.mintlify.com/products/assistant/settings/billing) de votre Dashboard.

Vous pouvez également configurer des alertes d&#39;utilisation pour recevoir un e-mail lorsque vous atteignez un certain pourcentage de votre quota de messages.

<div id="use-the-assistant">
  ## Utiliser l’Assistant
</div>

Les utilisateurs disposent de plusieurs manières de démarrer une conversation avec l’Assistant. Chaque méthode ouvre un panneau de discussion sur le côté droit de votre documentation. Les utilisateurs peuvent poser n’importe quelle question et l’Assistant recherche une réponse dans votre documentation. Si l’Assistant ne parvient pas à récupérer d’informations pertinentes, l’Assistant indique qu’il ne peut pas répondre à la question.

Ajoutez l’Assistant en tant que bot à votre [espace de travail Slack](/fr/ai/slack-bot) ou à votre [serveur Discord](/fr/ai/discord) afin que votre communauté puisse poser des questions sans quitter sa plateforme préférée.

<div id="ui-placement">
  ### Emplacement dans l’interface
</div>

L’Assistant apparaît à deux emplacements : sous la forme d’un bouton à côté de la barre de recherche et sous la forme d’une barre en bas de la page.

<Columns cols={2}>
  <Frame caption="Bouton de l’Assistant à côté de la barre de recherche.">
    <img
      src="/images/assistant/assistant-button-light.png"
      className="block dark:hidden"
      style={{
width: '268px',
height: 'auto',
}}
      alt="Barre de recherche et bouton de l’Assistant en mode clair."
    />

    <img
      src="/images/assistant/assistant-button-dark.png"
      className="hidden dark:block"
      style={{
width: '268px',
height: 'auto',
}}
      alt="Barre de recherche et bouton de l’Assistant en mode sombre."
    />
  </Frame>

  <Frame caption="Bouton de l’Assistant en bas de la page.">
    <img
      src="/images/assistant/assistant-bar-light.png"
      className="block dark:hidden"
      style={{
width: '268px',
height: 'auto',
}}
      alt="Barre de l’Assistant en mode clair."
    />

    <img
      src="/images/assistant/assistant-bar-dark.png"
      className="hidden dark:block"
      style={{
width: '268px',
height: 'auto',
}}
      alt="Barre de l’Assistant en mode sombre."
    />
  </Frame>
</Columns>

<div id="keyboard-shortcut">
  ### Raccourci clavier
</div>

Ouvrez le panneau de discussion de l&#39;Assistant avec le raccourci clavier <kbd>Command</kbd> + <kbd>I</kbd> sur macOS et <kbd>Ctrl</kbd> + <kbd>I</kbd> sur Windows.

<div id="highlight-text">
  ### Mettre du texte en surbrillance
</div>

Mettez du texte en surbrillance sur une page, puis cliquez sur le bouton contextuel **Ajouter à l’Assistant** pour ouvrir le panneau de discussion de l’Assistant et ajouter le texte mis en surbrillance en tant que contexte. Vous pouvez ajouter plusieurs extraits de texte ou blocs de code au contexte de l’Assistant.

<Frame>
  <img src="/images/assistant/highlight-light.png" alt="Le bouton « Ajouter à l’Assistant » au-dessus du texte surligné en mode clair." className="block dark:hidden" />

  <img src="/images/assistant/highlight-dark.png" alt="Le bouton « Ajouter à l’Assistant » au-dessus du texte surligné en mode sombre." className="hidden dark:block" />
</Frame>

<div id="code-blocks">
  ### Code blocks
</div>

Cliquez sur le bouton **Ask AI** dans un code block pour ouvrir le panneau de discussion de l’Assistant et ajouter le code block comme contexte. Vous pouvez ajouter plusieurs code blocks ou extraits de texte au contexte de l’Assistant.

<Frame>
  <img src="/images/assistant/code-block-light.png" alt="Le bouton Ask AI dans un code block en mode clair." className="block dark:hidden" />

  <img src="/images/assistant/code-block-dark.png" alt="Le bouton Ask AI dans un code block en mode sombre." className="hidden dark:block" />
</Frame>

<div id="urls">
  ### URLs
</div>

Ouvrez l’Assistant avec un paramètre de requête dans l’URL pour créer des liens profonds qui guident les utilisateurs vers des informations spécifiques ou pour partager des conversations avec l’Assistant contenant des questions préremplies.

* **Ouvrir l’Assistant** : Ajoutez `?assistant=open` pour ouvrir le panneau de discussion de l’Assistant au chargement de la page.
  * Exemple : [https://mintlify.com/docs?assistant=open](https://mintlify.com/docs?assistant=open)
* **Ouvrir avec une requête préremplie** : Ajoutez `?assistant=YOUR_QUERY` pour ouvrir l’Assistant et soumettre automatiquement une question.
  * Exemple : [https://mintlify.com/docs?assistant=explain webhooks](https://mintlify.com/docs?assistant=explain%20webhooks)

<div id="troubleshooting">
  ## Dépannage
</div>

<Accordion title="Barre de chat de l’Assistant invisible">
  Si l’interface de l’Assistant n’est pas visible dans certains navigateurs, vous devrez peut-être signaler un faux positif à [EasyList](https://easylist.to). Les navigateurs qui utilisent la EasyList Cookies List, comme Brave et Comet, bloquent parfois l’Assistant ou d’autres éléments de l’interface. La EasyList Cookies List contient une règle spécifique à certains domaines qui masque les éléments fixes pour bloquer les bannières de cookies. Cette règle affecte par inadvertance des composants d’interface légitimes.

  Signalez un faux positif à [EasyList](https://github.com/easylist/easylist) pour demander la suppression de cette règle. Le problème sera alors résolu pour tous les utilisateurs une fois la liste de filtres mise à jour.
</Accordion>