Gérer les collections

Les collections sont le principal moyen d'organiser vos documents dans aqoon. Considérez-les comme des dossiers — chaque collection regroupe des documents liés et possède son propre index de recherche.

Créer une collection

1. Cliquez sur Collections dans la barre latérale
2. Cliquez sur Nouvelle collection
3. Saisissez un nom et une description facultative
4. Cliquez sur Enregistrer

Votre nouvelle collection est prête. Vous pouvez maintenant y télécharger des documents.

Consulter vos collections

La page des collections affiche toutes les collections que vous possédez ainsi que les collections publiques auxquelles vous êtes abonné. Chaque carte de collection indique :

• Nom de la collection
• Nombre de documents
• Un badge Publique si la collection est partagée publiquement
• Un badge Abonné pour les collections publiques auxquelles vous avez souscrit

Cliquez sur n'importe quelle carte pour ouvrir la page de détail de la collection.

Page de détail de la collection

La page de détail liste tous les documents de la collection dans un tableau avec :

Colonne	Description
Titre	Nom du document (cliquez pour voir les détails)
Source	Type de téléchargement : PDF, DOCX, Image, Texte ou URL
Statut	État du traitement : En attente, En cours de traitement, Indexé ou Échoué
Fragments	Nombre de segments de texte extraits du document
Tags	Tags attribués lors du téléchargement
Téléchargé	Date d'ajout du document

Modifier une collection

Depuis la page de détail de la collection, cliquez sur Modifier en haut à droite pour changer le nom ou la description de la collection.

Supprimer une collection

Cliquez sur Supprimer sur la page de détail de la collection. Cela supprime la collection et tous ses documents. Cette action est irréversible.

Seul le propriétaire de la collection peut modifier, supprimer ou télécharger des documents. Si vous êtes abonné à la collection publique de quelqu'un d'autre, vous avez un accès en lecture seule.

Gérer les collections

Vous pouvez créer, mettre à jour et supprimer des collections de manière programmatique via l'API REST ou les SDK officiels. Toutes les opérations d'écriture nécessitent une clé API d'accès complet ou une clé à portée limitée avec permission d'écriture sur la collection.

Créer une collection

curl

curl -X POST https://your-instance/api/v1/collections/ \
  -H "Authorization: Bearer aqn_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"name": "My Docs", "description": "Optional description"}'

Python SDK

collection = client.create_collection("My Docs", description="Optional description")
print(collection["uuid"])   # use this uuid to upload documents

JavaScript SDK

const collection = await client.createCollection("My Docs", { description: "Optional description" });
console.log(collection.uuid); // use this uuid to upload documents

Créer une collection

curl

curl -X PATCH https://your-instance/api/v1/collections/{uuid}/ \
  -H "Authorization: Bearer aqn_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"name": "Renamed Docs"}'

Python SDK

collection = client.update_collection("collection-uuid", name="Renamed Docs")
print(collection["name"])

JavaScript SDK

const updated = await client.updateCollection("collection-uuid", { name: "Renamed Docs" });
console.log(updated.name);

Supprimer la collection

Supprime la collection et tous ses documents. Les entrées de l'index de recherche sont supprimées immédiatement ; les blobs sont conservés pendant une période de grâce de 7 jours. Cette opération est irréversible.

curl

curl -X DELETE https://your-instance/api/v1/collections/{uuid}/ \
  -H "Authorization: Bearer aqn_your_api_key" \
  -w "\nHTTP %{http_code}\n"
# HTTP 204

Python SDK

client.delete_collection("collection-uuid")
# Returns None on success (HTTP 204)

JavaScript SDK

await client.deleteCollection("collection-uuid");
// Returns undefined on success (HTTP 204)