Aller au contenu principal
République du Burundi PNISAN Guide d'utilisation

Administrateurs

Assistant du portail public

Activer et régler l'assistant du portail public, comprendre ses modes de réponse et exploiter le journal anonymisé des questions posées.

L'assistant du portail public répond aux questions des visiteurs à partir des seuls contenus publiés sur la plateforme, en citant ses sources. Il se règle dans l'écran Paramètres, groupe Assistant du portail public, et son activité se suit dans l'écran Questions à l'assistant de l'onglet Contenus du portail (/administration/assistant). Les deux écrans exigent la permission Administrer les paramètres de la plateforme (parametres.gerer).

Fonctionnement #

Le visiteur ouvre l'assistant par le bouton flottant du portail ou par la page /assistant. Pour chaque question (600 caractères au plus), la plateforme recherche des passages dans :

  • les indicateurs publiés et leurs dernières valeurs nationales validées ;
  • les publications de la base documentaire ;
  • les actualités, les pages et les questions fréquentes publiées.

Trois issues sont possibles, qui correspondent aux trois modes de réponse du journal :

Mode (libellé du journal) Situation Ce que voit le visiteur
Rédigée Passages trouvés et passerelle Rafiki active Réponse brève rédigée par Rafiki, avec renvois numérotés vers les sources
Liste de contenus Passages trouvés, mais passerelle inactive, en échec, ou réponse écartée « Voici les contenus de la plateforme qui se rapportent à votre question. » suivi des liens
Aucun contenu Aucun passage pertinent Message invitant à reformuler ou à consulter les indicateurs et la base documentaire

Activer et régler l'assistant #

  1. Dans l'onglet Accès et paramètres, cliquez sur Paramètres.
  2. Dans le sommaire, cliquez sur Assistant du portail public.
  3. Réglez les champs décrits ci-dessous.
  4. Cliquez sur Enregistrer et vérifiez le message Paramètres enregistrés.
  5. Ouvrez le portail public dans un autre onglet : le bouton de l'assistant doit apparaître.
Paramètres, groupe Assistant du portail public
Paramètres, groupe Assistant du portail public
Réglage Défaut Rôle
Assistant du portail public Non Affiche le bouton et la page de l'assistant. Désactivé, la page /assistant et ses appels répondent « page introuvable »
Nom de l'assistant Assistant PNISAN Titre de la page et du panneau
Message d'accueil Texte de présentation Premier message affiché dans la conversation
Questions suggérées Quatre exemples Une question par ligne ; seules les quatre premières lignes sont affichées
Questions par visiteur et par jour 10 Quota individuel ; le visiteur voit le nombre de questions restantes
Réponses rédigées par jour, tous visiteurs confondus 300 Plafond global ; au-delà, l'assistant propose seulement les contenus pertinents jusqu'au lendemain
Mention sous l'assistant Avertissement Affichée sous la conversation et reprise dans les exports de conversation

Le nom, le message d'accueil, les questions suggérées et la mention ont chacun un champ Version anglaise ; laissé vide, le texte français s'affiche.

Quotas et messages au visiteur #

  • Quota individuel atteint : « Vous avez atteint le nombre de questions autorisées aujourd'hui. Vous pouvez consulter les indicateurs, la base documentaire ou la recherche du site. »
  • Plafond global atteint : « L'assistant a atteint sa capacité quotidienne. Réessayez demain ou utilisez la recherche du site. »
  • Incident technique : « La réponse n'a pas pu être obtenue. Réessayez dans un instant. »

Le plafond global ne compte que les appels effectivement adressés à Rafiki. Les questions sans contenu pertinent ou traitées en liste de contenus quand la passerelle est inactive n'y sont pas imputées, mais elles comptent dans le quota du visiteur.

Le visiteur peut Effacer la conversation et l'Exporter au format PDF, Markdown, texte ou JSON.

Suivre les questions posées #

L'écran Questions à l'assistant (onglet Contenus du portail) présente « Questions posées sur le portail public, anonymisées, pour repérer les contenus manquants et améliorer les réponses. »

Écran Assistant du portail dans la console
Écran Assistant du portail dans la console

Les indicateurs d'état #

En tête d'écran, quatre cartes :

Carte Contenu
État active ou inactive, selon le réglage Assistant du portail public
Passerelle Rafiki active si l'interrupteur est activé et que l'adresse et la clé du service sont configurées
Questions aujourd'hui Nombre de questions reçues depuis minuit
Sans contenu pertinent (30 jours) Questions restées en mode Aucun contenu sur les trente derniers jours

Le tableau des questions #

Le filtre Réponse (Toutes, Rédigée, Liste de contenus, Aucun contenu) puis le bouton Filtrer restreignent la liste. Les questions s'affichent de la plus récente à la plus ancienne, quarante par page.

Colonne Contenu
Date Jour et heure de la question
Question Texte anonymisé
Réponse Mode de réponse ; la mention Réponse écartée par le contrôle des chiffres signale une réponse rédigée qui contenait un chiffre absent des sources
Sources Nombre de contenus cités ou proposés

Si aucune question n'a été posée, l'écran indique « Aucune question n'a encore été posée. »

Améliorer les réponses #

Une routine mensuelle suffit :

  1. Ouvrez Questions à l'assistant et filtrez sur Aucun contenu.
  2. Repérez les sujets qui reviennent.
  3. Complétez les contenus publiés : question fréquente, page éditoriale, document de la base documentaire ou fiche d'indicateur.
  4. Filtrez ensuite sur Liste de contenus : de nombreuses réponses écartées par le contrôle des chiffres signalent des questions chiffrées mal couvertes ; vérifiez que les indicateurs concernés ont une valeur nationale validée et publiée.
  5. Ajustez au besoin les Questions suggérées pour orienter vers les sujets bien couverts.

Pour aller plus loin #