AI Center

ML スキル

ML スキルの使用例については、こちらのセクションをご覧ください。

AI Center API を使用してインフラストラクチャコストを削減

API 要求を使用すると、ML スキルのステートをプログラムで変更できます。これらの API をオートメーションワークフロー内でも使用して ML スキルをデプロイ/デプロイ解除できるため、インフラストラクチャの稼働時間を最適化してコストを削減できます。 Swagger に記載されている AI Center API の完全なセットをご覧ください。

accountnameとtenantnameはアカウント固有であることに注意してください。詳細については、 API リストを参照してください。

AI Center API は、以下の目的に使用します。

sampleClassifierSkill の ML スキル ID を探します。
ML スキルを停止 (デプロイ解除) する
開始 (再デプロイ) し、状態の更新を確認します。

2022 年 11 月、UiPath は、AI Center 内のすべてのコンポーネントとプログラムを使用して対話するための API の提供を発表しました。ユーザーインターフェイスを使用することなく、API を使用してデータセットの管理、ML モデルのトレーニング、ML スキルのデプロイを行えるようになりました。

API を活用する主なユースケースの 1 つは、ML スキルのデプロイステータスを管理することです。オートメーションによっては、ML スキルを常にアクティブにしておく必要がない場合があります。 ML スキルを、使用していないときにデプロイ解除することで、ハードウェアコスト (AI ユニット) を節約できます。

AI Center API にアクセスするには、次の手順に従ってください。

外部アプリケーションの登録 (ワンタイムセットアップ)
認証トークンの生成 (有効期限満了時に更新)
AI Center API 呼び出しを実行する

メモ：最初の 2 つの手順では、アプリケーションが登録および認証されていることを確認して、アクセス制御を適用します

外部アプリケーションを登録する

API を使用するには、アプリを AI Center スコープを持つ外部アプリケーションとして登録する必要があります。

左側のナビゲーションパネルで [ Admin ] ページに移動し、[ External Applications] を選択します。
新しい外部アプリケーションを追加するには、 + Add Application
そしてそれに名前を付けます。

メモ： AI Center API にアクセスできるのはconfidential application の種類のみです。
外部アプリケーションに対する AI Center のスコープを有効化するには、以下の手順を実行します。
1. Add scope を選択
2. [リソース] ドロップダウンから AI Center API Access (preview) を選択します。
3. [ Application Scope ] タブに移動します
4. アクセスを有効化する API を選択します。
次の例では、わかりやすくするためにすべての API が選択されていますが、特定の外部アプリケーションへのアクセス権を特定の API に割り当てることもできます。
[ Add] を選択します。アプリ ID とアプリシークレットを含むポップアップが生成されます。
ヒント：アプリ ID とアプリシークレットは、[ 外部を編集] アプリケーションからいつでも表示できます。これらの資格情報は、次の手順で認証トークンを生成するために使用されます。外部アプリケーションの管理に関する追加情報をご覧ください。

認証トークンの生成

認証とセキュリティで保護されたアクセスのため、外部アプリケーションは UiPath Identity Server にアクセストークンを要求します。生成された認証トークンは 1 時間で有効期限が切れるので、その時間で新しい認証トークンを再生成する必要があります。

Postman を使用する場合は、無料で登録して、Postman Web ベースのインターフェイスまたはダウンロード可能なアプリケーションのいずれかを使用することを選択できます。郵便配達員の公式ウェブサイトを参照してください。

Identity Server エンドポイント https://cloud.uipath.com/identity_/connect/token に対して、要求の本文に以下を含む POST 要求を生成します。
```
client_id: App ID from previous step
client_secret: App Secret from previous step
grant_type: “client_credentials”client_id: App ID from previous step
client_secret: App Secret from previous step
grant_type: “client_credentials”
```
[ grant_type ] を [client_credentials] に設定します。

Postman には application/x-www-form-urlencoded コンテンツタイプを使用します。

この要求では、この外部アプリケーションに対して有効化されている権限のリストが示された次のような認証トークンが生成されます。この認証トークンは、AI Center の API 呼び出しを行う際に使用します。

認証情報と認証トークンに関する追加情報をご覧ください。

AI Center API 呼び出しを実行する

API 呼び出しは、次の構造に従います。 https://cloud.uipath.com/accountname/tenantname/aifabric_/ ここで、「accountname」と「tenantname」はアカウントに固有です。ほとんどの API には、次の情報が必要です。

アカウント ID と テナント ID。アカウントとテナントの情報は、テナント内のプロファイル情報セクションで確認できます。プロファイル情報を参照してください。
承認。認可フィールドには、前の手順で生成された認証トークンを入力する必要があります。
大事な：認証トークンを使用する場合は、下図のスクリーンショットのように先頭に Bearer を付けます。

これで、特定の API にアクセスできるようになりました。この例では sampleClassifierSkill を使用します。 [ML スキル] リストで、このスキルが存在し、現在 [利用可能 ] ステートであることを確認できます。

ML スキルの詳細を確認

GET ML Skills 呼び出しを使用すると、アカウントとテナント内のすべての ML スキルのリストを取得できます。また、ML スキル名をクエリの一部として追加して、特定の ML スキルを検索し、その詳細を取得することもできます。この場合、対象の ML スキル idが表示されます sampleClassifierSkill

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

以下の応答では、キーフィールドが黄色で強調表示されています。 sampleClassifierSkill が [使用可能] 状態であることを再確認します。ML スキル id は、後続の API でステートを更新するために使用されます。

ML スキルを停止

ML スキルを停止するには、以下の手順を実行します。

要求クエリにstop更新アクションと ML スキル idを含める必要があります
ヘッダーにはアカウント、テナント、認証の情報を含める必要があります

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

応答は、ML スキルのステータスの変更が成功したことを示しています。

UI を確認すると、 sampleClassifierSkill 展開解除されたことを確認できます。

ML スキルを再開

ML スキルを再起動 (デプロイ) するには、 updateType を [再開] に設定して API 呼び出しを実行します。

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

応答から、要求が成功し、スキルの状態が [デプロイ中] に更新されたことがわかります。

スキルが利用可能になるまで待ち、 GET ML Skill details API を使用して ML スキルのステータスを確認します。

応答から、ML スキルがデプロイされ、利用可能になります。 UIでスキルの可用性を確認します。これで、ワークフロー内にデプロイされた ML スキル sampleClassifierSkill をオートメーションで活用して予測を作成できるようになりました。

API を使用して ML スキルのデプロイを更新する

AI Center API にアクセスするには、以下の手順を実行します。

外部アプリケーションを登録する (1 回限りのセットアップ)。
認証トークンを生成します (有効期限が切れると更新されます)。
AI Center の API 呼び出しを実行します。

メモ：最初の 2 つの手順では、アプリケーションが登録および認証されていることを確認することで、アクセス制御を適用します。アプリケーションにアクセスするには、アプリケーションを登録して認証する必要があります。 (ステップ 1 および 2)

外部アプリケーションを登録する

これらの API を使用するには、AI Center のスコープ内でアプリを外部アプリケーションとして登録する必要があります。

左側のナビゲーションパネルから [ 管理 ] ページに移動し、[ 外部アプリケーション] を選択します。
[ + アプリケーションを追加 ] を選択して名前を付け、新しい外部アプリケーションを追加します。
メモ： AI Center API にアクセスできるのは機密アプリケーションのみです。
[ スコープを追加 ] を選択して、外部アプリケーションに対する AI Center スコープを有効化します。
- [ リソース ] ドロップダウンから [AI Center API Access (プレビュー)] を選択します。
- [ アプリケーションスコープ] タブに移動し、外部アプリケーションへのアクセスを許可する API を選択します。以下の例では、わかりやすくするためにすべての API を選択しています。
ポップアップにアプリ ID とアプリシークレットが表示され、アプリケーションが正常に追加されたことが確認されます。アプリ ID とアプリシークレットは、[ 外部を編集] アプリケーションからいつでも確認できます。
メモ：これらの資格情報を使用して、次の手順で認証トークンを生成します。