Résoudre les problèmes

Diagnostics conversationnels pour les défaillances de la plateforme UiPath, triage des problèmes RPA, Orchestrator, Maestro, Agents et Integration Service à partir du terminal.

Un agent de codage avec des compétences UiPath installées apporte des diagnostics conversationnels à la plateforme UiPath. Décrivez une défaillance en anglais simple à partir de n’importe quel terminal de votre machine, y compris le terminal intégré dans UiPath Studio, et il évalue le problème, classe les causes probables, teste chaque hypothèse par rapport aux données de la plate-forme en direct via uip et vous indique exactement ce qui ne va pas et comment le résoudre.

La compétence Résoudre les problèmes fait partie du catalogue de compétences UiPath et s’installe dans votre agent de codage via uip skills install.

Mode de fonctionnement

Une session de diagnostic suit le même flux en quatre étapes, quel que soit le type de défaillance:

1. Triage - Classez l'étendue de l'échec à partir de la description de l'utilisateur, de l'identifiant de la tâche ou du processus ou du message d'erreur. Si l'entrée est ambiguë, la compétence pose une question de clarification.
2. Générer des hypothèses - Production d'une liste classée des causes possibles, en s'appuyant sur le guide du domaine pertinent et sur toutes les preuves recueillies lors du triage.
3. Options de test - Confirmez ou éliminez une hypothèse à la fois. La compétence récupère les journaux, les traçages, les éléments de file d'attente, les données de réparation, la configuration et les événements d'audit via uip pour recueillir des preuves.
4. Résolution — Présentez la cause profonde, la chaîne d'événements qui ont produit l'échec et une solution concrète. La compétence demande une approbation explicite avant de modifier quoi que ce soit.

L'utilisateur peut être impliqué à quatre moments: clarifier l'étendue pendant le triage, fournir un contexte supplémentaire pour la génération d'hypothèses, fournir le code source ou les fichiers de configuration si nécessaire, et approuver les correctifs recommandés.

Ce que vous pouvez diagnostiquer aujourd'hui

La compétence Résoudre les problèmes couvre les domaines suivants. Vous décrivez le problème; la compétence extrait la preuve et renvoie une cause profonde.

Domaine (Domain)	Ce que vous pouvez diagnostiquer	Exemple de requête
RPA	Tâches échouées (SelectorNotFoundException, TimeoutException et éléments similaires), discordances de sélecteur, défaillances d'éléments de file d'attente, analyse des données de Healing Agent	« Pourquoi la tâche InvoiceBot a-t-elle échoué ce matin?»
Orchestrator	Tâches bloquées ou défaillantes, problèmes d’autorisation et de rôle, erreurs de déploiement et de publication, problèmes de configuration de la file d’attente	« Pourquoi mon robot ne récupère-t-il pas les éléments de la file d'attente Finance?»
Maestro	Instances de processus défaillantes, échecs au niveau des étapes, incidents, chaînes d'échec multi-domaines impliquant des agents ou la RPA	« Pourquoi l'instance du processus d'approbation a-t-elle échoué à l'étape 3?»
Agents	Erreurs d'étape LLM, erreurs d'ancrage dans le contexte et de ressources, échecs de validation du schéma d'entrée, violations de garde-fous et échecs d'appel d'outil Integration Service	« Pourquoi mon agent s'est-il arrêté avec une violation de garde-fou?»
Integration Service	Échecs de l’authentification de connexion et de l’actualisation de jetons, erreurs d’activité du connecteur, entrées requises manquantes et déclencheurs qui ne se déclenchent pas ou ne s’exécutent pas	« Pourquoi ma connexion Salesforce renvoie-t-elle un code 401?»

La prise en charge des autres domaines UiPath est déjà en place, mais toujours approfondie. D'autres domaines et des diagnostics plus riches sont en préparation.

La compétence fonctionne avec le même accès que vous avez. Si vous ne pouvez pas lire certains journaux ou dossiers en tant qu’utilisateur connecté, la compétence ne peut pas non plus les lire.

Prérequis

1. Compétences UiPath installées pour votre agent. Voir Installer et configurer pour les étapes d'installation.
2. Une session connectée (uip login). Voir Installer et configurer.

Étapes

Exécutez la configuration décrite dans Installer et configurer une fois par machine. Par la suite, la compétence est disponible dans chaque session.

Lancez votre agent de codage depuis n'importe quel terminal de votre machine ou depuis le terminal intégré dans UiPath Studio, puis démarrez une session de diagnostic en saisissant /uipath-troubleshoot pour invoquer la compétence explicitement ou en décrivant directement le problème, par exemple: "My job abc- 123 a échoué, que s’est-il passé?»

Répondez aux invites de suivi de la compétence. Répondez aux questions de clarification en anglais simple et partagez le code source, les fichiers de configuration ou d'autres artefacts lorsque la compétence le demande.

La compétence imprime un résumé structuré des causes profondes — le composant défaillant, la chaîne d'événements qui ont produit l'échec, les preuves à l'appui des journaux et des traces et une correction recommandée. Avant de modifier quoi que ce soit sur votre machine ou dans votre locataire, la compétence demande une approbation explicite.

L’exemple suivant montre une session exécutée depuis le terminal intégré dans UiPath Studio:

Conseils pour des sessions efficaces

Traitez la compétence comme un collègue vous aidant à déboguer; le contexte et les allers-retours améliorent le résultat:

• Soyez spécifique. Les ID de tâche, les noms de processus, les noms de file d'attente et les messages d'erreur exacts permettent à la compétence d'ignorer les cycles de clarification.
• Poursuivez la conversation. Si la première recommandation ne correspond pas à ce que vous observez, dites-le. Des expressions telles que « ce n’est pas le cas», « J’ai déjà vérifié cela» ou « approfondir» continuent l’exploration.
• Rediriger si nécessaire. Si la compétence suit le fil de discussion incorrect, corrigez-la, par exemple, « le problème ne concerne pas les autorisations; la tâche s’est exécutée correctement hier».
• Partagez des fichiers lorsque vous y êtes invité. Le XAML, project.json, les fichiers de configuration et des artefacts similaires améliorent considérablement la qualité du diagnostic.
• Accès aux attentes. La compétence utilise votre session uip connectée et hérite de vos autorisations. Si vous ne pouvez pas afficher un journal, la compétence ne peut pas non plus.

Voir également

• Vue d’ensemble des compétences — le mécanisme plus large des compétences
• Installer et configurer — l'installation des compétences CLI et UiPath dans Claude Code, Cursor, CLI Coded et Google Autogradity
• Mise à jour — maintenance quotidienne