Intégration XWiki
Placez un assistant IA sur votre wiki, et laissez-le répondre à partir de vos pages
Aperçu
L'extension Asyntai pour XWiki fait deux choses. Elle place l'assistant de chat sur chaque page de votre wiki, et elle envoie vos pages à Asyntai pour que l'assistant y réponde. Votre personnel pose alors une question en mots simples au lieu de lire des centaines de pages.
Comment ça marche
La plupart des wikis sont derrière une connexion, donc aucun robot ne peut les lire. L'extension résout cela de l'intérieur : une tâche nocturne dans votre wiki envoie les pages nouvelles et modifiées à votre base de connaissances Asyntai. Seules les pages modifiées sont renvoyées, et une page que vous supprimez est retirée d'Asyntai à l'exécution suivante.
Prérequis
- XWiki 11.5 ou plus récent, avec le Scheduler XWiki fourni avec lui
- Des droits d'administration sur le wiki
- Un compte Asyntai. La création est gratuite, et le plan Free suffit pour le widget de chat.
- Un plan Asyntai payant pour la synchronisation de la base de connaissances, car elle utilise l'API Asyntai
Installation
Suivez ces étapes pour ajouter Asyntai à votre wiki :
Installer l'extension
Ouvrez Administration, puis Extensions, et cherchez Asyntai. Installez-la. Vous pouvez aussi importer le fichier XAR depuis Administration, puis Import.
Copier votre identifiant de widget
Ouvrez la page Installation dans votre tableau de bord Asyntai. Votre identifiant de widget est la valeur de data-asyntai-id dans le code affiché.
data-asyntai-id="asyntai_xxxxxxxxxxxx"
Collez-la dans le wiki
Ouvrez Administration, puis Autres, puis Asyntai. Collez votre identifiant de widget et enregistrez. L'assistant de chat apparaît aussitôt sur chaque page.
Ajoutez votre clé API
Sur le même écran, collez une clé API Asyntai et réglez Envoyer les pages du wiki à Asyntai sur Oui. Sautez cette étape si vous ne voulez que le widget de chat.
Démarrer la synchronisation
Ouvrez la page Asyntai depuis le panneau Applications. Appuyez sur Exécuter en mon nom désormais, puis sur Lancer la synchronisation maintenant. Ensuite la synchronisation s'exécute chaque nuit.
Astuce : Ajoutez vos documents, vos questions et réponses et vos instructions dans le tableau de bord Asyntai avant de publier, afin que l'assistant réponde correctement dès le premier visiteur.
Ce que la synchronisation envoie
- Le titre et le texte de chaque page, en texte brut, avec un lien vers le wiki
- Rien d'autre. Aucun nom d'utilisateur, et aucune donnée de visiteur.
- Les pages masquées ne sont jamais envoyées, donc les pages techniques restent hors de la base de connaissances
- Des espaces comme XWiki, Help et Sandbox sont exclus dès le départ, et vous pouvez en exclure d'autres
- Une page de moins de 120 caractères est une ébauche, donc elle est ignorée
Au nom de qui la synchronisation s'exécute
La tâche s'exécute au nom d'une personne nommée, et elle envoie exactement les pages que cette personne peut lire. Le bouton sur la page Asyntai désigne cette personne comme étant vous. C'est important, car toute personne qui peut utiliser l'assistant de chat peut ensuite poser des questions sur tout ce que la synchronisation a envoyé.
Le retirer
Désinstallez l'extension depuis Administration, puis Extensions. L'assistant de chat et la tâche de synchronisation disparaissent aussitôt. Les pages déjà envoyées restent dans votre base de connaissances Asyntai jusqu'à ce que vous les y supprimiez.
Confidentialité
Votre wiki envoie les titres et le texte des pages à Asyntai, et rien d'autre. Votre clé API est stockée sur une page que seuls les administrateurs peuvent lire. Laissez la synchronisation désactivée pour ne rien envoyer du tout ; le widget de chat fonctionne quand même. Politique de confidentialité.
Formules et tarifs
L'extension est gratuite. Le widget de chat fonctionne avec tous les plans Asyntai, y compris le plan Free. La synchronisation de la base de connaissances nécessite un plan payant, car elle utilise l'API Asyntai. Voir les tarifs.
Besoin d'aide ?
Si vous avez des questions ou rencontrez des problèmes, contactez-nous à [email protected].