Mettre à jour le déploiement de compétences ML à l'aide d'une API

Pour accéder aux API AI Center :

1. Enregistrer une application externe (configuration unique).
2. Générez un jeton d'authentification (renouvelé à l'expiration).
3. Passez des appels API AI Center.

Remarque : les deux premières étapes appliquent le contrôle d'accès en vous assurant que votre application est enregistrée et authentifiée. Pour accéder à l'application, vous devez enregistrer et authentifier l'application. (étapes 1 et 2)

Enregistrement d'une application externe

Pour utiliser ces API, votre application doit être enregistrée en tant qu'application externe dans l'étendue AI Center.

1. Accédez à la page Admin dans le panneau de navigation de gauche et sélectionnez Applications externes ( External Applications).
2. Sélectionnez + Ajouter une application (Add Application) et attribuez-lui un nom pour ajouter une nouvelle application externe.
   Remarque : seul le type d'application confidentiel peut accéder aux API AI Center.
3. Sélectionnez Ajouter une étendue (Add scope ) pour activer l'étendue AI Center pour l'application externe.
   • Choisissez Accès à l'API AI Center (aperçu) (AI Center API Access (preview)) dans la liste déroulante Ressource (Resource).
   • Accédez à l'onglet Étendue de l'application ( Application Scope ) et choisissez les API auxquelles vous souhaitez donner accès aux applications externes. Dans l'exemple ci-dessous, vous avez sélectionné toutes les API pour plus de simplicité.
     
     

     

     
     
4. Une fenêtre contextuelle avec l'ID d'application et une clé secrète d'application confirme que l'application a été ajoutée avec succès. Vérifiez l' ID de l'application et la clé secrète de l'application à tout moment à partir de l ' application externe Modifier l'application externe (Edit External).
   Remarque : utilisez ces informations d'identification pour générer un jeton d'authentification lors de l'étape suivante.
   
   

   

   
   

Consultez la page Gestion d'applications externes (Managing external applications ) pour plus d'informations.

Génération d'un jeton d'authentification

L'application externe doit demander un jeton d'accès à l'Identity Server UiPath pour l'authentification et l'accès sécurisé.

Remarque : le jeton d'authentification expire dans une heure. Une fois ce délai écoulé, vous devrez en générer une nouvelle.

Par souci de simplicité, nous utilisons Postman dans ce tutoriel. Vous pouvez enregistrer 10 jetons gratuitement et utiliser leur interface Web, application ou tout autre outil.

Générez une requête POST au point de terminaison du serveur d'identité qui inclut les éléments suivants dans le corps de la requête :

• client_id: ID de l'application de l'étape précédente.
• client_secret: secret de l'application de l'étape précédente.
• grant_type: informations_informations_d'identification.

Sélectionnez application/x-www-form-urlencoded comme type de contenu si vous utilisez Postman.

Cette requête crée un jeton d'authentification, utilisé pour les appels d'API AI Center :

Vous pouvez également voir les autorisations activées pour cette application externe.

Consultez les informations supplémentaires sur les informations d’identification et les jetons d’authentification dans la page Applications externes (OAuth) .

Passer des appels API AI Center

Les appels d'API suivent la structure https://cloud.uipath.com/accountname/tenantname/aifabric_/ 10 , où accountname et tenantname sont spécifiques à votre compte.

La plupart des API ont besoin des informations suivantes :

• Account ID et Tenant ID. Vérifiez les détails du compte et du locataire dans la section d' informations de profil du locataire.
• Authorization Le champ Autorisation (Authorization) est renseigné avec le jeton d'authentification généré à l'étape précédente.

Vous pouvez désormais accéder à des API spécifiques.

Dans la liste Compétences ML, sampleClassifierSkill (utilisé à titre d'exemple) est actuellement à l'état Disponible (Available).

Utiliser les API AI Center pour :

• Recherchez l' ID de compétence ML de sampleClassifierSkill.
• Arrêter (annuler le déploiement) de la compétence ML.
• Démarrez (redéploiement) et vérifiez la mise à jour de l’état.

Rechercher les détails de la compétence ML

Avec l'appel GET ML Skills , vous pouvez récupérer toutes les compétences ML de votre compte et locataire.

Pour rechercher une compétence ML spécifique et obtenir ses détails, incluez son nom dans la requête : GET /ai-deployer/v1/mlskills?name=sampleClassifierSkill

Dans ce cas, nous cherchons l'ID de la compétence ML pour le sampleClassifierSkill.

Remarque : Lorsque vous utilisez le jeton d'authentification, ajoutez-y le préfixe Bearer.

Dans la réponse ci-dessous, les champs clés sont surlignés en jaune. Utilisez l’ID ML Skill dans le APIs suivant pour modifier l’état :

Mettre à jour les réplicas de compétence ML

Utilisez l'appel UPDATE ML Skill pour modifier la configuration du déploiement d'une compétence ML spécifique.

Dans l'exemple ci-dessous, nous modifions le nombre de répliques en incluant le nouveau numéro dans le corps de la demande.