Intégration des systèmes et des données

Gestion des fichiers avec Data Fabric

Dans UiPath Maestro™, les fichiers sont gérés par Data Fabric (anciennement appelé Data Service). Chaque fois qu'un fichier est téléchargé à partir d'une source (telle qu'une pièce jointe à un e-mail ou un fournisseur de stockage dans le cloud), le fichier est téléversé dans une entité de Data Fabric qui prend en charge le stockage des fichiers.

Le fichier est ensuite référencé à l'aide d'une référence de Data Fabric, un triplet contenant :

• EntityName (Nom de l'entité)
• RecordId (ID de l'enregistrement)
• FieldName (Nom du champ)

Cette référence permet d'utiliser le fichier n'importe où dans votre processus agentique.

Prérequis

Avant d'utiliser des fichiers dans Maestro, vérifiez les éléments suivants :

• Data Fabric est activé dans votre organisation ou votre locataire.
• Une entité contenant un champ prenant en charge les fichiers est configurée.

Aucun champ supplémentaire n'est requis en dehors de ceux qui sont remplis automatiquement par Data Fabric lorsqu'un enregistrement est créé.

Exemple de scénario d'utilisation

Cet exemple montre comment télécharger un fichier depuis Box et l'envoyer sous forme de pièce jointe à un e-mail.

1. Télécharger le fichier

   • Configurez une tâche d'envoi (Send Task) pour exécuter une activité Download File (Télécharger un fichier) à partir du connecteur Box.
   • Sélectionnez le fichier que vous souhaitez télécharger.
   • Définissez la sortie de la ressource Fichier (File resource output) à l'aide de l'éditeur Data Fabric. Choisissez l'entité (Entity) et le champ (Field) qui prennent en charge les fichiers.

   

   Lorsqu'elle est exécutée, l'activité renvoie une référence Data Fabric (EntityName, RecordId, FieldName) pointant vers le nouvel enregistrement de fichier dans Data Fabric.

2. Envoyer le fichier par e-mail

   • Configurez une autre tâche d'envoi (Send Task) à l'aide de l'activité Send email (Envoyer un e-mail) du connecteur Outlook.
   • Joignez le fichier en référençant l'ID de l'enregistrement (RecordId) de l'étape précédente dans l'éditeur Data Fabric.

   

Après les tests, l'ID de l'enregistrement (RecordId) sera disponible dans les variables du workflow.

Vous pouvez également vérifier que le fichier existe dans l'application Data Fabric en recherchant l'ID de son enregistrement (RecordId).

Avertissement :

• Dans Maestro, les fichiers sont pris en charge exclusivement par le biais de la solution Data Fabric.
• Si un fichier existe déjà dans Data Fabric, vous pouvez le réutiliser en ajoutant sa référence Data Fabric.

Utilisation d’agents dans Maestro

Fonctionnement des agents dans Maestro

Les agents sont représentés dans les workflows Maestro BPMN en tant que Tâches de service. Lorsque votre processus appelle une tâche de service, Maestro invoque l'agent correspondant avec les paramètres d'entrée requis pour une instance de processus spécifique.

Les agents renvoient les données de sortie à Maestro, qui sont utilisées pour déterminer les étapes suivantes du workflow. Vous pouvez configurer les agents pour signaler les outils utilisés, les décisions prises et les données de traçage pour faciliter le débogage et la transparence.

Les agents peuvent être :

• Création directe dans la plateforme UiPath (low-code ou codé)
• Connecté via des API externes ou Integration Service
• Déclenché par des événements ou des signaux basés sur la logique du workflow

Découvrez un exemple concret : UiPath Maestro, le cerveau à l'origine de l'automatisation transparente des prêts.

Connexion des agents via Integration Service

UiPath Integration Service fournit des connecteurs prêts à l'emploi et sur mesure pour intégrer des systèmes externes dans vos automatisations :

• Connecteurs préconfigurés pour des services tels que Salesforce, Microsoft 365 et Google Workspace
• Générateur de connecteurs personnalisés pour exposer toute API REST à la plateforme UiPath
• Gestion unifiée des informations d’identification et des connexions

Utilisez Integration Service pour permettre à Maestro d'envoyer/recevoir des données d'agents ou de systèmes qui ne sont pas hébergés nativement dans UiPath. En savoir plus sur Integration Service.

Utilisation d’agents externes

Maestro est neutre vis-à-vis du fournisseur. Vous pouvez orchestrer le travail avec vos Agents d'IA externes préférés, sans reconstruire vos Processes, à l'aide des connecteurs UiPath Integration Service.

Vous pouvez orchestrer :

• Services d’IA propriétaires
• Moteurs de décision externes
• Microservices ou bots hébergés sur d’autres plateformes

Maestro invoque ces agents en appelant des points de terminaison REST et s'attend à une réponse contenant des données structurées.

Connexion des agents externes via Integration Service

Au moment de la conception, ajoutez une tâche de service, choisissez Démarrer et attendez l'agent externe, puis configurez l'activité de l'agent depuis le connecteur sélectionné. Au moment du runtime, Maestro envoie la requête et le contexte à l'agent et attend la réponse. Vous associez cette réponse à des variables pour piloter les passerelles, les affectations et les actions suivantes.

Les liens suivants montrent comment connecter un agent externe, l'exécuter à partir d'un processus Maestro et capturer sa sortie pour le routage et les décisions :

• Agents Snowflake Cortex
• Agents Databricks
• Agents Azure AI Foundry
• Démarrer l'agent CrewAI (aperçu)
• Exécuter l'agent Google Vertex

Démarrage rapide : Intégrations de workflow d'API

Préférez les connecteurs Integration Service lorsqu'ils existent. Utilisez des workflows d'API lorsque vous avez besoin d'une connectivité au niveau de l'API (premières API, schémas en évolution ou flux de réponses). Définissez les requêtes et les sorties de manière déclarative, analysez JSON sans code personnalisé et transmettez les résultats dans votre processus Maestro.

Quand utiliser:

• Connecteur : système pris en charge, schéma stable, authentification gérée, meilleur choix à long terme.
• Workflow d'API : API nouvelle ou non prise en charge, modification des formes de réponse ou sortie en flux uniquement.

Guides étape par étape

• Snowflake Cortex - Workflow d'API: gérez la sortie de flux de l'agent Cortex, assemblez-la en une réponse utilisable et renvoyez un fichier JSON structuré pour l'automatisation en aval.
• Databricks Genie - Workflow d'API: démarrez une conversation, examinez le statut du message jusqu'à COMPLETE, extrayez la SQL généré (attachment_id), exécutez-le et renvoyez la réponse.

Configuration des propriétés de l’agent

Dans Maestro, les agents sont traités comme des participants à un processus métier. Dans un workflow BPMN, les agents sont représentés à l'aide de tâches de service, qui peuvent invoquer à la fois des agents hébergés par UiPath et des agents externes. Chaque tâche d'agent peut être configurée avec des paramètres d'entrée et de sortie spécifiques, ce qui permet à Maestro de transmettre des données contextuelles à l'agent et de recevoir des résultats structurés en retour.

Pour obtenir un aperçu des Tâches de service dans Maestro, consultez la section Tâches de la modélisation BPMN.

Modes d’exécution de l’agent

Le comportement de l'agent est défini dans le panneau Propriétés d'une tâche de service. Vous pouvez configurer la tâche pour appeler un agent UiPath ou un agent externe, en fonction des besoins de votre entreprise.

Démarrer et attendre un agent

Utilisez cette option pour invoquer un agent déployé dans votre locataire UiPath. Cela implique les éléments suivants :

• Des Agents low-code créés à l'aide d'outils tels qu'Agent Builder.
• Des Agents codés développés en Python ou d'autres langages et déployés dans Orchestrator.

Lors du runtime, Maestro envoie des paramètres d'entrée à l'agent au format JSON. Lorsque l’agent termine l’exécution, il renvoie une réponse contenant les valeurs de sortie attendues par le processus.

Démarrer et attendre un agent externe

Utilisez cette option pour vous connecter à des systèmes tiers ou externes. Vous devez spécifier les éléments suivants :

• Connecteur : la cible de l'intégration (par exemple, CrewAI, Salesforce ou un autre service)

• Connexion : une instance configurée du connecteur, représentant un agent spécifique ou un ensemble d'informations d'identification spécifiques au contexte.

  Remarque :

  Vous pouvez utiliser le même agent avec différentes autorisations ou comportements en définissant plusieurs connexions.

  

Entrées et sorties

Les entrées et les sorties des agents sont configurées de la même manière que les autres types de tâches Maestro.

• Entrées : variables ou expressions transmises à l'agent au runtime.
• Sorties : variables renseignées à partir de la réponse JSON de l'agent.

Maestro envoie les paramètres d'entrée sous forme de données JSON au format :

{
  "key1": "value1",
  "key2": "value2"
}

L'agent doit renvoyer une réponse JSON en utilisant les mêmes noms de paramètres attendus par Maestro. Ces valeurs sont mappées aux variables de processus à l'aide de la section Sortie > Réponse du panneau Propriétés de la tâche.

Exemples d'entrée et de sortie

Exemples d'entrées (de Maestro à l'agent) :

Paramètre	Description
role	Rôle ou contexte de la tâche (par exemple, validation ou résumé)
prompt	Instructions fournies à l’agent, incluant souvent des données spécifiques à un processus
tools	Liste des outils que l'agent peut utiliser pour effectuer la tâche
user_id	Identifiant unique partagé entre le processus et le contexte de l'agent

Exemple de requête:"Complete loan validation for {loan_application_number}. Respond in JSON format using the parameter 'loan_application_status'."

Exemples de sorties (de l'agent à Maestro)

Paramètre	Description
conversation_id	Référence à la session de dialogue ou d'interaction
loan_application_status	Résultat de statut renvoyé par l’agent
tokens_used	Métadonnées sur l'utilisation des ressources

Avertissement :

Pour utiliser la sortie de l'agent dans votre workflow, vous devez affecter chaque paramètre de sortie à une variable de processus dans la configuration des paramètres de Sortie > Réponse de la tâche.

Règles métier (version préliminaire)

Les règles métier permettent aux développeurs RPA de stocker et de gérer des fichiers DMN (Decision Model and Notation) dans le cadre d'un diagramme de workflow ou de processus.

Règles métier dans Orchestrator

Les règles métier d'Orchestrator vous permettent de stocker et de gérer des règles DMN (Decision Model and Notation). Vous pouvez évaluer ces règles dans n'importe quel processus agentique en utilisant une activité dédiée. En outre, vous pouvez modifier les règles sans avoir à redéployer les processus qui les utilisent. Cela facilite la mise à jour et la maintenance dynamiques de votre logique métier.

Dans Orchestrator, nous utilisons les fonctionnalités suivantes dans le stockage et la gestion :

• Stocker les fichiers DMN avec un accès basé sur les rôles, tant pour les utilisateurs que pour les robots
• Contrôle de version
• Lier des règles métier entre des dossiers
• Balisage

Pour exécuter les règles métier, Maestro inclut une nouvelle tâche Business Rules (Règles métier) qui prend en charge DMN v1.3.

Accéder aux versions des règles métier

Pour suivre l'évolution de vos règles métier, utilisez le champ Version. Une fois que vous avez enregistré la règle métier avec le fichier DMN que vous avez téléchargé, vous ne pouvez plus modifier sa version.

Vous pouvez afficher la version d'une règle métier à partir de la page Business Rules (Règles métier). Pour vérifier la version, sélectionnez une règle métier, puis modifiez la règle métier ou accédez directement à More Actions (Autres actions) et sélectionnez View versions (Afficher les versions).

Le cas échéant, vous pouvez également télécharger la version d'une règle métier à l'aide d'une des méthodes suivantes :

• Une fois que vous avez téléversé le fichier DMN lors de la création de la règle métier, sélectionnez l'icône de téléchargement située en regard du fichier.
• Sur la page Business Rules (Règles métier), dans la règle métier souhaitée, sélectionnez More Actions (Autres actions), puis Download version (Télécharger la version). Autrement, sous More Actions (Autres actions), sélectionnez View versions (Afficher les versions). Un volet latéral s'ouvre, dans lequel vous pouvez sélectionner l'icône de téléchargement située en regard de la version que vous souhaitez télécharger.

Liens des règles métier

Pour lier des règles métier à partir d'autres dossiers :

1. Sur la page Business Rules (Règles métier), sélectionnez Add business rule (Ajouter une règle métier), puis Link from other folders (Lier à partir d'autres dossiers).
2. Ensuite, la page Import Business Rule (Importer une règle métier) affiche une liste de toutes les règles métier contenues dans d'autres dossiers.
3. Sélectionnez une ou plusieurs règles métier à ajouter au dossier actuel, puis sélectionnez Continue (Continuer), puis Link (Lier).

Pour gérer les liens des règles métier :

1. Sur la page Business Rules (Règles métier), sélectionnez une règle métier, accédez à More Actions (Autres actions) et sélectionnez Manage links (Gérer les liaisons).
2. Dans la fenêtre suivante, sélectionnez un ou plusieurs dossiers dans lesquels ajouter une règle métier, ou désélectionnez des dossiers pour supprimer une règle métier.
3. Sélectionnez Update (Mettre à jour).

Exécuter une règle métier

Remarque :

Avant d'exécuter une règle métier, vérifiez que :

• Vous avez modélisé un fichier DMN à l'aide d'un éditeur conforme à la spécification DMN.
• Vous avez créé une nouvelle règle métier dans Orchestrator en téléchargeant le fichier DMN.

1. Pour exécuter une règle métier, ouvrez un processus Maestro.
2. Ajoutez à votre processus une tâche de règle métier (Business Rule task).
3. Sélectionnez le fichier DMN stocké dans Orchestrator comme règle métier (Business Rule).
4. Cartographiez les arguments d'entrée et de sortie en fonction de la manière dont le fichier DMN est modélisé.

Modifier une règle métier

Pour modifier une règle métier, vous devez disposer des autorisations de modification des règles métier.

1. Sur la page Business Rules (Règles métier), sélectionnez une règle métier, puis accédez à More Actions (Autres actions), puis sélectionnez Edit (Modifier).

2. Vous pouvez ensuite modifier les champs suivants : Name (Nom), Description, Labels (Étiquettes), Properties (Propriétés) et File (Fichier).

   Remarque :

   Une fois que vous avez enregistré la règle métier avec le fichier DMN que vous avez téléchargé, vous ne pouvez plus modifier sa version.

   Remarque :

   Assurez-vous que le nom des arguments est composé uniquement de lettres, de chiffres et de traits de soulignement. Les noms doivent commencer par une lettre ou par un trait de soulignement.

3. Sélectionnez Update (Mettre à jour).

Supprimer une règle métier

Pour supprimer une règle métier, vous devez disposer des autorisations de suppression (Delete) sur les règles métier (Business Rules).

1. Sur la page Business Rules (Règles métier), sélectionnez une règle métier.
2. Ensuite, accédez à More Actions (Autres actions).
3. Sélectionnez Supprimer.

Process Apps (version préliminaire)

Vue d'ensemble (Overview)

Les applications de processus fournissent aux utilisateurs métier des tableaux de bord, des formulaires et des hubs de triage basés sur les rôles pour gérer les opérations quotidiennes.Elles permettent une visibilité en temps réel sur l'état de santé des processus, aidant les utilisateurs à identifier les retards, les inefficacités et les escalades, le tout depuis un WorkSpace unifié entre les agents, les robots et les personnes.

Avec les applications de processus, les équipes peuvent :

• Résolvez les délais et les violations des SLA avec un contexte en temps réel et des décisions guidées.
• faire des choix d'attribution de ressources plus intelligents pour améliorer l'efficacité opérationnelle,
• accélérer la résolution des problèmes et améliorer les résultats métier dans toute l'organisation.

Les applications de processus combinent l'orchestration du processus Maestro et le développement d'applications UiPath® low-code, offrant aux équipes chargées des opérations des informations exploitables sans passer d'un système à un autre.

Prérequis

Pour utiliser les applications de processus, assurez-vous que les services suivants sont disponibles dans votre locataire Automation Cloud:

• UiPath Automation Cloud™
• UiPath Maestro™

Démarrer

Vous pouvez commencer à explorer Process Apps à l'aide du SDK UiPath TypeScript et d'exemples de ressources d'applications.

Tableau 1.

Rersource	Description
SDK GitHub	Documentation du SDK UiPath TypeScript
Exemple d'application React	Exemple d'application de processus
Package NPM	SDK UiPath TypeScript

Exemple de cas d'utilisation

• Tableaux de bord de tri: suivez les incidents de processus et procédez aux escalades directement depuis une console des opérations.
• Gestion des incidents et du SLA: surveillez les SLA, identifiez les violations et déclenchez des processus de récupération.
• Opérations d'intervention humaine: fournissez des formulaires contextuels pour les approbations, les corrections ou la gestion des exceptions.

Intégration avec Maestro

Les applications de processus se connectent aux données des processus et des incidents Maestro pour fournir des informations en temps réel dans les exécutions en cours.En tant qu'utilisateur métier, vous pouvez surveiller les instances, suivre les KPI et entreprendre des actions sur les tâches dans une seule interface sans outils de développeur.

Exemple: une application de processus d'opérations financières peut afficher des approbations de facture différées à partir de Maestro et permettre aux utilisateurs d'approuver ou de réattribuer des tâches directement, sans quitter l'application.