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.
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.