Opérer avec UiPath pour les agents de codage

Un agent de codage avec des compétences UiPath installées peut piloter la plupart des tâches opérationnelles dans UiPath — dossiers, tâches, files d'attente, ressources, journaux d'audit, connexions, etc. — par le biais de requêtes en langage naturel. Il exécute uip dans votre session connectée, dans la mesure du contexte que vous lui donnez. Cette page explique ce qu’il faut demander, à quoi s’attendre et où se trouvent les limites.

Pour la configuration (installation de l'agent, connexion, installation des compétences), consultez la section Utilisation de UiPath CLI avec des agents codés.

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).
3. Accès au dossier pour n'importe quelle étendue d'exploitation sur laquelle vous souhaitez agir — l'agent hérite de vos autorisations.

Ce que l’agent peut faire

Chaque ligne regroupe un sous-domaine exploiter. L'agent sélectionne les commandes uip or, uip resource, uip solution ou uip is appropriées parmi les compétences installées — vous indiquez le résultat, et non la commande.

Area	Ce que l’agent peut faire	Exemple de requête
Dossiers et accès	Répertorier, créer, imbriquer, déplacer, supprimer des dossiers; affecter des utilisateurs et des rôles	« [e-mail] aux finances en tant qu'utilisateur d'automatisation»
Utilisateurs, rôles, autorisations	Inspecter les attributions de rôles, créer/modifier/supprimer des rôles, répertorier les autorisations, voir qui a accès à quoi	« Quels dossiers fait [e-mail] ont accès et avec quels rôles?»
Licences (Licenses)	Inspecter les attributions entre les utilisateurs et les robots	« Ajouter 2 autres licences de runtime Unattended à prod-worker-01»
Machines et runtimes	Lister des machines, inspecter les runtimes disponibles dans un dossier	« Quels runtimes sont actuellement disponibles dans Production?»
Sessions	Répertorier les sessions robot actives, voir sur quelle machine chacune est sur, déconnecter les sessions bloquées	« Afficher toutes les sessions non assistées en cours d'exécution dans Production et la durée pendant laquelle elles sont actives»
Processus et packages	Charger des packages, répertorier les versions, créer ou mettre à jour des versions de processus; gérer les flux de packages	« Publiez la version 2.3.0 d'InvoiceBot dans Finance»
Solutions	Publier, télécharger, déployer, activer; Répertorier les versions déployées dans l'ensemble des locataires et des dossiers	« Déployez la version v1.4 de la solution de traitement des factures dans le service Comptabilité du locataire d'organisation»
Tâches (Jobs)	Démarrer, arrêter, surveiller, récupérer les journaux d’exécution et les pièces jointes, regrouper par état	« Répertorie chaque tâche défaillante d’hier dans Production et affiche ses messages d’erreur »
Actifs	Répertorier, obtenir, créer, mettre à jour, supprimer des ressources dans tous les dossiers	« Copier toutes les ressources du dossier A au dossier B»
Magasins d'identifiants	Répertorier, créer, mettre à jour, supprimer des intégrations de coffre; Rotation des informations d'identification référencées	« Quelles ressources de Production font toujours référence à l'ancien magasin CyberArk?»
Files d'attente et éléments de la file d'attente	Inspecter la profondeur de la file d'attente, transmettre les éléments, mettre à jour les statuts en bloc	« Quelles files d'attente ont plus de 100 NouveauxÉléments en ce moment?»
Compartiments de stockage et fichiers	Créer des compartiments, charger, télécharger, répertorier, supprimer des fichiers	« Télécharger chaque fichier des rapports de compartiment/modifié au cours des 7 derniers jours»
Bibliothèques	Publier, répertorier les versions, gérer les versions	« Afficher toutes les versions de la bibliothèque Email.Utilities dans le flux du locataire»
Déclencheurs (Triggers)	Créez des déclencheurs de temps, de file d'attente et d'événement; gérer les calendriers; Lister des exécutions; inspecter l'historique	« Affichez-moi les 10 dernières exécutions de déclencheurs pour la solution d’intégration des RH»
Webhooks	Créer, répertorier, tester	« Répertorie tous les Webhooks actifs et les événements auxquels ils écoutent »
Connexion Integration Service	Lister, tester, actualiser et dépanner les jetons OAuth; vérifier l’intégrité de la connexion	« Testez chaque connexion Salesforce en production et signalez celles qui échouent»
Journaux d’audit	Filtrer par utilisateur, composant, action, plage de dates	« Qui a supprimé le dossier Finance le mois dernier? »

Lecture vs. écriture

L'agent traite les opérations d'exploitation à deux niveaux:

• Opérations de lecture - list, get, logs, audit-logs et similaire. L'agent les exécute selon son propre jugement.
• Opérations d’écriture : tout ce qui crée, met à jour ou supprime. L’agent doit vous confirmer avant l’exécution.

Énoncez votre attente dès le départ lorsqu’une demande est complexe. Par exemple: « Nettoyez les packages de processus inutilisés, mais affichez-moi d’abord la liste.»

Autorisation et étendue

L’agent constitue la session uip connectée et hérite exactement de vos autorisations. Si vous pouvez faire quelque chose dans l’IU UiPath avec votre compte, l’agent peut le faire; si vous ne pouvez pas, l’agent ne le sera pas non plus.

L’agent respecte également le contexte du dossier. Les opérations s'étendent à un dossier spécifique, sauf si vous indiquez « dans tous les dossiers» ou similaire. Si vous modifiez les dossiers au milieu de la conversation, reformulez l'étendue.

Pour le travail d’identité de service (CI/CD, audits planifiés), exécutez l’agent sur une session d’application externe — voir Flux 2 dans Authentification.

Modèles courants en plusieurs étapes

Ce sont les schémas dans lesquels les agents de codage gagnent le plus de temps — des requêtes en plusieurs étapes qui impliqueraient autrement d’enchaîner plusieurs invocations de CLI par la main.

Trier les tâches défaillantes

« Trier chaque tâche défaillante dans Production au cours des dernières 24 heures. Regrouper par message d'erreur et afficher les 5 principales causes profondes.»

L'agent répertorie les tâches filtrées par état et heure, extrait les journaux pour chacune, les regroupe par signature d'erreur et présente un résumé classé. Vous décidez alors de réessayer.

Promouvoir entre les locataires

« Promouvoir la solution de traitement des factures depuis le locataire de développement vers le locataire d'organisation. Déployez-le sous le dossier Comptabilité.»

L'agent extrait la solution du locataire de développement, bascule la session vers le locataire d'organisation et la déploie dans le dossier Comptabilité. Il confirme chaque changement de locataire avant l’action.

Affecter un utilisateur au dossier

« Attribuer [e-mail] en tant qu'Automation User dans le dossier Comptabilité et affectez également la machine virtuelle.»

L'agent affecte l'utilisateur au dossier avec le rôle Automation User, puis affecte la machine virtuelle au même dossier afin que l'utilisateur puisse exécuter des tâches Unattended dessus.

Attribution de rôles d’audit

« Auditez tous les rôles attribués aux utilisateurs externes (tout en dehors de notre domaine) et signalez les dossiers qu’ils peuvent modifier.»

L'agent répertorie les utilisateurs, filtre par domaine, développe les autorisations de rôle de chaque utilisateur par dossier et affiche un rapport structuré.

Voir également

• Utilisation de UiPath CLI avec des agents de codage — configuration de l'agent et installation des compétences.
• Compétences — le modèle de compétence qui détermine ce comportement.
• Authentification — flux de session, y compris Apps externes.
• uip ou référence — dossiers, utilisateurs, rôles, licences, tâches, machines, sessions, journaux d'audit, magasins d'informations d'identification.
• référence des ressources uip — ressources, files d'attente, compartiments, bibliothèques, déclencheurs, webhooks.
• référence de la solution uip — compresser, publier, déployer, activer.
• uip est référence - Connexions, connecteurs, activités Integration Service.