Résoudre les problèmes avec UiPath pour les agents de codage

Le codage d’Agents pour la résolution des problèmes apporte des diagnostics conversationnels à la plateforme UiPath. Décrivez une défaillance en anglais simple depuis n'importe quel terminal de votre machine, y compris le terminal intégré dans UiPath Studio, et la compétence évalue le problème, classe les causes probables, teste chaque hypothèse par rapport aux données de la plateforme en direct via uip et vous indique exactement ce qui s'est passé et comment la corriger.

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?»

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 Utilisation de UiPath CLI avec des agents codés pour la commande d'installation par agent.
2. Une session connectée (uip login). Voir Authentification.

Étapes

Exécutez la configuration décrite ici. Utilisation de la UiPath CLI avec des agents de codage 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» permettent de faciliter l’enquête.
• Rediriger si nécessaire. Si la compétence suit le fil de discussion incorrect, corrigez-la, par exemple, « le problème n’est pas lié aux 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

• Compétences — le mécanisme plus large des compétences
• Utilisation de UiPath CLI avec des agents de codage — installation du catalogue de compétences UiPath dans Claude Code, Cursor, GitHub Copilot, Gemini CLI, Coded et OpenCode
• Gestion des outils et des compétences — Maintenance quotidienne