Configurer l'assistant

Configurez l’assistant sur la page Assistant de votre tableau de bord. Gérez la facturation et l’utilisation sur la page Utilisation.

Basculez le statut de l’assistant pour l’activer ou le désactiver sur votre site de documentation.

Dans la section Gestion des réponses, activez l’assistant pour inviter les utilisateurs à contacter vos équipes de support et de ventes lorsqu’il ne peut pas répondre à une question par lui-même.

Renseignez l’une ou les deux adresses suivantes :

• Support : Pour les questions que l’assistant ne peut pas résoudre à partir de votre documentation.
• Ventes : Pour les questions sur les tarifs, les offres ou les achats.

Lorsque vous activez la redirection et que l’assistant détecte une question correspondante, un formulaire de contact s’affiche dans le chat. Le formulaire demande le prénom, le nom, l’entreprise, l’e-mail professionnel et un message de l’utilisateur. Mintlify envoie la soumission par e-mail à l’équipe appropriée, qui peut répondre directement à l’e-mail de l’utilisateur.

Le même formulaire de contact est disponible dans le widget de l’assistant intégré sur d’autres sites. Aucune configuration supplémentaire du widget n’est nécessaire.

Si vous préférez rediriger les questions de support vers vos canaux existants, désactivez Afficher le formulaire de contact dans la section Gestion des réponses. Lorsque le formulaire de contact est désactivé, l’assistant redirige les utilisateurs vers votre adresse e-mail de support en texte brut au lieu d’afficher le formulaire dans le chat. Les questions commerciales continuent d’utiliser le formulaire dans le chat lorsqu’un e-mail commercial est configuré. Ce paramètre est activé par défaut.

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

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

Pour un contrôle plus précis sur 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 toutes les pages sous le sous-chemin /api
• Plusieurs motifs
  • Ajoutez plusieurs entrées pour cibler différentes sections de sites

Aidez vos utilisateurs à démarrer des conversations avec l’assistant en ajoutant des questions de démarrage.

L’assistant peut générer des questions spécifiques à la page en fonction de la page consultée par l’utilisateur, ou vous pouvez ajouter des questions persistantes disponibles sur toutes les pages.

Vous pouvez ajouter jusqu’à trois questions de démarrage. Cliquez sur Demander à l’assistant pour obtenir des questions recommandées basées sur votre documentation.

Dans la section Protection contre les bots, activez le captcha invisible pour protéger votre assistant contre les abus automatisés. La protection contre les bots respecte la vie privée et est invisible pour la quasi-totalité des visiteurs.

Pour activer la protection contre les bots :

1. Accédez à la page Paramètres de l’assistant dans votre tableau de bord.
2. Dans la section Bot Protection, activez Invisible Captcha.

Les modifications prennent jusqu’à 10 minutes pour se propager.

L’assistant fonctionne avec des crédits. Chaque message de l’assistant consomme des crédits, un message correspondant à toute interaction utilisateur avec l’assistant qui reçoit une réponse. Pour en savoir plus, consultez Tarification par crédits.

1. Rendez-vous sur la page Utilisation de votre tableau de bord.
2. Dans la section Credit packages, sélectionnez un palier dans le menu déroulant.
3. Confirmez le changement pour passer au checkout.

Les crédits sont partagés au sein de votre organisation, mais les dépassements se configurent par déploiement. Mintlify désactive les dépassements par défaut. Lorsque les dépassements sont désactivés pour un déploiement, l’assistant de ce déploiement devient indisponible dès que le solde de crédits partagé de votre organisation est épuisé, et le reste jusqu’au renouvellement du solde.

Pour autoriser les dépassements, activez-les dans la section Spending controls de la page Utilisation de votre tableau de bord. Si vous activez les dépassements, chaque crédit dépensé au-delà du solde partagé entraîne un frais de dépassement.

Dans la section Spending controls de votre tableau de bord, configurez des alertes d’utilisation pour recevoir un e-mail lorsque votre organisation atteint un certain pourcentage de son solde de crédits partagé.

Si 10 000 crédits par mois ne suffisent pas, contactez l’équipe commerciale au sujet d’un plan Enterprise avec des forfaits de crédits personnalisés.