documents:write, documents:read, ai_extraction:write et ai_extraction:read, et les autorisations documentaires correspondantes. L’IA doit être activée pour l’entité. Ce parcours déclenche un traitement documentaire : utiliser un fichier de test dont vous avez autorisé l’analyse.
1. Envoyer directement le fichier
DéfinirMARKO_OPERATION_ID avec l’UUID de l’opération et choisir une nouvelle référence documentaire. Ne pas créer une fiche sans fichier sous cette référence avant l’upload.
partner_metadata est ici du texte JSON. Enregistrer le document_id de la réponse dans MARKO_DOCUMENT_ID.
Une référence existante peut être retrouvée sans ajouter de fichier. Pour une reprise du même upload, garder l’identifiant, la clé, le fichier et les métadonnées de départ.
2. Vérifier le document
download_url. Une fiche sans fichier disponible ne prouve pas que l’upload attendu a eu lieu. Une indisponibilité liée aux droits ou au traitement doit être diagnostiquée avant l’analyse.
3. Demander l’extraction
Enregistrer un fichierextraction.json en remplaçant les deux UUID par ceux obtenus dans votre contexte :
202 contient un id de job. Enregistrer cet identifiant dans MARKO_EXTRACTION_JOB_ID. Le document doit appartenir à l’intégration et à l’environnement de la clé; un simple scope IA ne donne pas accès aux documents d’une autre intégration.
4. Suivre le job et lire son résultat
pending, running, completed, failed, dead_letter et cancelled.
Pour failed ou dead_letter, lire error_message et diagnostiquer le traitement avant de soumettre une nouvelle intention. Pour completed, lire suggestions_created, auto_applied, operation_resolution, narrative et les résultats disponibles.
Un traitement terminé ne signifie pas que toute donnée extraite est correcte ou enregistrée. Les propositions qui demandent une confirmation restent à traiter dans le parcours de validation MARKO. Vérifier les valeurs métier persistées avant de les utiliser dans votre application.