Agents et actions

Recherche dans vos documents Votre site, vos fichiers, SharePoint et OneDrive

L'action « Recherche dans vos documents » fait répondre votre agent à partir de vos propres contenus, quel que soit le point de contact sur lequel il répond (le chat web, par exemple). À la création de l'action, choisissez sa source, par exemple un site web, que Natalia lit et relit, vos documents, que vous déposez vous-même, sans passer par l'équipe Natalia, ou SharePoint et OneDrive, que Natalia lit avec votre compte Microsoft 365. Une fois l'action enregistrée, sa source ne change plus.

Un site web

Indiquez l'adresse de votre site. Natalia lit les pages que liste son plan du site, la liste des pages qu'un site publie pour les moteurs de recherche, puis les relit aux lectures suivantes. Sans plan du site, Natalia lit la page à cette adresse, puis suit ses liens de page en page, sans quitter le site, si son robots.txt le permet.

Quand Natalia lit votre site

Natalia lit le site dans la minute qui suit l'enregistrement de l'action, puis une fois par jour. D'une lecture à l'autre, une page dont la date de modification n'a pas changé dans le plan du site n'est pas retéléchargée, et un texte qui n'a pas bougé n'est pas préparé de nouveau.

Une page qui n'a pas pu être lue garde sa dernière version. Une page qui sort du plan du site sort aussi de ce que l'agent consulte.

Pages en plus

Donnez à l'agent une page que le plan du site ne liste pas, ou qu'aucun lien du site n'atteint. Sous l'adresse du site, le champ « Pages en plus » (optionnel) accepte une liste d'adresses de pages ; chacune se retire d'un clic. Une page peut être sur un autre site que l'adresse principale, par exemple une prise de rendez-vous hébergée ailleurs.

Une page ajoutée est lue comme une page du plan du site : l'agent peut y chercher, elle est relue aux lectures suivantes, et elle sort de ce que l'agent consulte à la lecture suivante quand vous la retirez de la liste. Modifier la liste suffit à relancer une lecture, sans toucher à l'adresse du site.

  • Adresse refusée sous la liste. Une adresse est refusée si elle n'est pas en http ou https, si elle contient un identifiant ou un mot de passe, ou si elle désigne une adresse privée (un réseau interne). Une page qui redirige vers une adresse privée n'est pas lue.
  • Le site de la page décide. Chaque page ajoutée respecte le fichier robots.txt de son propre site : une page qu'il interdit n'est pas lue.
  • 500 pages au plus. Une liste de plus de 500 pages est refusée.

25 000 pages par lecture

Une lecture lit au plus 25 000 pages, dans la limite du volume de pages indexées qui reste à votre organisation. Les pages déjà indexées passent en premier, puis les pages ajoutées.

Ce qu'a donné la dernière lecture

Sous l'adresse du site, la page de l'action dit comment s'est passée la dernière lecture. Une fois le site lu, elle ajoute « Contenu lu le », suivi de la date et de l'heure de cette lecture et du nombre de pages.

  • Avant la première lecture. « Natalia lit le site dans la minute qui suit l'enregistrement, puis chaque jour. »
  • Volume de pages indexées plein. « Le volume de pages indexées de votre organisation ne laisse plus de place : les pages suivantes du site ne sont pas lues. » Supprimez un document ou un site, ou choisissez une offre plus large : « Passer à … » ouvre la confirmation du forfait Chat suivant, avant et après.
  • Pages non lues. Certaines pages n'ont pas pu être lues : Natalia réessaie le lendemain.
  • Rien de lisible à l'adresse. Ni le plan du site ni la page à cette adresse n'ont pu être lus : vérifiez l'adresse.
  • Lecture échouée. Le plan du site n'a pas pu être lu, il ne liste aucune page, ou Natalia n'a pas pu préparer les pages pour la recherche. Natalia réessaie le lendemain, et l'agent continue de chercher dans le contenu de la dernière lecture réussie.

« En attente » ou « Erreur »

Tant que l'agent n'a encore aucun contenu du site, un badge se pose sur l'action, dans le schéma de l'agent. Il disparaît dès qu'une lecture a abouti. Sur la page de l'action, une lecture échouée s'affiche en bandeau rouge, « La dernière lecture a échoué », au-dessus de l'adresse du site.

« En attente »

La suite revient à Natalia : la première lecture n'a pas encore eu lieu. Vous n'avez rien à faire.

« Erreur », en rouge

La dernière lecture a échoué : ni le plan du site ni la page à l'adresse n'ont pu être lus, le plan du site n'a pas pu être lu ou ne liste aucune page, ou Natalia n'a pas pu préparer les pages. Le bandeau de la page de l'action dit lequel.

Suivre la lecture d'un site

Sachez quand l'agent connaîtra le nouveau contenu de votre site. Pendant qu'un site est lu, la fiche agent (sous l'action du schéma) et la page de l'action montrent « Natalia lit le site. », une barre de progression et le temps restant. Une lecture lancée depuis la console (création de l'action, changement d'adresse ou de liste) se suit dès ce moment.

Avant que le nombre de pages soit connu

« Natalia lit le site. » s'affiche seul, sans barre ni estimation.

Avant la première page lue

La barre apparaît, encore sans estimation.

Pendant la lecture des pages

La barre indique « 12 pages sur 40 » et l'estimation « Environ 3 minutes restantes ». L'estimation suit le débit moyen depuis le départ : elle est optimiste sur un site en grande partie inchangé. Au-delà de 24 h, l'estimation ne s'affiche pas.

À la fin de la lecture

L'écran se met à jour seul, sans rechargement, et affiche le nouveau résultat.

  • Lecture planifiée. Une lecture qui n'a pas été lancée depuis la console s'affiche à la prochaine ouverture de l'écran.
  • Lecture interrompue. Une lecture sans avancement depuis 10 minutes ne s'affiche plus comme en cours.

Vos documents

Faites répondre votre agent à partir de vos propres documents. Créez une action « Recherche dans vos documents » sur la source « Vos documents », puis, sur la page de l'action, glissez des fichiers ou des dossiers entiers dans la zone de dépôt. Un bandeau compte les envois et les refus. Une fois un document prêt, l'agent associé à l'action y cherche ses réponses.

  • Formats acceptés. PDF, Word, Excel et PowerPoint (formats OpenDocument compris), e-mails (.msg, .eml), texte (.txt, .csv) et Markdown (.md).
  • 5 Mo au plus par fichier. Refusés à l'envoi : un fichier de plus de 5 Mo, un fichier vide, un nom trop long, un format non accepté.
  • Dossiers. Dans un dossier déposé, les fichiers cachés sont ignorés.

La liste des documents

La liste montre le nom de chaque document et son état ; déplié, un document donne son nombre de pages et sa date d'ajout. Elle affiche 6 documents par page, se cherche par nom et place en tête les documents à corriger. Elle revient à la première page au rechargement.

« Analyse en cours »

Un document accepté se prépare en arrière-plan.

Aucun état

Le document est prêt : l'agent peut y chercher.

Échec

Le document n'a pas pu être préparé ; la liste dit quoi faire.

Corriger un échec

  • PDF scanné. Un PDF scanné, une image sans texte lisible, finit en échec : le texte n'est pas reconnu dans une image. Déposez à la place une version qui contient le texte, par exemple un PDF exporté depuis votre traitement de texte.
  • Format ou taille. Un fichier dans un format absent de la liste ci-dessus est refusé à l'envoi : exportez-le en PDF. Un fichier de plus de 5 Mo l'est aussi : découpez-le en plusieurs fichiers.

Supprimer un document

Un document se supprime depuis la liste. Supprimé, il ne sort plus jamais dans une réponse. Supprimer l'action efface ses documents.

SharePoint et OneDrive

Faites répondre votre agent à partir des fichiers que votre entreprise range dans Microsoft 365. Créez une action « Recherche dans vos documents » et choisissez « SharePoint et OneDrive » sous « Où l'agent cherche ». L'agent cherche alors dans les fichiers SharePoint et OneDrive que le compte Microsoft 365 connecté peut ouvrir. Natalia les lit sans jamais les modifier.

Connecter Microsoft 365

Dans Paramètres, la carte « Microsoft 365 » propose deux façons de connecter, une seule à la fois. Seul un membre en accès complet peut connecter.

  • « Avec un compte administrateur Microsoft 365 ». « Connecter Microsoft 365 » ouvre la page de Microsoft où un administrateur Microsoft 365 accepte la lecture de vos fichiers. Vos utilisateurs connectés ne voient que ce que leurs droits leur permettent, et Natalia ne garde pas ce compte.
  • « Avec un compte Microsoft ». « Connecter un compte Microsoft » ouvre la page de connexion de Microsoft, où vous choisissez un compte de votre organisation. Tous les interlocuteurs ont accès à ce que voit ce compte. Un compte Microsoft personnel est refusé : « Microsoft 365 demande un compte professionnel ». Si votre entreprise exige l'accord d'un administrateur, la carte le dit : demandez-lui d'autoriser Natalia, puis réessayez. Si vous refusez la page d'accord de Microsoft, la carte dit comment obtenir l'accord d'un administrateur : un administrateur Microsoft 365 se connecte ici et accepte pour toute l'organisation ; déconnectez-le ensuite, puis connectez votre compte.

Une fois connectée, la carte nomme le mode : « Un administrateur Microsoft 365 a donné son accord. » ou « Natalia voit ce que voit <compte>. ».

Sans connexion, la page de l'action affiche « Microsoft 365 n'est pas connecté : l'agent n'a aucun dossier où chercher. », avec un lien vers Paramètres, et l'action porte le badge « À configurer » dans le schéma de l'agent.

Ce que Natalia lit

Aucun dossier n'est à choisir : Natalia lit le OneDrive du compte, puis les bibliothèques de documents de chaque site SharePoint qu'il voit, sous-dossiers compris. Elle lit les fichiers à l'enregistrement de l'action, puis chaque jour, et ne reprend que les fichiers nouveaux ou modifiés. Un fichier supprimé, ou un site que le compte ne voit plus, sort de ce que l'agent consulte à la lecture suivante.

  • Formats lus. PDF, Word, Excel et PowerPoint (formats OpenDocument compris), RTF, e-mails (.msg, .eml), texte (.txt, .csv) et Markdown (.md).
  • 100 Mo au plus par fichier. Un fichier plus gros n'est pas lu.
  • Volume de pages indexées plein. « Le volume de pages indexées de votre organisation ne laisse plus de place : certains fichiers ne sont pas lus. » Ces fichiers restent « Non lue » et sont retentés à la lecture suivante. Supprimez un document ou un site, ou choisissez une offre plus large.

La liste des fichiers

Sous « Fichiers », la page de l'action liste les fichiers, 6 par page, avec une recherche par nom. Le nom d'un fichier l'ouvre dans SharePoint ou OneDrive ; un fichier en cours de lecture s'affiche « En analyse ».

  • Retirer. Un fichier retiré s'affiche « Retirée ». À l'enregistrement de l'action, il sort de ce que l'agent consulte et du volume de pages indexées, et n'est plus relu, même modifié. « Restaurer » le reprend, s'il reste de la place.
  • Lire un fichier laissé de côté. Un fichier que le volume a laissé « Non lue » se met à lire avec « + » : il est lu dans la minute qui suit l'enregistrement, s'il reste de la place.
  • Fichier en échec. La liste dit pourquoi il a échoué. « Afficher » ne garde que les « Fichiers en erreur », et « Réessayer » relit un fichier.

Visibilité des documents

Le champ « Visibilité des documents » de l'action dit à qui l'agent cite ces fichiers.

« Selon les droits SharePoint », par défaut

Une personne identifiée ne reçoit que ce que SharePoint ou OneDrive lui ouvre. Natalia relit ces droits chaque jour.

« Personnes identifiées »

L'agent cite le contenu à toute personne connectée à votre site.

« Tout le monde »

L'agent cite le contenu à quiconque lui parle.

Une personne est identifiée quand votre chat web transmet son adresse e-mail signée : par votre site, ou par Microsoft 365 quand le chat est installé sur SharePoint. Sous les deux premiers réglages, un interlocuteur anonyme, ou dont l'adresse n'est que déclarée, ne reçoit aucun de ces fichiers.

Avec un compte Microsoft, Natalia ne lit aucun droit SharePoint : le champ n'offre pas « Selon les droits SharePoint », et « Tout le monde » est le défaut. À la connexion d'un compte, les actions réglées sur « Selon les droits SharePoint » passent en « Tout le monde ».

Droits SharePoint illisibles

Sous « Selon les droits SharePoint », Natalia ne suppose jamais qu'un fichier est ouvert : quand elle ne peut pas lire qui peut ouvrir ces documents, l'agent ne les donne à personne jusqu'à la prochaine lecture réussie. La page de l'action le dit en rouge, avec la cause et le remède, l'action porte le badge rouge « Erreur » dans le schéma, et la carte « Microsoft 365 » de Paramètres nomme les actions touchées.

Le plus souvent, le remède est de reconnecter Microsoft 365 (« Reconnecter Microsoft 365 ») ; l'écran dit avec quel compte. Quand les documents sont ouverts à trop de groupes ou de personnes, l'écran propose une autre visibilité des documents. Quand Microsoft n'a pas répondu, Natalia relit les droits le lendemain.

Accès retiré ou expiré

Quand l'accord donné à Natalia est retiré ou expire chez Microsoft, l'action affiche « Microsoft 365 ne donne plus accès à vos fichiers » et le badge « À configurer », et Natalia ne lit plus rien. Un membre en accès complet clique sur « Reconnecter Microsoft 365 » : ce qui a déjà été lu est conservé, et la lecture de chaque action reprend aussitôt.

Avec un compte Microsoft, l'accès est perdu pour l'une de trois causes, que la carte nomme après « Microsoft 365 ne donne plus accès aux fichiers de <compte> : », et l'agent ne cite plus aucun de ces fichiers. Quand le compte est désactivé ou que son accès est retiré, la carte dit « ce compte a été désactivé ou son accès a été retiré. » : « Reconnecter Microsoft 365 » ouvre la page de connexion de Microsoft, où reconnecter ce compte s'il est de nouveau actif, ou en choisir un autre. Quand l'accord est retiré, la carte dit « l'accord a été retiré. » : un administrateur Microsoft 365 le redonne, une fois, en cliquant sur « Reconnecter Microsoft 365 ». Quand Microsoft refuse toutes les sources à une même lecture, la carte dit « ce compte ne peut plus lire aucune des sources choisies. » : il faut rendre au compte l'accès dans Microsoft 365 puis le reconnecter, ou reconnecter Microsoft 365 avec un autre compte. Quand Microsoft ne refuse qu'une partie des sources, ces actions passent en erreur et leurs fichiers ne sont plus cités. Une panne de Microsoft n'est jamais un refus.

Déconnecter Microsoft 365

Dans Paramètres, « Déconnecter Microsoft 365 » demande confirmation et nomme les actions qui lisent SharePoint et OneDrive : elles perdent tout ce qu'elles y ont lu et restent à configurer. Natalia ne lit plus les fichiers du compte.

Ce que l'agent voit, et ce qu'il ne voit pas

Une action, ses documents

Chaque action a ses propres documents : aucune autre action n'y cherche. Les agents associés à l'action y cherchent, sur chaque point de contact.

Une organisation, ses documents

Aucune autre organisation ne cherche dans vos documents.

SharePoint et OneDrive, selon la visibilité

L'agent ne cite ces fichiers qu'aux interlocuteurs que permet leur visibilité des documents.

Retour à la documentation

Voyez comment le chatbot répond à partir de vos documents et cite sa source.