Agents and actions

Document search Your website, your files, SharePoint and OneDrive

The "Document search" action makes your agent answer from your own content, on whatever contact point it answers on (the web chat, for example). When you create the action, choose its source, for example a website, which Natalia reads and reads again, your documents, which you upload yourself with no help from the Natalia team, or SharePoint and OneDrive, which Natalia reads through your Microsoft 365 account. Once the action is saved, its source no longer changes.

A website

Give the address of your site. Natalia reads the pages its sitemap lists, the list of pages a site publishes for search engines, and reads them again at the next readings. Without a sitemap, Natalia reads the page at that address, then follows its links from page to page, within the same site, if its robots.txt allows it.

When Natalia reads your site

Natalia reads the site within a minute of saving the action, then once a day. From one reading to the next, a page whose modification date in the sitemap has not changed is not downloaded again, and a text that has not moved is not prepared again.

A page that could not be read keeps its last version. A page that leaves the sitemap also leaves what the agent searches.

Additional pages

Give the agent a page the sitemap does not list, or that no link on the site leads to. Under the site address, the optional "Pages en plus" (Additional pages) field takes a list of page addresses; each one is removed with a click. A page can sit on another site than the main address, for example an appointment booking hosted elsewhere.

An added page is read like a page of the sitemap: the agent can search it, it is read again at the next readings, and it leaves what the agent can search at the next reading once you take it off the list. Changing the list is enough to start a new reading, without touching the site address.

  • Address refused under the list. An address is refused if it does not start with http or https, if it contains a username or a password, or if it points to a private address (an internal network). A page that redirects to a private address is not read.
  • The page's own site decides. Each added page follows the robots.txt file of its own site: a page that file forbids is not read.
  • 500 pages at most. A list of more than 500 pages is refused.

25,000 pages per reading

A reading reads 25,000 pages at most, within the indexed page volume your organisation has left. Pages already indexed go first, then added pages.

What the last reading gave

Under the site address, the action page says how the last reading went. Once the site has been read, it adds "Contenu lu le" (Content read on) followed by the date and time of that reading and the number of pages.

  • Before the first reading. "Natalia reads the site within a minute of saving, then every day."
  • Indexed page volume full. "Le volume de pages indexées de votre organisation ne laisse plus de place : les pages suivantes du site ne sont pas lues." (Your organisation's indexed page volume has no room left: the next pages of the site are not read.) Delete a document or a site, or choose a larger plan: "Passer à …" (Switch to …) opens the confirmation of the next Chat plan, before and after.
  • Pages not read. Some pages could not be read: Natalia tries again the next day.
  • Nothing readable at the address. Neither the sitemap nor the page at this address could be read: check the address.
  • Failed reading. The sitemap could not be read, it lists no page, or Natalia could not prepare the pages for search. Natalia tries again the next day, and the agent keeps searching the content of the last successful reading.

"En attente" or "Erreur"

As long as the agent has no content from the site yet, a badge sits on the action in the agent's diagram. It disappears once a reading has succeeded. On the action page, a failed reading shows as a red banner, "La dernière lecture a échoué" (The last reading failed), above the site address.

"En attente" (Pending)

The next step is Natalia's: the first reading has not happened yet. You have nothing to do.

"Erreur" (Error), in red

The last reading failed: neither the sitemap nor the page at the address could be read, the sitemap could not be read or lists no page, or Natalia could not prepare the pages. The banner on the action page says which.

Follow the reading of a site

Know when the agent will know the new content of your site. While a site is read, the agent page (under the action in the diagram) and the action page show "Natalia is reading the site.", a progress bar and the time left. A reading started from the console (creating the action, changing the address or the list) can be followed from that moment.

Before the number of pages is known

"Natalia is reading the site." shows alone, with no bar and no estimate.

Before the first page is read

The bar appears, with no estimate yet.

While pages are read

The bar shows "12 pages out of 40" and the estimate "About 3 minutes left". The estimate follows the average pace since the start: it is optimistic on a site that has mostly not changed. Beyond 24 hours, no estimate shows.

When the reading ends

The screen updates by itself, with no reload, and shows the new result.

  • Scheduled reading. A reading that was not started from the console shows the next time you open the screen.
  • Interrupted reading. A reading that has not moved for 10 minutes no longer shows as in progress.

Your documents

Make your agent answer from your own documents. Create a "Document search" action with the "Your documents" source, then, on the action page, drag files or whole folders into the drop zone. A banner counts what was sent and what was refused. Once a document is ready, the agent the action is attached to looks for its answers in it.

  • Accepted formats. PDF, Word, Excel and PowerPoint (OpenDocument formats included), emails (.msg, .eml), text (.txt, .csv) and Markdown (.md).
  • 5 MB at most per file. Refused at upload: a file over 5 MB, an empty file, a name that is too long, a format that is not accepted.
  • Folders. In a dropped folder, hidden files are ignored.

The document list

The list shows each document's name and its state; unfolded, a document gives its number of pages and the date it was added. It shows 6 documents per page, can be searched by name, and puts the documents to fix first. It goes back to the first page when you reload.

"Analyse en cours" (Analysis in progress)

An accepted document is prepared in the background.

No state

The document is ready: the agent can search it.

Failure

The document could not be prepared; the list says what to do.

Fix a failure

  • Scanned PDF. A scanned PDF, an image with no readable text, ends in failure: text is not recognised inside an image. Upload a version that contains the text instead, for example a PDF exported from your word processor.
  • Format or size. A file in a format not listed above is refused at upload: export it as PDF. A file over 5 MB is refused too: split it into several files.

Delete a document

A document is deleted from the list. Once deleted, it never comes up in an answer again. Deleting the action erases its documents.

SharePoint and OneDrive

Make your agent answer from the files your company keeps in Microsoft 365. Create a "Document search" action and pick "SharePoint et OneDrive" under "Où l'agent cherche" (Where the agent searches). The agent then searches the SharePoint and OneDrive files the connected Microsoft 365 account can open. Natalia reads them without ever changing them.

Connect Microsoft 365

In Paramètres (Settings), the "Microsoft 365" card offers two ways to connect, one at a time. Only a member with full access can connect.

  • "Avec un compte administrateur Microsoft 365" (With a Microsoft 365 administrator account). "Connecter Microsoft 365" (Connect Microsoft 365) opens the Microsoft page where a Microsoft 365 administrator accepts the reading of your files. Your signed-in users only see what their permissions open to them, and Natalia does not keep this account.
  • "Avec un compte Microsoft" (With a Microsoft account). "Connecter un compte Microsoft" (Connect a Microsoft account) opens Microsoft's sign-in page, where you pick an account of your organization. Everyone the agent talks to has access to what this account sees. A personal Microsoft account is refused: "Microsoft 365 demande un compte professionnel" (Microsoft 365 asks for a work account). If your company requires an administrator's consent, the card says so: ask them to authorize Natalia, then try again. If you decline Microsoft's consent page, the card says how to get an administrator's consent: a Microsoft 365 administrator signs in here and accepts for the whole organization; then disconnect their account and connect yours.

Once connected, the card names the mode: "Un administrateur Microsoft 365 a donné son accord." (A Microsoft 365 administrator gave their consent.) or "Natalia voit ce que voit <account>." (Natalia sees what <account> sees.).

Without a connection, the action page shows "Microsoft 365 n'est pas connecté : l'agent n'a aucun dossier où chercher." (Microsoft 365 is not connected: the agent has no folder to search.) with a link to Paramètres, and the action carries the "À configurer" (To configure) badge in the agent's diagram.

What Natalia reads

There is no folder to choose: Natalia reads the account's OneDrive, then the document libraries of each SharePoint site it sees, subfolders included. It reads the files when the action is saved, then every day, and only takes new or changed files again. A deleted file, or a site the account no longer sees, leaves what the agent searches at the next reading.

  • Formats read. PDF, Word, Excel and PowerPoint (OpenDocument formats included), RTF, emails (.msg, .eml), text (.txt, .csv) and Markdown (.md).
  • 100 MB at most per file. A larger file is not read.
  • Indexed page volume full. "Le volume de pages indexées de votre organisation ne laisse plus de place : certains fichiers ne sont pas lus." (Your organisation's indexed page volume has no room left: some files are not read.) Those files stay "Non lue" (Not read) and are tried again at the next reading. Delete a document or a site, or choose a larger plan.

The file list

Under "Fichiers" (Files), the action page lists the files, 6 per page, with a search by name. A file's name opens it in SharePoint or OneDrive; a file being read shows "En analyse" (Being analysed).

  • Remove. A removed file shows "Retirée" (Removed). Once the action is saved, it leaves what the agent searches and the indexed page volume, and is no longer read, even when it changes. "Restaurer" (Restore) takes it back, if room is left.
  • Read a file left out. A file the volume left "Non lue" (Not read) is queued with "+": it is read within a minute of saving, if room is left.
  • Failed file. The list says why it failed. "Afficher" (Show) keeps only "Fichiers en erreur" (Files in error), and "Réessayer" (Retry) reads a file again.

Document visibility

The action's "Visibilité des documents" (Document visibility) field says to whom the agent quotes these files.

"Selon les droits SharePoint" (By SharePoint permissions), the default

An identified person only receives what SharePoint or OneDrive opens to them. Natalia reads these permissions again every day.

"Personnes identifiées" (Identified people)

The agent quotes the content to anyone signed in on your site.

"Tout le monde" (Everyone)

The agent quotes the content to anyone who talks to it.

A person is identified when your web chat passes on their signed email address: signed by your site, or by Microsoft 365 when the chat is installed on SharePoint. Under the first two settings, an anonymous person, or one whose address is only declared, receives none of these files.

With a Microsoft account, Natalia reads no SharePoint permissions: the field does not offer "Selon les droits SharePoint", and "Tout le monde" is the default. When an account is connected, the actions set to "Selon les droits SharePoint" switch to "Tout le monde".

SharePoint permissions that cannot be read

Under "Selon les droits SharePoint", Natalia never assumes a file is open: when it cannot read who may open these documents, the agent gives them to no one until the next successful reading. The action page says so in red, with the cause and what to do, the action carries the red "Erreur" (Error) badge in the diagram, and the "Microsoft 365" card in Paramètres names the actions affected.

Most often, the remedy is to reconnect Microsoft 365 ("Reconnecter Microsoft 365", Reconnect Microsoft 365); the screen says with which account. When the documents are open to too many groups or people, the screen suggests another document visibility. When Microsoft did not answer, Natalia reads the permissions again the next day.

Access withdrawn or expired

When the consent given to Natalia is withdrawn or expires at Microsoft, the action shows "Microsoft 365 ne donne plus accès à vos fichiers" (Microsoft 365 no longer gives access to your files) and the "À configurer" badge, and Natalia reads nothing more. A member with full access clicks "Reconnecter Microsoft 365": what was already read is kept, and the reading of each action starts again right away.

With a Microsoft account, access is lost for one of three causes, which the card names after "Microsoft 365 ne donne plus accès aux fichiers de <account> :" (Microsoft 365 no longer gives access to <account>'s files:), and the agent no longer quotes any of these files. When the account is deactivated or its access is withdrawn, the card says "ce compte a été désactivé ou son accès a été retiré." (this account was deactivated or its access was withdrawn): "Reconnecter Microsoft 365" opens Microsoft's sign-in page, where you reconnect this account if it is active again, or pick another one. When the consent is withdrawn, the card says "l'accord a été retiré." (the consent was withdrawn): a Microsoft 365 administrator gives it again, once, by clicking "Reconnecter Microsoft 365". When Microsoft refuses every source at the same reading, the card says "ce compte ne peut plus lire aucune des sources choisies." (this account can no longer read any of the chosen sources): give the account its access back in Microsoft 365 then reconnect it, or reconnect Microsoft 365 with another account. When Microsoft refuses only some sources, those actions show an error and their files are no longer quoted. A Microsoft outage is never a refusal.

Disconnect Microsoft 365

In Paramètres, "Déconnecter Microsoft 365" (Disconnect Microsoft 365) asks for confirmation and names the actions that read SharePoint and OneDrive: they lose everything they read there and stay to configure. Natalia no longer reads the account's files.

What the agent sees, and what it does not

One action, its own documents

Each action has its own documents: no other action searches them. The agents the action is attached to search them, on every contact point.

One organisation, its own documents

No other organisation searches your documents.

SharePoint and OneDrive, by visibility

The agent only quotes these files to the people their document visibility allows.

Back to the documentation

See how the chatbot answers from your documents and cites its source.