Économisez des coûts d'infrastructure grâce aux API AI Center

Avec les requêtes API, vous pouvez modifier par programmation l'état d'une compétence ML. Ces API peuvent être utilisées même dans un workflow d'automatisation pour déployer et annuler le déploiement d'une compétence ML, optimisant la disponibilité de l'infrastructure et permettant d'économiser des coûts. Vérifiez l'ensemble complet des API AI Center documenté dans la documentation Swagger.

Notez que accountname et tenantname sont spécifiques à votre compte. Pour plus d'informations, consultez la liste des API .

Vous utilisez les API AI Center pour :

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

En novembre 2022, nous avons annoncé la disponibilité d'API pour interagir de manière programmatique avec chaque composant d'AI Center. Vous pouvez désormais gérer des ensembles de données, entraîner des modèles ML et déployer des compétences ML à l'aide d'API, sans avoir à utiliser l'interface utilisateur.

L'un des principaux cas d'utilisation pour tirer parti des API consiste à gérer le statut de déploiement d'une compétence ML. Selon l'automatisation, vous n'avez peut-être pas besoin qu'une compétence ML soit active tout le temps. Annuler le déploiement des compétences ML lorsqu'elles ne sont pas utilisées peut vous aider à économiser sur les coûts matériels (AI Units).

Les étapes pour accéder aux API AI Center sont :

1. Enregistrement d'une application externe (configuration unique)
2. Génération d'un jeton d'authentification (renouvellement à l'expiration)
3. Passer 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

Enregistrement d'une application externe

Pour utiliser les API, votre application doit s'enregistrer en tant qu'application externe avec une étendue AI Center.

1. Dans le panneau de navigation de gauche, accédez à la page Admin et sélectionnez External Applications.
2. Pour ajouter une nouvelle application externe, sélectionnez + Add Application

   et nommez-le.

   Remarque : seul le typeconfidential application peut accéder aux API AI Center.
3. Pour activer l'étendue AI Center sur l'application externe :
   1. Sélectionner Add scope
   2. Choisissez AI Center API Access (preview) dans la liste déroulante des ressources.
   3. Accédez à l'onglet Application Scope
   4. Sélectionnez les API auxquelles vous souhaitez autoriser l'accès.
   Dans l'exemple suivant, toutes les API ont été sélectionnées pour plus de simplicité, mais vous pouvez choisir d'attribuer à des API spécifiques l'accès à des applications externes spécifiques.
   
   

   

   
   
4. Sélectionnez Add. Une fenêtre contextuelle avec l' ID d'application et une clé secrète d'application est générée.
   Astuce : vous pouvez afficher l' ID de l'application et la clé secrète de l'application à tout moment à partir de l' activité Modifier l'application externe (Edit External application). Ces informations d'identification sont utilisées pour générer un jeton d'authentification lors de l'étape suivante. Consultez les informations supplémentaires sur la gestion des applications externes.
   
   

   

   
   

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

Pour l’authentification et l’accès sécurisé, l’application externe demande un jeton d’accès à UiPath® Identity Server. Le jeton d'authentification généré expire au bout d'une heure, après quoi vous devez régénérer un nouveau jeton d'authentification.

Si vous souhaitez utiliser Postman, vous pouvez vous inscrire gratuitement et choisir d’utiliser l’interface Web Postman ou l’application téléchargeable. Consultez le site Web officiel de Postman pour plus d'informations.

1. Générez une requête POST au point de terminaison d'Identity Server https://cloud.uipath.com/identity_/connect/token qui inclut les éléments suivants dans le corps de la requête.

   client_id: App ID from previous step
   client_secret: App Secret from previous step
   grant_type: “client_credentials”

2. Définissez grant_type sur client_credentials.

Utilisez le type de contenu application/x-www-form-urlencoded pour Postman.

Cette requête génère un jeton d'authentification similaire à la capture d'écran suivante, répertoriant les autorisations activées pour cette application externe. Utilisez ce jeton d'authentification lors des appels d'API AI Center.

Vérifiez les informations supplémentaires sur les informations d’identification et les jetons d’authentification.

Passer des appels API AI Center

Les appels d'API respectent la structure suivante : https://cloud.uipath.com/accountname/tenantname/aifabric_/ où « accountname» et « tenantname » sont spécifiques à votre compte. La plupart des API nécessitent les informations suivantes :

1. ID de compte et ID de locataire. Vous pouvez trouver les informations de compte et de locataire dans la section d'informations de profil du locataire. Vérifiez les informations du profil pour plus d'informations.
2. Autorisation. Le champ d'autorisation doit être renseigné avec le jeton d'authentification généré à l'étape précédente.
   Attention : Lorsque vous utilisez le jeton d'authentification, ajoutez-y le préfixe du porteur.

Vous pouvez désormais accéder à des API spécifiques. Utilisez sampleClassifierSkill pour cet exemple. Dans la liste des compétences ML, vous pouvez observer que cette compétence existe et qu'elle est actuellement à l'état Disponible .

Rechercher les détails de la compétence ML

À l'aide de l'appel GET ML Skills , vous pouvez récupérer une liste de toutes les compétences ML du compte et du locataire. Vous pouvez également ajouter le nom de la compétence ML dans le cadre de la requête pour rechercher une compétence ML spécifique et récupérer ses détails. Dans ce cas, vous trouvez la compétence ML idpour le sampleClassifierSkill

GET /ai-deployer/v1/mlskills?name=sampleClassifierSkill

Dans la réponse suivante, les champs clés sont surlignés en jaune. Vérifiez que sampleClassifierSkill est à l'état Disponible (Available). La compétence ML id est utilisée dans les API suivantes pour mettre à jour l'état.

Arrêter la compétence ML

Pour arrêter une compétence ML :

• La requête la demande doit contenir l'action de mise à jour stop et la compétence ML id
• L'en-tête doit contenir des informations de compte, de locataire et d'authentification

PUT /ai-deployer/v2/mlskills/stop/{mlSkillId}

La réponse montre que le changement de statut de la compétence ML a réussi :

En vérifiant l'IU, vous pouvez vérifier que sampleClassifierSkill n'a pas été déployé.

Reprendre la compétence ML

Pour redémarrer (déployer) la compétence ML, effectuez les appels d'API en ayant updateType défini sur Reprendre (Resume).

POST /ai-deployer/v1/mlskills/{mlSkillId}?updateType=RESUME

{ "deploymentsRequired": 1, 
"gpuRequired": 0, 
"mlPackageVersionId": <package-version-id>, 
"processor": "CPU", 
"publicSkill": false, 
"autoUpdate": false, 
"inactivityPeriodInDays": 7, 
"replicas": 1, 
"requestMemory": 2, 
"requestCPU": 0.5, 
"limitMemory": 9, 
"limitCPU": 2 
}

À partir de la réponse, vous pouvez observer que la demande a réussi et que l'état de la compétence a été mis à jour vers Déploiement (Deploying).

Attendez que la compétence soit disponible et vérifiez le statut de la compétence ML à l'aide de l'API de détails GET ML Skill .

À partir de la réponse, la compétence ML est maintenant déployée et disponible. Vérifiez la disponibilité de la compétence dans l'interface utilisateur. Désormais, vos automatisations peuvent tirer parti de la compétence ML déployée sampleClassifierSkill dans les workflows pour faire des prédictions.