Créer le workflow d’API

Créez un workflow d'API Test Manager qui appelle le SDR D et D 5e et renvoie des données Robot structurées.

Étape 1 - Créer le workflow de l'API Test Manager

Un workflow d’API est un workflow léger publié en tant que point de terminaison de l’API. Vous en créez un qui encapsule la recherche de Recherche GREP dans Open5e D&D 5e: une entrée, une requête HTTP, une sortie. Une fois publié, il apparaît dans l'Agent Builder comme un outil que votre agent peut appeler.

Cette étape comporte six sous-étapes; Prévoyez 10 à 15 minutes pour la réaliser.

Créer un nouveau projet de workflow d’API

Sélectionnez Créer nouveau dans votre espace de travail Cloud et choisissez Workflow d'API comme type de projet.

Renommez la solution et le workflow par défaut. Ouvrez le menu contextuel de chaque nom dans l'explorateur de projet et sélectionnez Renommer:

• Nom de la solution: Monster Query - 5e SRD
• Nom du workflow: API Query - 5e Monsters

Configurer les entrées et les sorties

Sélectionnez le gestionnaire de données (icône dans le presse-papiers le long de la barre de gauche) pour accéder aux variables de données du workflow.

Ajoutez un argument d'entrée au workflow:

Nom	Saisie de texte	Requis	Description
searchName	Chaîne de caractères (string)	Oui (Yes)	Le nom du moniteur ou le nom partiel à rechercher

Ajoutez un argument de sortie:

Nom	Saisie de texte	Requis	Description
monsterResults	Tableau	Oui (Yes)	Liste des résultats Extras

Ajouter la requête HTTP

1. Dans le canevas du workflow, sélectionnez + entre les activités pour ouvrir le menu des activités. Sélectionnez Requête HTTP.
2. Ouvrez le menu contextuel de l'activité et sélectionnez Rename (Renommer). Nommez-le HTTP Request - Open5e Monster Query.
3. Dans le panneau Propriétés , définissez l’authentification sur Authentification manuelle.
4. Définissez la Méthode sur GET.
5. Définissez l'URL sur https://api.open5e.com/v1/monsters/.
6. Renommez la sortie de l'activité searchResults.

Définissez la propriété Paramètres de requête:

Ouvrez la propriété Paramètres de requête et ajoutez les champs suivants:

Clé (Key)	Valeur (Value)
name__icontains	@searchName
document__slug	wotc-srd
limit	10
fields	slug,name,desc,type,size,cr,challenge_rating,alignment,v2_converted_path

Ce que chaque paramètre fait:

• name__icontains: correspondance partielle insensible à la casse; dragon renvoie « Attribuer un mot de passe rouge», « Forcer le bleu», et d'autres
• document__slug: wotc-srd: filtres sur le SDR D et D 5 officiel; sans cela, les résultats incluent du contenu brew tiers
• limit: 10: limite les candidats à 10; suffisamment pour que l'agent raisonne sans inonder son contexte
• fields: limite la réponse aux seuls champs dont l'agent a besoin; l'objet moniteur Open5e est beaucoup plus volumineux et consommerait le budget du jeton

Référence de la propriété de la requête HTTP

L'activité expose les blocs de construction HTTP standard. La plupart des éléments que vous configurerez pour chaque API que vous appellerez; certaines que vous ignorerez pour les API publiques comme celle-ci:

• Authentification: options prédéfinies pour OAuth 2.0, Clé API et Authentification de base. Définissez sur « Authentification manuelle » ici, car Open5e n’en nécessite aucune. Pour les API authentifiées, choisissez l'option appropriée et fournissez les informations d'identification.
• En-têtes: paires clé/valeur envoyées avec chaque requête. Utilisations courantes: Authorization: Bearer <token> pour les API basées sur des jetons, Accept: application/json pour contrôler le format de la réponse et les en-têtes de contrôle de version des API.
• Corps: utilisé avec les requêtes POST, PUT et PATCH pour envoyer du JSON, des données de formulaire ou du contenu brut. Non applicable pour les requêtes GET, qui comportent des paramètres dans l'URL via des paramètres de requête.
• Paramètres de requête: paires clé/valeur ajoutées à l'URL. La syntaxe @variableName fait référence aux arguments de workflow par nom; @searchName extrait l'argument d'entrée searchName défini dans le Gestionnaire de données. Voir configuration des activités pour plus d'informations sur les variables et les expressions dans Studio Web.
• Sortie (renommée en searchResults): reçoit la réponse HTTP complète y compris le code de statut, les en-têtes et le corps. Le changement de nom par défaut permet de rendre l’expression Définir la réponse lisible.

Ajouter la réponse

1. Dans le canevas du workflow, sélectionnez + après la requête HTTP, puis sélectionnez Définir la réponse.

   Définir la réponse définit ce que le workflow d'API renvoie à son appelant (dans ce cas, ce que l'outil de l'agent reçoit lorsqu'il invoque le workflow). Tout ce que vous avez mis dans le corps de la réponse devient la sortie de l’outil sur laquelle l’agent raisonne.

2. Définissez le corps de la réponse sur:

   {
     "monsterResults": $context.outputs.searchResults.content.results
   }
   

$context.outputs contient chaque sortie nommée des activités de ce workflow. searchResults est la variable de sortie que vous avez renommée sur l’activité Requête HTTP; .content.results navigue dans l'enveloppe de réponse dans laquelle Open5e encapsule ses données, jusqu'au tableau réel des entrées Extras. Pour plus d'informations, consultez la documentation UiPath sur l'utilisation de JavaScript pour accéder aux données de workflow.

Tester le workflow

1. Sélectionnez Debug dans la barre d'outils.
2. Dans le panneau de saisie, définissez searchName sur dragon ou goblin et exécutez le workflow.
3. Vérifiez que la réponse inclut un tableau monsterResults avec des entrées Extra avant de continuer.

Une réponse réussie contient jusqu'à 10 entrées, chacune avec des champs tels que name, type, cr et slug. Si un tableau est vide, essayez d’autres termes de recherche; chaque nom de création n’a pas une correspondance exacte dans le SRS.

Publier dans votre flux

La publication enregistre le workflow en tant que processus déployable dans Orchestrator. C’est ce qui le rend détectable dans la liste des ressources disponibles de l'Agent Builder: le générateur fait apparaître les workflows publiés de votre espace de travail, et non les brouillons enregistrés localement dans Studio Web.

1. Sélectionnez Publier dans la barre d'outils.
2. Dans la boîte de dialogue de publication, sélectionnez Pour moi afin de publier sur votre flux d'espace de travail personnel. Un flux d'espace de travail personnel est un référentiel de package privé lié à votre espace de travail Orchestrator; la publication de « Pour moi » rend ce workflow visible uniquement par vous, ce qui constitue l’étendue appropriée pour le développement et les tests. Pour de plus amples informations, consultez la section Espaces de travail personnels dans la documentation UiPath.
3. Sélectionnez Publier pour confirmer.

Remarque :

Workflow n’apparaissant pas dans Ressources disponibles à l’étape 3? Le workflow doit être publié (pas seulement enregistré) avant d'être visible en tant qu'outil. S’il ne s’affiche pas, revenez ici et confirmez que la publication est terminée, puis actualisez Agent Builder.

---

Une fois le workflow publié, il est disponible dans l'Agent Builder en tant qu'outil connectable dans la section suivante.