Résolution des problèmes

Solutions aux problèmes courants de Delegate, y compris les erreurs de contexte d'écran, les problèmes d'autorisation sur macOS et Windows et les échecs de connectivité ou d'intégration d'outils.

Cette page constitue votre référence unique pour résoudre les problèmes dans Delegate.

Configuration et installation

Je ne vois pas mes applications

• Vérifiez que le contexte de l’écran est activé (bouton bascule en bas de la fenêtre)
• Vérifiez que les autorisations d’enregistrement/d’accessibilité de l’écran sont accordées dans les paramètres système ou que le contrôle UAC (Contrôle du compte d’utilisateur) a été accepté sous Windows
• Redémarrer Delegate après avoir accordé des autorisations

Delegate indique qu’il ne peut pas accéder à un site Web

• Vérifiez votre connexion Internet
• Certains réseaux d’entreprise bloquent certains services d’IA: contactez votre service informatique si vous pensez à cela
• Essayez un autre site Web pour isoler le problème

L'extension du navigateur n'est pas détectée

• Assurez-vous que l’extension est installée et activée dans votre navigateur
• Sur Chrome: chrome://extensions → Delegate doit être répertorié et activé
• Après l’installation, redémarrez votre navigateur
• Réexécutez l’assistant de configuration depuis Paramètres si nécessaire

Je ne peux pas me connecter

• Vérifiez les informations d’identification de votre compte UiPath
• Si votre organisation utilise l'authentification unique, assurez-vous que vous utilisez le réseau de l'entreprise ou le VPN
• Vérifiez que votre locataire est correctement sélectionné

Tâches et invites

Delegate n’a pas compris ce que je cherchais

• Divisez la requête en plus petites étapes
• Soyez plus explicite sur l’objectif et le format
• Fournir un exemple de la sortie souhaitée

Il a commencé à faire quelque chose auquel je ne m'attendais pas

• Appuyez sur la touche Échap pour arrêter
• Demandez « Qu’est-ce que vous essayez de faire?» pour comprendre son raisonnement
• Rediriger avec une instruction plus claire

La tâche prend trop de temps

• Vérifiez si vous êtes en mode Arrière-plan (plus lent mais sans blocage)
• Demandez une mise à jour du statut: « Qu’est-ce qui prend si longtemps?»
• Pensez à diviser en plus petits fragments pour les tâches complexes

Il ne cesse de demander une confirmation

• Vous êtes en mode guidé: cela est attendu pour des raisons de sécurité
• Basculer vers le mode Autonome pour les workflows approuvés et répétitifs
• Examinez les paramètres de sécurité si vous souhaitez ajuster les déclencheurs de confirmation

Sécurité et autorisations

Delegate indique qu’il ne dispose pas de l’autorisation

1. Vérifiez Paramètres → Sécurité → la catégorie d’outil concernée est activée.
2. Vérifiez les autorisations de l’outil pour l’opération spécifique de l’outil ou du connecteur.
3. Vérifiez si l’application ou le site cible se trouve dans Applications/sites Web bloqués sous UI Automation, ou si le chemin correspond à une catégorie sous Fichiers protégés.
4. Essayez temporairement de passer en mode Cachet pour consulter le refus spécifique.

J'ai approuvé une action, mais elle a toujours échoué

1. Vérifiez les autorisations au niveau du système d’exploitation (paramètres de confidentialité macOS, UAC Windows).
2. Vérifiez que l’application ou le site ne se trouve pas dans Applications/sites Web bloqués sous UI Automation.
3. Vérifiez si le chemin d'accès au fichier correspond à une catégorie sous Fichiers protégés.
4. Examinez le message d’erreur - il peut indiquer un problème différent (réseau, authentification, etc.)

Je souhaite autoriser un site bloqué

1. Ouvrez Paramètres → Sécurité → Automatisation de l'interface utilisateur et vérifiez Sites Web bloqués - supprimez le site s'il est répertorié individuellement ou s'il a été ajouté dans le cadre d'une catégorie (Banking, Paiements, Chiffrement, Gestionnaire de mot de passe, Government, Santé).
2. Si le paramètre est verrouillé et s'affiche comme géré par votre organisation, contactez votre administrateur à la place — il est appliqué via Automation Ops et ne peut pas être modifié localement.

Une compétence ne cesse de demander les autorisations que j’ai déjà accordées

1. Vérifiez si la compétence demande une autorisation différente de celle d'avant.
2. Vérifiez que le manifeste de la compétence correspond à ce qu'il utilise réellement.
3. Certaines autorisations sont limitées à la session et nécessitent une réapprobation.
4. Vérifiez Paramètres → Autorisations → Agents autorisés pour vous assurer que l’agent concerné est activé.

Connexions

Integration Service: échec de la connexion ou erreur d'authentification

Origines

• Jeton OAuth expiré
• Mot de passe modifié dans le service source
• La politique de l’organisation a révoqué l’accès tiers
• Autorisations accordées insuffisantes

Solutions

1. Accédez à Paramètres → Connexions → Se reconnecter.
2. En cas d'échec, révoquez et recréez la connexion.
3. Vérifiez les paramètres de l’application tierce du service.
4. Vérifiez que vous disposez des autorisations nécessaires dans l’application source.

Integration Service: aucune connexion n'a été trouvée pour [service]

Cause: Vous avez demandé à Delegate d'utiliser un service qui n'est pas connecté

Solutions

1. Créez la connexion dans Paramètres → Connexions.
2. Ou spécifiez une approche différente qui ne nécessite pas ce service.

Integration Service: autorisations insuffisantes

Cause: La connexion existe, mais ne dispose pas des étendues nécessaires à l'action demandée.

Solutions

1. Déconnectez-vous et reconnectez-vous, en accordant des autorisations supplémentaires lorsque vous y êtes invité.
2. Vérifiez auprès de votre administrateur informatique si les politiques de l’organisation restreignent les étendues.

MCP : échec de la connexion au serveur MCP

Origines

• Le serveur distant est en panne ou inaccessible
• Échec du démarrage du processus local
• Réseau/pare-feu bloquant la connexion
• URL ou configuration non valide

Solutions

1. Vérifiez que le serveur est en cours d’exécution (pour le local) ou accessible (pour le serveur distant).
2. Vérifiez l’URL/la commande pour les fautes de frappe.
3. Testez le point de terminaison manuellement (curl, navigateur).
4. Vérifiez les paramètres du pare-feu.
5. Examinez les journaux de processus locaux pour détecter les erreurs de démarrage.

MCP : serveur connecté, mais aucun outil disponible

Cause: le serveur est en cours d'exécution, mais n'a enregistré aucun outil, ou les outils n'ont pas pu initialiser

Solutions

1. Consultez la documentation du serveur pour connaître la configuration requise.
2. Vérifiez que les variables d’environnement sont définies correctement.
3. Redémarrez le serveur MCP.
4. Consultez les journaux du serveur pour détecter les erreurs d’initialisation.

MCP: échec de l’appel d’outil ou erreur MCP

Cause: le serveur a reçu la demande mais n'a pas réussi à l'exécuter

Solutions

1. Consultez le message d’erreur spécifique dans la fiche de l’outil.
2. Vérifiez que les paramètres requis de l’outil ont été fournis.
3. Vérifiez si la ressource sous-jacente (fichier, base de données, API) est accessible.
4. Examinez les journaux du serveur MCP pour obtenir des informations détaillées sur les erreurs.

Routines

Routage introuvable

Cause: la routine a été supprimée ou le dossier CompétencesLocaux a été déplacé

Solutions

1. Vérifiez si la routine se trouve dans Paramètres → Routages.
2. Si cette option est importée, réimportez-la à partir du fichier d’origine.
3. Vérifiez le chemin du dossier LocalSkills dans Paramètres → Compétences et amp; Marketplace.

Entrée requise manquante

Cause: la routine attend un paramètre qui n'a pas été fourni

Solutions

1. Lors de l’exécution, remplissez toutes les entrées demandées.
2. Dans le cadre de la planification, assurez-vous que des valeurs fixes sont définies pour toutes les entrées requises.
3. Modifiez la routine pour rendre les entrées facultatives avec des valeurs par défaut.

Échec de la routine à l’étape X

Cause: une action de la routine n'a pas pu se terminer

Solutions

1. Consultez le message d’erreur dans la fiche de l’outil.
2. Vérifiez que les connexions requises sont actives (Paramètres → Connexions).
3. Assurez-vous que les fichiers d’entrée existent et sont accessibles.
4. Vérifiez si les applications cibles sont installées.
5. Exécutez en mode guidé pour voir exactement où il échoue.

La routine planifiée ne s’est pas exécutée

Cause: service de planification non exécuté ou problème d'autorisations

Solutions

1. Consultez Paramètres → Routages → Planifié pour le statut de l'exécution.
2. Vérifiez que Delegate était en cours d’exécution à l’heure planifiée.
3. Vérifiez si la machine était en mode veille (les planifications peuvent ne pas s'exécuter pendant cette période).
4. Examinez l'historique d'exécution pour les messages d'erreur.
5. Assurez-vous que les connexions sont toujours valides (non expirées).

Magasin et compétences

L’élément ne s’installera pas

Origines

• Problème de connectivité réseau
• Espace disque insuffisant
• Téléchargement corrompu
• Version de Delegate incompatible

Solutions

1. Vérifiez la connexion Internet.
2. Libérez de l’espace disque (consultez le répertoire LocalSkills).
3. Réessayez l’installation.
4. Vérifiez si votre Delegate est à jour.
5. Contactez l’éditeur si le problème persiste.

La compétence installée n'apparaît pas

Origines

• La compétence est désactivée
• Non ajouté à la liste des compétences activées
• Delegate a besoin d’un redémarrage

Solutions

1. Vérifiez Paramètres → Compétences & Marketplace → la compétence est répertoriée et activée.
2. Redémarrer Delegate.
3. Consultez le dossier Compétences locales pour obtenir les fichiers de compétence.

La compétence échoue lorsque j'essaie de l'utiliser

Origines

• Connexions requises manquantes
• Autorisations requises manquantes
• Version de compétence obsolète
• Incompatibilité des versions d’application

Solutions

1. Consultez la documentation de la compétence pour connaître les conditions préalables.
2. Créez les connexions requises dans Paramètres → Connexions.
3. Activez les catégories d’outils requises dans Paramètres → Sécurité.
4. Mettez à jour la compétence vers la dernière version.
5. Vérifiez si la version de l’application cible est prise en charge.

Le flux personnalisé ne se charge pas

Origines

• URL de flux non valide
• Serveur de flux en panne
• Format de flux incorrect
• Blocage du réseau/pare-feu

Solutions

1. Vérifiez que l’URL est correcte et accessible dans un navigateur.
2. Vérifiez le format du flux par rapport aux spécifications UiPath.
3. Contactez l’administrateur de flux.
4. Vérifiez les paramètres du pare-feu de l’entreprise.

Paramètres

Les modifications de paramètres ne prennent pas effet

Cause: certains paramètres nécessitent un redémarrage de l'application; Les paramètres de l'onglet Sécurité et Autorisations ne peuvent être modifiés que via l'interface utilisateur des paramètres, et non en modifiant le fichier directement.

Solutions

1. Redémarrez Delegate et vérifiez si le paramètre a pris effet.
2. Si le paramètre se trouve dans l'onglet Sécurité ou Autorisations, utilisez l'interface utilisateur des paramètres plutôt que de modifier le fichier directement.
3. Si vous modifiez le fichier settings.json manuellement, vérifiez que vous modifiez bien le chemin d'accès au fichier.

Le fichier de paramètres est corrompu

Cause: settings.json contient une syntaxe JSON non valide, souvent en raison d'une erreur de modification manuelle. Delegate revient automatiquement aux paramètres par défaut.

Solutions

1. Fermer le Delegate.
2. Supprimez ou renommez settings.json.
3. Redémarrer Delegate — de nouvelles valeurs par défaut sont créées.
4. Reconfigurez vos préférences.

Impossible de trouver un paramètre

Cause: le paramètre peut se trouver dans un onglet différent de celui attendu ou uniquement disponible via l'interface utilisateur des paramètres.

Solutions

1. Vérifiez si le paramètre se trouve dans l'onglet Sécurité (interface utilisateur uniquement).
2. Vérifiez votre version de Delegate - certains paramètres sont spécifiques à la version.

Les paramètres sécurisés ne seront pas enregistrés

Cause: la sécurité au niveau du système d'exploitation empêche l'accès au magasin des paramètres chiffrés: macOS Keychain ou Windows Data Protection API.

Solutions

1. Vérifiez les autorisations de sécurité au niveau du système d’exploitation.
2. macOS: assurez-vous que le Keychain est déverrouillé.
3. Windows: assurez-vous que votre profil d’utilisateur est correctement chargé.
4. Redémarrer Delegate.
5. Si persistant, contactez le support UiPath.