> For the complete documentation index, see [llms.txt](https://docs.recital.ai/products/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.recital.ai/products/changelogs/version-26.8.x-06-10-2026.md).
# Version 26.8.x (06/10/2026)
## Quoi de neuf dans cette version ?
Cette version apporte des évolutions majeures pour accélérer vos traitements documentaires et fiabiliser la validation humaine :
* **Classification générative par LLM :** Déployez de nouveaux agents de classification capables de catégoriser vos documents et e-mails avec une grande précision grâce aux modèles de langage.
* **Automatisation enrichie dans les Workflows :** Planifiez vos exécutions avec des déclencheurs CRON, ajoutez une étape d'OCR indépendante et sécurisez vos chaînes de traitement avec la reprise sur erreur des sous-workflows.
* **Nouvelle expérience de Révision & Tri :** Bénéficiez d'une vue cluster avec réorganisation par glisser-déposer pour la classification, de listes déroulantes dépendantes en cascade, et d'une saisie ultra-fluide sans risque d'écrasement de données.
##
## Pour les utilisateurs de ces endpoints, voici les modifications à prendre en compte :
### 1) Review :
| Endpoints | Avant (v26.6.24) | Après (v26.8.17) | Description / Paramètres | |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `GET /extract-review/api/v1/queues/{queue_id}/documents/` | Query param sort\_by : Inexistant
Query param sort\_desc : type boolean | null
| Query param sort\_by : Ajouté (optionnel, enum : \["id", "due\_date", "created\_at"], défaut : "due\_date")
Query param sort\_desc : type strictement boolean (défaut : true)
| **Nouveau critère de tri :** Possibilité de trier les documents d'une file d'attente par ID, date d'échéance (`due_date`) ou date de création (`created_at`). Le typage de `sort_desc` n'accepte plus `null`. |
| `POST /extract-review/api/v1/queues/` | **Body (`QueueCreate`)** : contenait le champ optionnel `use_latest` (`boolean \| null`) | **Body (`QueueCreate`)** : le champ `use_latest` a été **supprimé** | **Nettoyage du schéma de création :** Le paramètre `use_latest` n'est plus accepté lors de la création d'une file (il reste disponible en mise à jour `QueueUpdate`). | |
| POST /extract-review/api/v1/queues/{queue\_id}/maturities/
PATCH /extract-review/api/v1/queues/{queue\_id}/maturities/{maturity\_id}/
| Body (MaturityCreate / MaturityUpdate) :
days\_threshold : integer sans bornes explicites
| Body (MaturityCreate / MaturityUpdate) :
days\_threshold : integer
minimum: -2147483647
maximum: 2147483647
| **Support des seuils négatifs :** Autorise explicitement les valeurs négatives ou nulles pour le nombre de jours avant l'échéance (`days_threshold`), permettant de déclencher des niveaux de priorité après échéance dépassée. | |
| `GET /extract-review/api/v1/queues/{queue_id}/download-layout/` | Description OpenAPI :
"Download the layout file for the active queue version."
| Description OpenAPI :
"Download the layout file for the selected (or active) queue version."
| **Précision fonctionnelle :** Clarification du comportement : l'endpoint télécharge le layout de la version demandée via `queue_version_id`, ou celui de la version active si non spécifié. | |
| Routes de récupération et manipulation de documents :
• GET /v1/.../documents/
• POST /v1/.../documents/
• POST /v1/.../documents/upload/
• GET /v1/.../documents/{document\_id}/
• DELETE /v1/.../documents/{document\_id}/
• GET /v2/.../documents/
• GET /v2/.../documents/{document\_id}/
| Schémas de réponse :
DocumentOut et ReviewableDocument ne contenaient pas de champ de date de création.
| Schémas de réponse :
Ajout du champ obligatoire :
created\_at: string (date-time) dans DocumentOut et ReviewableDocument
| **Enrichissement de la donnée retournée :** Les réponses JSON des documents incluent désormais systématiquement l'horodatage de création (`created_at`) dans la liste des champs obligatoires (`required`). | |
***
#### Résumé des impacts pour vos intégrations
1. **Non-bloquant / Améliorations :**
* Vous pouvez désormais exploiter le paramètre `?sort_by=created_at` ou `?sort_by=id` pour paginer ou afficher vos documents dans l'ordre voulu.
* Vous pouvez configurer des niveaux de maturité/priorité avec des nombres de jours négatifs.
2. **Attention aux contrats d'API stricts :**
* Si vos requêtes `POST /queues/` envoyaient le champ `"use_latest": ...`, retirez-le pour éviter de futures erreurs de validation.
* Si vous désérialisez les réponses documents avec un validateur strict, prenez en compte le nouveau champ obligatoire `created_at`.
### 2) Authenticator :
| Endpoints de | Avant (v26.6.24) | Après (v26.8.17) | Description / Paramètres |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| LLM Providers
GET /auth/api/v1/llm-providers/models
| **Route inexistante** | Nouvelle route ajoutée
Retourne la liste des modèles LLM supportés par fournisseur.
| Permet de récupérer les modèles LLM configurés et disponibles par défaut par provider (OpenAI, Scaleway, Azure, etc.). |
| Gestion des Groupes
GET /auth/api/v1/groups/users/
| **Route inexistante** | Nouvelle route ajoutée
Retourne la liste des groupes avec le détail de leurs membres (GroupOutWithUsers).
| Route dédiée pour récupérer les groupes et leurs utilisateurs en un seul appel, remplaçant l'ancien paramètre query. |
| Gestion des Groupes
GET /auth/api/v1/groups/
| Paramètre query :
with\_users (boolean, défaut : false)
Réponse :
anyOf: \[GroupOut, GroupOutWithUsers]
| Paramètre query with\_users supprimé
Réponse :
Retourne strictement un tableau de GroupOut.
| Séparation des responsabilités : cette route ne retourne plus que les groupes sans leurs membres. Pour inclure les membres, utiliser la nouvelle route `/groups/users/`. |
| Politique de mot de passe (Lecture)
GET /auth/api/v1/organizations/{id}/policy/
⬇️
GET /auth/api/v1/organizations/policy/
| Route par ID :
GET /organizations/{id}/policy/
Paramètre path id obligatoire.
Schéma réponse : PasswordPolicyOut (avec org\_id).
| Route globale :
GET /organizations/policy/
Plus d'ID dans le path (basé sur le token).
Schéma réponse : PasswordPolicy (sans org\_id).
| Migration des politiques de mot de passe vers des variables d'environnement globales. L'ID d'organisation n'est plus requis dans l'URL. |
| Politique de mot de passe (Écriture)
PUT /auth/api/v1/organizations/policy/
| Route existante
Permettait de modifier les règles de mot de passe via PasswordPolicyUpdate.
| **Route supprimée** | Comme les politiques de mot de passe sont désormais gérées par variables d'environnement au niveau infrastructure, elles ne sont plus modifiables via l'API. |
| Métriques LLM & Workflows
GET /auth/api/v1/metrics/
| Filtres existants standards :
app, model\_id, agent\_id, workflow\_id, etc.
| Nouveaux paramètres query ajoutés :
• collections (array\[string])
• collection (string)
• llm\_models (array\[string])
• llm\_model (string)
• workflow\_ids (array\[integer])
• agent\_ids (array\[integer])
• apps (array\[Product])
| Permet de filtrer et d'agréger les métriques par modèle de LLM, par collection et par listes multiples d'agents/workflows. |
| Métriques Distinctes
GET /auth/api/v1/metrics/distinct
| Paramètre field (enum) :
action, agent\_id, workflow\_id, workflow\_uuid, model\_id.
| Paramètre field (enum étendu) :
Ajout de collection et llm\_model.
Nouveaux paramètres query :
workflow\_ids, llm\_models, agent\_ids, apps.
| Support de la recherche de valeurs distinctes pour les modèles de langage et les collections. |
| Export des Métriques
GET /auth/api/v1/metrics/download
| Paramètres de filtrage simples (singuliers). | Nouveaux paramètres query ajoutés :
• collections, collection
• llm\_models, llm\_model
• workflow\_ids, agent\_ids, apps
| Aligne les capacités de filtrage de l'export CSV/download avec celles de l'endpoint de consultation. |
| Requêtes Métriques Flexibles
POST /auth/api/v1/metrics/flexible
POST /auth/api/v1/metrics/flexible/csv
| **Body (`FlexibleMetricsQuery`)** : filtres restreints aux IDs simples et actions. | Body (FlexibleMetricsQuery) enrichi :
Ajout des champs : collection, collections, llm\_model, llm\_models, workflow\_ids, agent\_ids, apps, app, is\_test.
| Autorise des requêtes analytiques dynamiques plus poussées sur les consommations de tokens LLM et les exécutions de test. |
| Configuration OCR Organisation
GET /auth/api/v1/ocr-config/
PATCH /auth/api/v1/ocr-config/
| Schémas `OrganizationOCRConfigOut` et `OrganizationOCRConfigUpdate` contenaient le champ `use_latest` (`boolean`). | Le champ `use_latest` a été **supprimé** des schémas de réponse et de mise à jour. | Nettoyage de la configuration OCR d'organisation (`use_latest` n'est plus supporté ici). |
| Profil Utilisateur
GET /auth/api/v1/users/me/
GET /auth/api/v1/users/{id}/
PUT /auth/api/v1/users/me/
| Schémas `UserOut` et `UserUpdate` contenaient uniquement `performance_tabs`. | Ajout du champ `activity_preferences` (`object \| null`) dans `UserOut` et `UserUpdate`. | Permet de sauvegarder et restituer les préférences d'affichage de l'utilisateur pour l'onglet Activité. |
| Notifications
GET /auth/api/v1/notifications/
POST /auth/api/v1/notifications/
| L'enum `NotificationMessages` gérait l'upload, le training et les datasets d'emails. | Nouvelles valeurs ajoutées à l'enum :
• blueprint\_publish:completed
• blueprint\_publish:partial
• blueprint\_publish:failed
| Prise en charge des notifications liées à la publication des Blueprints. |
***
#### Résumé des points d'attention (Breaking Changes)
1. **Suppression de `with_users` sur `/groups/` :** Si votre code appelait `GET /auth/api/v1/groups/?with_users=true`, vous devez désormais appeler la route dédiée `GET /auth/api/v1/groups/users/`.
2. **Politique de mot de passe non modifiable via API :** Le endpoint `PUT /organizations/policy/` est supprimé ; la configuration est maintenant gérée par les administrateurs système au niveau de l'infrastructure via variables d'environnement.
3. **Nouveaux filtres de métriques :** Vous pouvez désormais suivre avec précision l'utilisation des modèles LLM et des collections via les endpoints de métriques.
#### 3) Workflows :
| Endpoints de | Avant (v26.6.24) | Après (v26.8.17) | Description / Paramètres | | |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| Planification CRON (Nouveau module)
POST /workflows/api/v1/schedules/test
| **Route inexistante** | Nouvelle route ajoutée
Paramètres : schedule (expression cron requise), executions (nombre d'occurrences calculées).
| Permet de tester et prévisualiser les prochaines dates d'exécution d'une expression CRON avant de l'enregistrer. | | |
| Planification CRON (Gestion)
GET /workflows/api/v1/schedules/
POST /workflows/api/v1/schedules/
| **Routes inexistantes** | Nouvelles routes ajoutées
• GET : Liste paginée des planifications (limit, offset).
• POST : Création d'une planification (ScheduleRequest).
| Permet de lister et de créer des programmations récurrentes pour déclencher automatiquement des workflows. | | |
| Planification CRON (Détail & Actions)
GET /schedules/{schedule\_id}
PATCH /schedules/{schedule\_id}
DELETE /schedules/{schedule\_id}
POST /schedules/{schedule\_id}/enable
POST /schedules/{schedule\_id}/disable
| **Routes inexistantes** | Nouvelles routes ajoutées
CRUD complet et activation / désactivation unitaire d'une planification par son schedule\_id.
| Gestion du cycle de vie des planifications : mise à jour, suppression, mise en pause ou reprise de l'exécution automatique. | | |
| Rejeu par lots (Bulk Restart)
POST /workflows/api/v1/jobs/restart
| Route inexistante
(Seul le redémarrage unitaire par job POST /jobs/{job\_id}/restart existait)
| Nouvelle route ajoutée
Paramètres query de filtrage : workflow\_filter, step\_filter, states, status, from\_date, to\_date, file\_name, etc.
| **Relance massive de jobs :** Permet de redémarrer en une seule requête un lot de jobs répondant à des critères spécifiques (ex : tous les jobs en échec sur une période). Retourne `{"restarted": int}`. | | |
| Listing / Export des Workflows
GET /workflows/api/v1/workflows/
| Listing des workflows :
Listait tous les workflows avec filtres (name, uuid, status, source, limit, offset).
Retour : Array\[WorkflowResponse]
| Export d'un workflow :
Transformé en endpoint d'export.
Paramètre obligatoire : workflow\_id (integer).
Retour : fichier/objet d'export JSON.
| ⚠️ **Breaking change majeur :** L'endpoint `GET /workflows/` ne sert plus à lister les workflows mais à en exporter un. Pour lister les workflows, il faut désormais utiliser `GET /workflows/api/v1/workflows/by-uuid`. | | |
| Métadonnées de Workflows
WorkflowResponse
WorkflowByUUIDResponse
(Toutes les routes retournant des workflows)
| Schémas de base :
id, name, status, uuid, created\_at, etc.
| Nouveaux champs ajoutés aux schémas :
• updated\_by (integer | null) : ID de l'utilisateur auteur de la dernière modification.
• last\_job\_update\_at (date-time | null) : Horodatage du dernier job exécuté/mis à jour sur ce workflow.
| Permet d'assurer la traçabilité des modifications apportées aux workflows et d'identifier facilement l'activité récente. |
| Webhooks de Job
JobStartWebhook
JobFailureWebhook
JobSuccessWebhook
etc.
| Le champ `event` référençait le schéma `WebhookPayloadEvent`. | Le champ `event` référence désormais le schéma `WebhookEvent`. | Refactorisation interne du schéma enum des types d'événements webhook (`start`, `success`, `failure`, `state:change`, `custom`). Sans impact sur les valeurs. | | |
***
#### Résumé des points d'attention (Breaking Changes & Évolutions)
1. **🚨 Rupture sur `GET /workflows/api/v1/workflows/` :**
* Si vos intégrations utilisaient cet appel pour lister les workflows de l'organisation, **cet endpoint nécessite désormais `workflow_id` et fait un export**.
* **Action corrective :** Migrez vos requêtes de listing vers `GET /workflows/api/v1/workflows/by-uuid`.
2. **Nouvelle fonctionnalité majeure - CRON :**
* Le module `/schedules/` vous permet d'automatiser le lancement de vos workflows directement depuis la plateforme sans outil externe de type Airflow ou cron système.
3. **Productivité - Rejeu en masse :**
* L'endpoint `POST /workflows/api/v1/jobs/restart` simplifie grandement la remédiation en cas d'incident sur une étape de workflow en permettant de relancer des centaines de jobs filtrés en un seul appel.
#### 4) Extract :
| Endpoints de | Avant (v26.6.24) | Après (v26.8.17) | Description / Paramètres | | |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| Duplication de Dataset
POST /extract/api/v1/dataset/{dataset\_id}/
| **Méthode POST inexistante** sur cette route | Nouvelle méthode POST ajoutée
Paramètres : dataset\_id (path), destination\_dataset\_id (query, optionnel).
| Permet de dupliquer un dataset complet (avec configuration, documents et annotations) vers un nouveau dataset ou vers un dataset cible existant. | | |
| Pré-annotation par Agent IA
POST /extract/api/v1/dataset/annotation/{dataset\_id}/prefill\_agent/{document\_type\_id}/
| **Route inexistante** | Nouvelle route ajoutée
Paramètres : dataset\_id, document\_type\_id (path).
Body : entry\_ids, conflict\_mode (always\_replace).
| **Pré-annotation agentique :** Déclenche le pré-remplissage automatique des annotations d'un dataset en s'appuyant directement sur un agent d'extraction. | | |
| Validation d'Annotations en Masse
POST /extract/api/v1/dataset/annotation/{dataset\_id}/bulk\_validate/
| **Route inexistante** | Nouvelle route ajoutée
Body : statuses\_to\_validate, entry\_id (opt), label\_name (opt).
| Permet de valider en masse des annotations (passage au statut `validated`) selon leur statut d'origine, leur document ou leur label. | | |
| Validation d'Annotation Unitaire
POST /extract/api/v1/dataset/annotation/{annotation\_id}/validate/
| **Route inexistante** | Nouvelle route ajoutée
Paramètre : annotation\_id (path).
| Valide formellement une annotation unique en passant son statut à `validated`. | | |
| Copie de Dataset (Ancienne route)
POST /extract/api/v1/dataset/copy/{origin\_id}/into/{destination\_id}/
| Route active standard | **Route dépréciée (`deprecated: true`)** | Remplacée par la nouvelle route de duplication `POST /dataset/{dataset_id}/`. | | |
| Préparation d'Export Dataset
GET /extract/api/v1/dataset/prepare/{dataset\_id}/
| Paramètres : `dataset_id`, `send_notification`. | Nouveau query paramètre :
• callback\_url (string | null)
| Permet de renseigner une URL de callback appelée automatiquement dès que le fichier ZIP du dataset est prêt au téléchargement. | |
| Entraînement de Modèle
POST /extract/api/v1/dataset/{dataset\_id}/export/
| Paramètres : `max_steps`, `model_name`, `visual_trainer`, etc. | Nouveau query paramètre :
• excluded\_statuses (array\[string] | null)
| Permet d'exclure certains statuts de documents lors de l'export d'entraînement. | |
| Rafraîchissement ciblé de Data Point
POST /extract/api/v1/system\_2/data\_point/{document\_type\_id}/refresh/
| Seul `document_type_id` était fourni dans l'URL. | Nouveaux query paramètres :
• data\_point\_id (integer | null)
• file\_id (integer | null)
| Permet de forcer le recalcul explicite d'un data point spécifique ou d'un fichier précis, sans recalculer l'agent complet. |
| Retrait du recalcul implicite :
• POST /system\_2/data\_point/{doctype\_id}/
• PUT /system\_2/data\_point/{dp\_id}/
• POST /system\_2/extract\_path/{dp\_id}/
• PUT /system\_2/extract\_path/{path\_id}/
| Pas de paramètre `reprocess`. Le recalcul était implicite. | Ajout du query paramètre reprocess :
(boolean, défaut true, marqué deprecated)
| Annonce de fin de support du recalcul automatique des extracteurs à chaque sauvegarde. Il est recommandé d'utiliser l'endpoint `/refresh/`. | | |
| Recherche filtrée d'Agents d'Extraction
GET /extract/api/v1/system\_2/document\_type/
| Aucun body de requête (filtres par query params uniquement). | Ajout d'un Request Body optionnel :
{"schema": array\[integer]} (Ids)
| Permet de filtrer la liste des agents en fournissant directement une liste d'identifiants (`IDs`) dans le corps de la requête. | | |
| Copie de fichier avec texte OCR
POST /extract/api/v1/production/{file\_id}/copy\_to\_doctype/{document\_type\_id}/
| Body form-data : `pages_to_copy`, callbacks. | Nouveau champ form-data :
• include\_ocr\_text (boolean, défaut false)
| Permet de copier un document vers un autre agent d'extraction en conservant le texte OCR déjà extrait (gain de performance). | | |
| Import d'Agent d'Extraction
POST /extract/api/v1/system\_2/document\_type/import
| Multipart : `document_type_name`, `zipfile`. | Nouveau champ multipart :
• extraction\_agent\_id (integer | null)
| Permet d'importer et d'écraser/mettre à jour un agent d'extraction existant via son identifiant plutôt que d'en recréer un nouveau. | |
| Remplacement de modèle d'agent
POST /system\_2/document\_type/{id}/replace\_extractor\_model/
| Remplacement global indifférencié. | Comportement assoupli :
Pour les groupes, le modèle n'est remplacé que si les étiquettes cibles sont compatibles.
| Supporte la suggestion et le remplacement par des modèles partageant au moins un label commun. | | |
| Configuration Codes-barres (Agents)
ExtractionAgentOut
ExtractionAgentList
ExtractionAgentUpdate
| Champs :
• qr\_code (boolean)
• qr\_code\_pages (array\[int])
| Migration vers Barcodes :
• qr\_code\_pages est supprimé.
• Ajout de barcode\_pages (array\[int]).
• Ajout de barcode\_formats (array\[BarcodeFormat]).
| **Évolution majeure :** Généralisation de la détection au-delà des QR codes vers 19 formats de codes-barres (EAN-13, Code 128, Data Matrix, etc.). | | |
| Modélisation des Groupes d'Extraction
ExtractionGroupIn
ExtractionGroupUpdate
ExtractionGroupOut
| Labels et réglages passés sous forme de tableaux plats (`labels`, `display_names`, `primary_labels`, etc.). | Nouveau schéma d'objet imbriqué :
Ajout de group\_labels (array\[ExtractionGroupLabel]).
| Migration des labels de groupes vers une table et une structure objet dédiée (`ExtractionGroupLabel`). Les anciens champs plats restent acceptés en compatibilité. | | |
| Cycle de vie des Annotations
AnnotationIn
AnnotationOut
EntryOut / EntryExtendedOut
| Aucun statut sur l'annotation. | Nouveau champ statut :
• status (AnnotationStatus : validated, to\_validate, to\_complete).
• has\_unvalidated\_annotations (boolean) ajouté sur les documents.
| Permet d'introduire des flux de relecture humaine sur les annotations pré-remplies par l'IA. | | |
| Nettoyage global de use\_latest
(Datasets, Zip, Extraction Agents)
| Champ `use_latest` présent dans la plupart des schémas d'entrées/sorties. | **Le champ `use_latest` a été retiré** de l'ensemble des schémas et paramètres de l'API. | Suppression technique définitive du paramètre `use_latest`. | | |
***
#### Résumé des points d'attention (Breaking Changes & Évolutions)
1. **Migration Barcodes :** Si vous automatisiez la configuration des agents via API, remplacez `qr_code_pages` par `barcode_pages` et spécifiez optionnellement `barcode_formats`.
2. **Fin programmée du recalcul automatique :** Les mises à jour de data points et de chemins d'extraction ne recalculeront bientôt plus automatiquement les résultats. Adoptez dès maintenant l'endpoint explicite `POST /system_2/data_point/{document_type_id}/refresh/`.
3. **Nouveau cycle d'annotation :** Les annotations disposent désormais d'un cycle de validation (`to_validate` ➡️ `validated`) facilitant la pré-annotation assistée par agents IA.
#### 5) Classify :
| Endpoints de | Avant (v26.6.24) | Après (v26.8.17) | Description / Paramètres | | | | |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Relance de Classification
POST /classify/api/v1/documents/{document\_id}/rerun
| **Route inexistante** | Nouvelle route ajoutée
Paramètre : document\_id (path).
Réponse : 204 No Content.
| Permet de redéclencher à la demande la prédiction de classification sur un document existant. | | | | |
| Agents de Classification Génératifs (LLM)
• POST /v1/classification-agents/
• PUT /v1/classification-agents/{agent\_id}
• GET /v1/classification-agents/{agent\_id}
| Configuration basée uniquement sur des modèles entraînés (`model_id` obligatoire à la création). | Champs LLM / Génératif ajoutés :
• prompt\_prefix (string | null)
• experimental\_prompt (string | null)
• use\_text (boolean | null)
• llm\_model\_name (string | null)
• temperature (float 0.0 à 1.0)
• reasoning (none, low, medium, high)
model\_id devient optionnel.
| **Support de la Classification Générative :** Possibilité de configurer et d'exécuter des agents de classification propulsés par des LLMs sans nécessiter de modèle classique entraîné. |
| Listing des Agents de Classification
GET /classify/api/v1/classification-agents/
| Pas de filtre génératif.
Aucun Request Body.
| Nouveau query paramètre :
• generative\_agents\_filter (boolean | null)
Nouveau Request Body optionnel :
{"schema": array\[integer]} (Ids)
| Permet de filtrer spécifiquement les agents génératifs vs classiques, ou de restreindre la liste en fournissant un tableau d'identifiants (`IDs`) dans le corps de requête. | | | |
| Mise à jour d'Agent par Import
POST /classify/api/v1/classification-agents/upload
| Multipart acceptait uniquement `file` et `name`. | Nouveau champ form-data :
• classification\_agent\_id (integer | null)
| Permet d'importer une archive pour mettre à jour un agent de classification existant au lieu d'en recréer un nouveau systématiquement. | | | |
| Prédiction Document via Agent
POST /classify/api/v1/documents/classification-agent-prediction
| Paramètres query : `is_bundle`, `include_ocr_text`, `classification_agent_id`, webhooks. | Nouveau query paramètre :
• is\_test (boolean | null, défaut false)
| Permet d'identifier explicitement les exécutions de test pour ne pas polluer les métriques et historiques de production. | | | |
| Documents d'un Agent
GET /classify/api/v1/classification-agents/{agent\_id}/documents
| Paramètres query : `filename`, `hitl_required`, tri, pagination. | Nouveau query paramètre :
• is\_test (boolean | null)
| Permet d'isoler ou d'exclure les documents marqués comme tests dans la liste des documents de l'agent. | | | |
| Schéma Document (DocumentOut)
(Toutes les routes retournant des documents classifiés)
| Le schéma ne contenait pas d'indicateur de test. | Nouveau champ obligatoire ajouté :
• is\_test: boolean (ajouté dans required)
| Indique dans chaque retour document s'il s'agit d'un traitement de test ou de production. | | | | |
| Catégories d'Agent
POST /classification-agents/{id}/categories
PUT /classification-agents/{id}/categories/{cat\_id}
| Body (`CategoryInput`) : `id`, `name`, `source_category_id`, `is_active`. | Nouveau champ ajouté dans CategoryInput :
• description (string | null)
| Permet d'associer une description textuelle aux catégories, particulièrement utile pour guider le prompt du LLM en classification générative. | | | |
| Nettoyage de use\_latest
ClassificationAgentCreate
ClassificationAgentOutput
ClassificationAgentUpdate
| Le champ `use_latest` (`boolean \| null`) était présent. | **Le champ `use_latest` a été supprimé** des schémas de l'agent. | Nettoyage technique : suppression définitive du paramètre obsolète `use_latest`. | | | | |
***
#### Résumé des points d'attention (Breaking Changes & Évolutions)
1. **🚀 Arrivée des agents génératifs (LLM) :**
* Vous pouvez désormais créer des agents de classification avec des prompts et un modèle LLM (`llm_model_name`), sans devoir entraîner un modèle au préalable (`model_id` n'est plus obligatoire).
2. **⚠️ Champ obligatoire ajouté dans `DocumentOut` :**
* Le champ `is_test` (`boolean`) est désormais présent et **marqué comme obligatoire (`required`)** dans les réponses de documents. Vérifiez vos validateurs de schéma stricts si vous désérialisez les réponses de classification.
3. **Productivité & Tests :**
* L'endpoint `POST /documents/{document_id}/rerun` permet de réévaluer facilement un document après modification des règles ou du modèle.
* L'utilisation du flag `is_test` permet de séparer proprement vos campagnes de tests des flux de production réels.
## Changelog
#### Version 26.8.X
***
### NOUVELLES FONCTIONNALITÉS
**Workflows & Automatisation**
* **Planification récurrente (CRON) :** Programmation de l'exécution automatique de vos workflows à intervalles réguliers.
* **Étape OCR dédiée :** Brique d'OCR autonome intégrable à n'importe quelle étape de vos chaînes de traitement.
* **Gestion d'erreurs avancée :** Le workflow principal poursuit son exécution même en cas d'erreur sur un sous-workflow.
* **Reprocess de traitements par lots :** Relance ciblée d'un ensemble de jobs selon vos propres critères.
* **Prise en charge étendue des codes-barres :** Amélioration de la détection et ajout de nouveaux formats configurables.
* **Nettoyage automatique des e-mails :** Renommage automatique des pièces jointes comportant des caractères spéciaux comme /.
* **Confort de test :** Raccourci pour réutiliser les derniers fichiers testés lors de la configuration.
**Interface de Review & Files d'attente**
* **Vue cluster pour la classification :** Regroupement visuel des documents par catégorie et réorganisation par glisser-déposer.
* **Listes déroulantes en cascade :** Sélection dépendante à plusieurs niveaux (ex. : Catégorie > Sous-catégorie) sans configuration complexe.
* **Protection de la saisie en direct :** Sauvegarde intelligente empêchant l'écrasement des données en cours de frappe par des réponses réseau tardives.
* **Nouveaux types de champs :** Ajout des cases à cocher, boutons à bascule (toggles) et affichage multi-lignes pour les textes longs.
* **Indicateurs visuels :** Mise en évidence immédiate des onglets nécessitant une validation humaine.
* **Raccourci clavier :** Combinaison de touches rapide pour copier la valeur d'un champ révisé.
#### Agents d'Extraction & Classification (IA & LLM)
* **Agents de classification générative :** Catégorisation intelligente de vos documents et e-mails via des prompts et modèles de langage (LLM).
* **Modèles par défaut :** Paramétrage rapide avec des modèles préconfigurés par fournisseur d'IA.
* **Pré-annotation assistée par agents (v1) :** Outil d'aide au pré-étiquetage pour accélérer la préparation de vos données.
* **Cadrage visuel amélioré (bounding boxes) :** Détection affinée des blocs de texte sur les documents multipages pour supprimer les doublons d'extraction.
#### Supervision, Activité & Administration
* **Suivi et traces de consommation LLM :** Visualisation détaillée des tokens consommés, des coûts, des pages et documents traités pour l'Extraction et la Classification.
* **Logs plus précis :** Distinction explicite dans l'historique entre les appels API internes et les déclenchements par Webhooks.
* **Politique de sécurité :** Configuration simplifiée de la complexité des mots de passe via des variables d'environnement.
* **Duplication de datasets :** Duplication en un clic de vos jeux de données d'entraînement et de test.
***
### CORRECTIFS & AMÉLIORATIONS
**Workflows**
* Résolution des conflits de concurrence pouvant désynchroniser l'historique ou le statut de certains jobs.
* Correction des blocages lors des étapes de boucle (iterate) sur des jeux de données vides.
* Correction du chargement des tâches et de la réservation de stockage dans les sous-workflows.
* Prise en charge des requêtes HTTPS dans les étapes de code Python.
**Révision & Annotation**
* Correction du bouton de validation qui restait bloqué après le calcul automatique de certains champs.
* Rétablissement de la mise à jour automatique des champs dépendants lors de l'autocomplétion.
* Correction du défilement automatique des étiquettes et du mode d'annotation continu.
* Correction de l'application stricte des règles de validation et des formats de date inversés.
**Affichage & Interface**
* Correction du rendu des miniatures pour les documents au format paysage.
* Correction du chevauchement du bouton de téléchargement dans la page Activité.
* Amélioration de la sélection et du filtrage des catégories dans les listes.
* Harmonisation des règles de nommage des éléments sur toute la plateforme.
**Moteur & API**
* Amélioration de la réparation automatique des fichiers PDF mal formés.
* Nettoyage des caractères invalides (octets nuls) avant l'enregistrement en base de données.
* Correction des erreurs de dimensionnement d'images avec Azure OCR.
* Correction lors de la suppression d'agents d'extraction et libération immédiate des fichiers associés.