Documents et recherche

Mis à jour le 24 octobre 2026

Vous pouvez déposer des documents (manuels, procédures, notes) sur un serveur : l'IA connectée les retrouve et les lit grâce à deux outils ajoutés automatiquement.

Formats acceptés

PDF (.pdf) ;
Word (.docx) ;
Markdown (.md, .markdown) ;
texte brut (.txt).

Le contenu doit correspondre à l'extension : un fichier renommé est refusé (UNSUPPORTED_FILE_TYPE). Un fichier vide est refusé avant l'envoi. Pour ajouter des fichiers, ouvrez l'onglet « Sources » du serveur puis « Ajouter des documents ».

Tailles et limites

10 Mo (10 485 760 octets) au maximum par fichier (FILE_TOO_LARGE au-delà).
Un total de texte extrait par serveur fixé par votre offre, et 1 000 documents au plus (PLAN_LIMIT_REACHED au-delà). La jauge « Texte extrait » de l'onglet « Sources » indique ce qui est utilisé.
Un traitement de plus de 28 secondes s'arrête avec INGESTION_TIMEOUT : essayez un fichier plus petit.

Voir aussi Quotas et offres.

États d'un document

Les fichiers sont envoyés l'un après l'autre ; un échec n'arrête pas les suivants.

« En attente » : le fichier est dans la file.
« Envoi… » puis « Traitement… » : envoi puis extraction du texte.
« Prêt » : le document est utilisable par l'IA.
« Échec » : le message indique la cause (voir Erreurs et dépannage).

Dès qu'une première source est prête, un serveur « draft » passe automatiquement en « active ».

PDF scanné et texte introuvable

Voozeo ne fait pas de reconnaissance de caractères (OCR). Un PDF qui ne contient que des images de pages, ou un fichier illisible, échoue avec NO_TEXT_EXTRACTED. Exportez le document depuis son logiciel d'origine (PDF avec texte sélectionnable) ou convertissez-le en texte ou en Markdown. Un fichier Word dont le contenu décompressé dépasse 50 Mio échoue aussi avec ce code.

Rechercher avec search_documents

Le document est découpé en fragments d'environ 1 500 caractères, avec un recouvrement de 200 caractères. L'outil search_documents fait une recherche par mots-clés (BM25), pas une recherche par sens.

query : les mots recherchés (1 à 1 000 caractères) ;
limit : nombre de passages, de 1 à 10 (5 par défaut).

Il renvoie les passages, le nom du document, son docId et un score.

Lire avec read_document

L'outil read_document lit un document à partir de son docId, par tranches de 20 000 caractères. Le paramètre offset (0 par défaut) indique où commencer ; la réponse contient nextOffset pour lire la suite, ou null quand le document est terminé.

Resources

Chaque document est aussi exposé comme resource MCP à l'adresse voozeo://doc/<docId> (texte tronqué à 100 KB), pour les clients qui savent les afficher.

Le texte des documents est présenté à l'IA comme une donnée non fiable : ses consignes éventuelles ne sont pas des instructions pour elle. Vos documents ne sont servis qu'aux IA connectées avec votre clé.

Conseils pour une bonne recherche

Donnez des titres explicites aux sections de vos documents.
Un sujet par document : plusieurs petits fichiers valent mieux qu'un grand fichier fourre-tout.
Utilisez les mots de vos utilisateurs (« remboursement », pas seulement « restitution »).
Mettez à jour un document en le supprimant puis en le rajoutant.

Supprimer un document

Dans l'onglet « Sources », supprimez la source du document et confirmez. Il est retiré des resources et de la recherche, et son texte ne compte plus dans les 5 Mio du serveur.

Exemple

Vous déposez procedure-conges.pdf (2 Mo) sur le serveur « Ressources humaines ». Une fois l'état « Prêt » affiché, vous demandez à votre IA : « Combien de jours de congé après un an ? ». L'IA appelle search_documents avec query = jours de congé ancienneté et limit = 3, repère le passage, puis, si besoin, appelle read_document avec le docId reçu et offset = 0. Vous retrouverez ces appels dans le journal.