Docs / Télécharger des documents

Télécharger des documents

Les documents sont au cœur de aqoon. Téléchargez des fichiers, collez du texte ou fournissez des URL — aqoon extrait le contenu, le découpe en fragments consultables et indexe le tout pour une récupération rapide.

Formats pris en charge

Type de source Formats acceptés Taille max
PDF .pdf 50 MB
Document Word .docx, .doc 50 MB
Image .png, .jpg, .jpeg 50 MB
Markdown .md 50 MB
Fichier texte .txt 50 MB
Feuille de calcul .csv, .xlsx, .xls 50 MB
URL Web Toute URL accessible publiquement —
Texte brut Coller du texte directement —

Comment télécharger

  1. Ouvrez une collection et cliquez sur Télécharger
  2. Saisissez un titre pour le document
  3. Sélectionnez un fichier — le type de source est détecté automatiquement à partir de l'extension du fichier (PDF, Document Word, Image, Markdown, Texte), ou sélectionnez manuellement pour coller du texte brut ou URL Web
  4. Selon le type :
    • Téléchargement de fichiers — Glissez-déposez ou cliquez pour parcourir
    • URL — Collez l'adresse web
    • Texte brut — Saisissez ou collez votre contenu
  5. Ajoutez éventuellement des tags (séparés par des virgules) pour faciliter l'organisation et le filtrage ultérieur
  6. Cliquez sur Télécharger

Télécharger des documents

Vous pouvez télécharger plusieurs fichiers à la fois. Sélectionnez-les dans le sélecteur de fichiers ou faites-les glisser ensemble.

  • Le type de source de chaque fichier est détecté automatiquement à partir de son extension
  • Les titres sont générés automatiquement à partir des noms de fichiers (pour les fichiers Markdown, le premier titre # est utilisé)
  • Tags — Tous les tags attribués au document
  • Les fichiers non pris en charge ou trop volumineux sont ignorés avec un avertissement

Que se passe-t-il après le téléchargement

Après le téléchargement d'un document, aqoon le traite automatiquement :

  1. En attente — Le document est en file d'attente pour traitement
  2. En cours de traitement — Le texte est en cours d'extraction (OCR pour les images, analyse pour les PDF/DOCX, récupération pour les URL)
  3. Indexé — Le contenu a été découpé en fragments, vectorisé et ajouté à l'index de recherche

En cas de problème, le statut affiche Échoué avec un message d'erreur. Les causes fréquentes incluent des fichiers corrompus ou des URL inaccessibles.

Le traitement prend généralement quelques secondes pour le texte et les petits fichiers. Les PDF volumineux ou les documents riches en images peuvent prendre plus de temps.

Consulter un document

Cliquez sur le titre d'un document pour voir sa page de détail, qui affiche :

  • Les métadonnées complètes (titre, type de source, taille du fichier, date de téléchargement)
  • Les tags sous forme de badges
  • Le contenu du texte extrait
  • La liste de tous les fragments créés lors du traitement, avec leur index et un aperçu du contenu

Télécharger des documents

Vous pouvez télécharger le fichier original de tout document importé sous forme de fichier (PDF, DOCX, image, etc.). Les documents texte pur et URL n'ont pas de fichier stocké et ne peuvent pas être téléchargés.

URL Web

Sur la page de détail du document, cliquez sur Supprimer pour retirer le document et tous ses fragments de l'index de recherche. Cette action est irréversible.

Clé API

GET /api/v1/documents/{uuid}/download/
curl -L -H "Authorization: Bearer aqn_..." \
  https://aqoon.ai/api/v1/documents/<document-uuid>/download/ \
  -o file.pdf

Python :

url = client.get_download_url("document-uuid")

Exemple JavaScript

const url = await client.getDownloadUrl(uuid);

Le point d'accès renvoie une redirection 302 vers une URL Azure Blob Storage signée. Utilisez -L dans curl pour suivre la redirection. L'URL est valide pendant 1 heure. Renvoie 404 pour les documents sans fichier stocké.

Supprimer un document

Sur la page de détail du document, cliquez sur Supprimer pour retirer le document et tous ses fragments de l'index de recherche. Cette action est irréversible.

Chargement en cours...

Vous pouvez télécharger des documents de manière programmatique via l'API REST. Toute clé API avec la permission écriture peut télécharger dans la collection pour laquelle elle a été émise.

Point d'accès MCP

POST /api/v1/collections/{uuid}/documents/

Authentification

Authorization: Bearer aqn_...

La clé API doit avoir la permission d'écriture sur la collection cible.

Envoi d'un seul fichier (curl)

curl -X POST https://aqoon.io/api/v1/collections/<collection-uuid>/documents/ \
  -H "Authorization: Bearer aqn_..." \
  -F "files=@report.pdf"

Envoi groupé — plusieurs fichiers en une seule requête (curl)

curl -X POST https://aqoon.io/api/v1/collections/<collection-uuid>/documents/ \
  -H "Authorization: Bearer aqn_..." \
  -F "files=@report.pdf" \
  -F "files=@notes.docx" \
  -F "files=@data.csv"

Python :

client.upload_document(collection_uuid, "path/to/file.pdf")

Exemple JavaScript

await client.uploadDocument(collectionUuid, file);

Formats pris en charge

PDF (.pdf), documents Word (.docx, .doc), images (.png, .jpg, .jpeg), feuilles de calcul (.csv, .xlsx, .xls), Markdown (.md) et texte brut (.txt).

En cours de traitement

Les documents téléchargés commencent avec le statut en attente et sont traités en arrière-plan. Vérifiez le statut du document avec :

GET /api/v1/documents/{uuid}/

Attendez le traitement — le statut passe de En attente → Traitement → Indexé

Astuce : Au lieu de l'interrogation, vous pouvez configurer un webhook pour recevoir une notification à la fin du traitement. Configurez une URL webhook via POST /api/v1/webhooks/ et aqoon enverra un payload signé à votre URL lors des événements document.indexed et document.failed.

Supprimer

Sur la page de détail de la collection, les propriétaires peuvent supprimer plusieurs documents à la fois à l'aide de cases à cocher.

  • Chaque ligne de document possède une case à cocher à gauche — visible uniquement par les propriétaires de la collection
  • La case à cocher Tout sélectionner dans l'en-tête du tableau sélectionne ou désélectionne tous les documents de la page courante
  • Dès qu'un ou plusieurs documents sont cochés, un bouton Supprimer la sélection apparaît indiquant le nombre de documents sélectionnés
  • Cliquer sur Supprimer la sélection ouvre une boîte de confirmation avant toute suppression
  • Les suppressions confirmées sont des suppressions logiques — les documents sont retirés de la liste et leurs entrées dans l'index de recherche sont supprimées immédiatement

La suppression groupée est réservée aux propriétaires de la collection. Les abonnés voient la liste des documents sans cases à cocher.

Remplacer le document

Lorsque le contenu d'un document change, vous pouvez remplacer le fichier sans perdre l'UUID d'origine ni casser les intégrations qui y font référence. Les anciennes entrées de l'index de recherche sont supprimées et le nouveau fichier est traité depuis le début.

URL Web

Sur la page de détail du document, cliquez sur Remplacer. Le formulaire pré-remplit le titre et les tags existants. Sélectionnez le nouveau fichier et cliquez sur Télécharger. Le document repasse au statut en attente pendant le retraitement.

Clé API

POST /api/v1/documents/{uuid}/replace/
curl -X POST https://aqoon.io/api/v1/documents/<document-uuid>/replace/ \
  -H "Authorization: Bearer aqn_..." \
  -F "file=@updated-report.pdf" \
  -F "title=Annual Report 2026"

Python :

doc = client.replace_document("document-uuid", "path/to/new_file.pdf")

Exemple JavaScript

const doc = await client.replaceDocument(uuid, file);

Détails de la clé

  • L'UUID est conservé — les références existantes restent valides
  • Les anciens fragments et entrées de l'index sont supprimés avant le retraitement
  • Le titre et les tags sont conservés sauf remplacement explicite dans la requête
  • Attendez le traitement — le statut passe de En attente → Traitement → Indexé
  • Un badge Publique si la collection est partagée publiquement