Surveillance & progression en temps réel
Surveillance & progression en temps réel
Visualisez, suivez et gérez vos jobs d'indexation, de synchronisation et d'exécution d'agents en direct
Suivi complet des jobs (repositories, sites, uploads et agents) : listes, barres de progression, détails, lancement et reprise automatique des notifications en temps réel.
Fonctionnalités clés
Visualisation des jobs
Liste des travaux en cours et récents, barre(s) de progression par job, messages d’état et accès aux détails d’un job.
Progression en temps réel
Recevez des mises à jour instantanées (pourcentage, message, état) via la connexion temps réel et regardez la progression sans recharger la page.
Contrôles & gestion
Lancez un traitement (repo/site/upload), annulez si nécessaire, et suivez l’état final (succès, échec, interruptions).
Fiabilité & reconnexion
La UI gère les déconnexions et tente de récupérer l’état des jobs sur reconnexion pour éviter les doublons.
Indicateurs détaillés
Chaque job affiche son origine (repository, site, upload), messages d’avancement et logs synthétiques pour diagnostic.
Bonnes pratiques intégrées
Conseils d’usage pour éviter les doublons, respecter les quotas et annuler correctement les traitements.
Intro Cette page explique, pas à pas et pour les utilisateurs, comment lancer des traitements d’indexation/synchronisation/exécution d’agents, lire la liste des jobs, interpréter les barres de progression, suivre l’exécution en temps réel et gérer les cas de déconnexion ou d’erreur. L’objectif : vous permettre de maîtriser le flux complet depuis l’ajout d’une source jusqu’à la complétion du job.
Workflow — Lancer un traitement (repository / website / upload)
Étape 1 — Ouvrir la page projet
Accédez au projet concerné depuis la liste de projets. Vous devez être sur la page principale du projet pour voir les actions (ajout de repository, site ou upload).
Étape 2 — Ajouter votre source
Choisissez l’action adaptée : “Ajouter un repository”, “Ajouter un site” ou “Téléverser un fichier”. Remplissez les champs demandés (URL du repo, URL du site, ou choisir le fichier) puis validez.
Étape 3 — Envoi et confirmation
Après validation, la plateforme confirme que la source a été acceptée et qu’un job a été placé en file d’attente. Un indicateur visuel (souvent un encart « Processing ») apparaît indiquant que le traitement démarre.
Étape 4 — Voir le job initialisé
Immédiatement après l’envoi, un item “pending” (en attente) peut s’afficher dans la liste des jobs : il sert à vous montrer que le travail est en cours d’enregistrement et de planification.
Étape 5 — Passage en exécution
Quand le worker récupère le job, la barre de progression devient active : pourcentage, message descriptif (p.ex. “Fetching files”, “Indexing content”) et durée estimée peuvent s’afficher.
Étape 6 — Complétion & validation
À la fin, le job affiche 100% et un message de résultat (terminé/partiellement terminé/erreur). Vérifiez les messages ou logs associés pour confirmer que tout est conforme.
Étape 7 — Que faire après la complétion
Consultez les résultats : indexation accessible, agents prêts à être exécutés, ou alertes à traiter. Si vous attendiez une génération (ex : insights, documents), utilisez le bouton prévu pour afficher ou régénérer les résultats.
Règle pratique — Évitez les doublons
Si vous avez soumis une source par erreur, attendez quelques secondes pour vérifier si le job a bien été créé avant de relancer. Relancer la même source sans temps d’attente peut créer des jobs dupliqués.
Workflow — Voir la progression en temps réel via l'interface
Étape 1 — Ouvrir la section 'Processing' du projet
Sur la page projet, repérez la section de progression (souvent placée sous l’en-tête du projet ou dans un panneau latéral). Elle liste les jobs en cours et leurs barres de progression.
Étape 2 — Lire les éléments de la liste
Chaque job présente :
- la source (URL repo / site / nom du fichier),
- la barre de progression (pourcentage),
- un message d’état court (p.ex. « Fetching files », « Creating embeddings »),
- un lien ou bouton pour afficher plus de détails.
Étape 3 — Ouvrir le détail d'un job
Cliquez sur un job pour voir l’historique d’étapes, les messages d’erreur éventuels et les métadonnées (durée, taille, éléments traités). C’est le premier endroit à regarder en cas d’échec partiel.
Étape 4 — Suivre plusieurs jobs
La liste montre tous les jobs actifs ; vous pouvez garder un œil simultané sur plusieurs traitements et leur progression relative.
Étape 5 — Regénérer ou re-tenter si nécessaire
Si un job échoue ou est incomplet, utilisez les actions proposées (réessayer, regénérer, corriger la source) depuis le détail du job.
Interpréter la progression
Un pourcentage proche de 100% indique la fin du traitement côté plateforme, mais certaines opérations externes (par ex. appels à un fournisseur) peuvent encore finaliser des étapes. Attendez la confirmation finale pour considérer le job comme complètement appliqué.
Limites & comportements à connaître
Les jobs sont traités de façon asynchrone par des workers. La durée de complétion dépend de la charge du système et de limites externes (rate limits). L’annulation tente d’arrêter un job, mais certaines étapes déjà exécutées côté fournisseur peuvent ne pas être interrompues.
Workflow — Gérer une déconnexion et la reconnexion (bonnes pratiques client)
Étape 1 — Rester calme et attendre quelques secondes
Lors d’une déconnexion réseau ou serveur, la connexion temps réel tente une reconnexion automatique. Attendez 5–10 secondes avant d’agir manuellement ; la reprise est souvent automatique.
Étape 2 — Vérifier l'état affiché
Après reconnexion, la liste de jobs se synchronise et récupère l’état actuel. Confirmez que la progression reprend et que les messages d’état se mettent à jour.
Étape 3 — Forcer une vérification si rien ne bouge
Si la progression ne se met pas à jour, utilisez le contrôle “Rafraîchir le statut” (ou rechargez la page). Ceci déclenche la requête d’état au serveur et met à jour la liste des jobs actifs.
Étape 4 — Éviter de relancer des sources après une coupure
Ne relancez pas immédiatement la même source après une reconnexion : attendez la vérification de l’interface pour éviter la création de jobs dupliqués.
Étape 5 — Si la reconnexion échoue
Si la reconnexion automatique échoue (p.ex. perte prolongée d’accès), notez les sources soumises et réessayez depuis l’UI une fois la connexion rétablie. Contactez le support si les jobs restent bloqués.
- Attendez la reconnexion automatique (quelques secondes).
- À la reconnexion, vérifiez la section des jobs : l’interface devrait afficher l’état courant.
- Si nécessaire, rafraîchissez la liste depuis le bouton prévu.
Avant : vous soumettez une source pendant une déconnexion sans le savoir. Risque : job dupliqué à la reconnexion.
Après : vérifiez la présence d’un job “pending” ou d’un message de confirmation après soumission et attendez la synchronisation après reconnexion avant de resoumettre.
Workflow — Annuler un job en cours (quelques recommandations)
Étape 1 — Localiser le job
Dans la liste des jobs, repérez le job à annuler (par nom de source ou ID visible dans l’UI).
Étape 2 — Utiliser l'action 'Annuler' ou 'Stop'
Cliquez sur le contrôle d’annulation disponible sur l’item du job. L’interface vous demandera généralement de confirmer l’action.
Étape 3 — Confirmer et attendre la rétroaction
Après confirmation, la plateforme tente d’arrêter le job. La UI affiche un message d’état (annulé/en cours d’arrêt/échec d’annulation).
Étape 4 — Vérifier les conséquences
Notez que certaines opérations déjà envoyées à des services externes peuvent ne pas être interrompues : vérifiez la source elle-même (p.ex. webhook, repo) si des changements doivent être inversés.
Étape 5 — Nettoyage manuel si nécessaire
Si l’annulation n’a pas l’effet escompté, contactez le support ou suivez les instructions de rollback indiquées par les messages d’erreur du job.
Astuce pour les gros volumes
Pour traiter plusieurs sources (lots), enchaînez les ajouts de façon contrôlée et surveillez la file : lancer beaucoup de jobs simultanés peut rallonger le temps d’attente en raison des quotas externes.
Surveillance proactive
Utilisez la section de progression comme un tableau de bord : un job qui stagne sur un même message pendant longtemps mérite inspection (ex : vérifier accès, quota, format de fichier).
Attention aux fichiers volumineux et aux rate limits
Les traitements de très gros fichiers ou de dépôts très volumineux prennent plus de temps et peuvent déclencher des limites côté fournisseur. Patientez ou segmentez les données si nécessaire.
Frequently Asked Questions
Récapitulatif rapide
- Lancez vos sources depuis la page projet.
- Surveillez la section “Processing” pour suivre l’avancement.
- En cas de déconnexion, attendez la reconnexion automatique et ne resoumettez pas immédiatement.
- Annulez depuis le job ; gardez en tête les limites externes et les opérations irréversibles.
Besoin d'aide ?
Si un job reste bloqué, si une annulation échoue ou si vous observez des comportements inattendus, contactez le support avec le nom du projet et la source concernée pour une assistance rapide.