AI Builder使用状況の監視・管理

今回は、AI Builderを使用していく中で、管理者の方が気になる、現在のテナントでどれだけのクレジットを使用しているのか、確認する方法についてご紹介します。

クレジットの考え方やクレジットに対して最初にするべき設定については以下の記事をご参照ください！

https://qiita.com/skuramoto/items/36fc75d9223db5d8feda

今回の記事は、日々の管理に使っていただけるものになっています。


# AI Builder使用状況の監視
AI Builderの使用状況の監視に使用できる方法は３つあります。
① Power Platform管理センターでの管理と②消費レポート、③モデルのアクティビティ監視機能です。
一つずつ見ていきましょう。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2883014/20a6b7f9-4998-c387-b045-1bc838fbbeae.png)


## ①Power Platform管理センター
管理センターでは、テナント全体の使用状況概要を簡単に確認できます。
こちらは、テナント内のクレジット全数、割り当て数、使用数を簡単に確認できるものなので、どちらかというと気軽に確認するときに使用するイメージです。

こちらを使用するためには、管理者 (組織 (テナント)、Power Platform、Dynamics 365 管理者) の権限が必要です。
Power Platform管理センター(https://aka.ms/ppac  )を開きます。

[リソース]>[容量]>[概要]タブの下の方にある、[アドオン]セクションで確認できます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2883014/057295b3-cc3a-3557-d335-5229fec8ba40.png)


## ②消費レポート
消費レポートでは、1か月分の環境のAI クレジット使用量を確認することができます。こちらはレポートをダウンロードして確認するので、管理センターよりは手順が多くなりますが、より詳細を確認することができます。

こちらを使用するためには、管理者 (組織 (テナント)、Power Platform、Dynamics 365 管理者) の権限が必要です。

Power Platform管理センター(https://aka.ms/ppac  )を開きます。
[リソース]>[容量]>[概要]タブの下の方にある、[アドオン]セクションの[レポートのダウンロード]を選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2883014/ec33de38-9d77-3be7-5753-d13c1b9b8d43.png)

上部のメニューで、[+ 新規]を選択します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2883014/467ed9d2-0758-fece-9ebb-56d5ae70728b.png)

レポートを選択するドロップダウンリストで、「AI Builder」を選択し、[送信]をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2883014/f8366e3c-bc45-f58b-6861-68269d222cd6.png)

タイミングを見て画面上部の、[最新のステータスに更新]をクリックし、状態が「完了」に更新されたら、リストでレポートを選択します。
画面上部で、[ダウンロード]を選択してExcel ファイルをダウンロードします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2883014/800e728d-e87b-59de-68dd-51423d9de69a.png)

レポートには、各環境の日付ごとに消費された AI クレジットが表示されます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2883014/689a3278-3290-808d-a801-1d387eea20ad.png)

列名が少しわかりづらいので、それぞれのデータについて以下にまとめます。
|列名 |内容|
|---|---|
|Date|AI クレジットが消費された日付|
|UserId|Dataverse ユーザーテーブルで表示されるユーザー識別子|
|EnvironmentId|Power Apps または Power Automate の URL に表示される識別子 (例: https://make.powerapps.com/environments/%GUID%)|
|EnvironmentName|環境変数の名前|
|AIConsumption |日付、ユーザー環境ごとの消費されたクレジットの数|
|IsTrial |消費されたクレジットが AI Builderの試用クレジットの場合、TRUE|


## ③モデルのアクティビティ監視(プレビュー)
モデルの管理に便利な機能として、現在プレビュー機能ですが、Power AutomateポータルでAI モデルのアクティビティや消費を監視することができるものがリリース予定です。
ここでは環境内のAI モデルや AI モデルで処理されたデータのモニタリングや、AI クレジットの消費状況を把握する表やグラフを確認することができます。

::: note
こちらの機能は環境ごとのデータになるため、テナント内の全環境のクレジットを管理したい場合は、②の消費レポートを使用してください。
:::

こちらはユーザーのロールによって、表示できるデータが異なります。

|ロール |表示できる内容|
|---|---|
|システム管理者 |すべての AI モデルのすべてのアクティビティ|
|システムカスタマイザー|すべての AI モデルのすべてのアクティビティ|
|Basic ユーザー|アクセスできる AI モデルに対する独自のアクティビティのみ|
|環境作成者 |アクセスできる AI モデルに対する独自のアクティビティのみ|

### AI Builder アクティビティ監視データの確認方法
Power Automate(https://make.powerautomate.com )にアクセスし、[詳細]>[すべて検出]をクリックします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2883014/3e2a4476-ffd5-2cd8-7358-1af362476974.png)

[監視]＞[AI Builderの活動(プレビュー)]で表示ができます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2883014/7aaec95d-bbf8-9aa0-3568-e939ecfdf61d.png)

::: note
いつでも見れるようにピン止めしておくと便利です。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2883014/0943b497-e7b2-1fbb-1144-dfd272aa58b3.png)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2883014/74afbf39-b854-63d7-5c83-ff54c9a07a2e.png)
:::

こちらで実行履歴とともに消費クレジットを確認することができます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2883014/c9c76031-e5e0-14af-e358-55b592e68eb9.png)


表示するデータの期間は、既定では過去７日分となっていますが、自由に設定変更できます。
右上の[過去７日間]をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2883014/affe3fd9-e3ce-6f11-d7b3-d6e74748e62c.png)

定義されている期間もありますが、ユーザー定義で期間を１日単位で設定することが可能です。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2883014/e40cb457-0217-70d2-7bf0-7a6f0c0bc94e.png)

右上の[もっと見る]をクリックし、
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2883014/656c5be0-e32c-ee02-b398-13ebda6356af.png)

[表示数を増やす]をクリックすると対象期間のデータを確認することができます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2883014/89b0189b-fb61-e278-c265-30a1479d9a2e.png)


### AI Builder アクティビティ監視データをダウンロードしたい場合
このデータをダウンロードしたい場合、以下の手順でCSVファイルをダウンロードできます。
[テーブル]を表示し、[すべて]を選択します。
右上の検索バーで「AI  Event」を入力し、表示されるAI Eventを選択します。
（表示されなければ、msdyn_aieventを検索バーに入力します。）
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2883014/2ec15471-91e1-1521-2841-5d9bd0f25757.png)

::: note
こちらのAI  Eventテーブルに、AI モデルのアクティビティデータが保存されています。 
このデータには、処理されたデータの種類、テキストシナリオの処理されたデータ情報、処理日、処理ステータス、消費されたクレジットが含まれます。

このデータがモデルのアクティビティ監視機能で表示されているんですね。
:::

テーブルの詳細画面で、画面上側の[エクスポート]をクリックし、[データのエクスポート]を選択します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2883014/cb1192ab-1388-11e5-e1cd-98535def68c2.png)


「正常にエクスポートされました」という表示がされたら、[エクスポートされたデータのダウンロード]をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2883014/8259fed3-25ef-d594-3438-7273a89f0ea1.png)

ローカルのダウンロードフォルダを開き、今ダウンロードしたzipファイルを右クリックします。
[すべて展開]をクリックします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2883014/5c13f7c1-60c4-83e7-1e6f-51267a351f4c.png)

展開されたフォルダの中からcsvファイルを開きます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2883014/73467e8d-26f6-4ad6-6eaf-45787ecf99e4.png)

過去のデータがすべてローカルで閲覧できます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2883014/ccbe6136-bdce-80b9-ecf0-881991204909.png)


### AI Builder アクティビティ監視データを削除したい場合

AI Builder アクティビティ監視データを削除するには、一括削除ジョブを作成する必要があります。
こちらは定期的な実行を設定することも可能です。

Power Platform管理センター(https://aka.ms/ppac  )を開きます。

[環境]を選択し、該当の環境を選択します。
環境詳細画面の上部のメニューバーで[設定]を選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2883014/c4ecc428-36bd-efc4-3307-e91fad0023de.png)


[データ管理]>[一括削除]を選択します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2883014/aaa6e506-00d8-17d6-fc54-68c4f76f3f05.png)


「一括レコード削除システムジョブ」グリッドの上にあるコマンドバーで [新規] を選択します。 
一括削除ウィザード が表示されるので、削除したいレコードのクエリを定義します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2883014/946432eb-c1f9-b11f-59bd-52956384b291.png)


[次へ]を選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2883014/5ee43667-fd65-7cc9-7671-79039f38faf9.png)

検索リストで、「AI Events」を選択します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2883014/aea3ee51-156d-e6da-c21f-df4fa43761d0.png)


検索条件領域で、削除するレコードを返すフィルタリングをすることができます。 
何も設定しないと、すべてのアクティビティを削除します。
[選択]をクリックし、AI Eventテーブルの中の列を選択し、フィルタリング条件を設定します。

例えば以下の画像のように設定すると、「レコード作成日が過去2か月よりも古い」データを削除します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2883014/96a53e67-7450-484f-7f74-be7fc0664da5.png)


条件を設定したら、[次へ]を選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2883014/d332f180-aaed-6073-302c-f602d32087ba.png)



[名前]に、一括削除ジョブの名前を入力します (たとえば、「２か月以上前のデータ一括削除」など)。
[スケジュールされた時刻]セクションで、ジョブの開始日時を選択します。 

::: note
ユーザーが通常オンラインで使っていない時間を選択します。
:::

定期的にこのジョブを実行したい場合は、「このジョブの実行間隔」チェックボックスを選択します。
ジョブを実行する頻度を選択します。
通知メールを受け取りたい場合は、「このジョブが完了したら、自分 (<メール アドレス>) に電子メールを送信する」チェックボックスを選択してください。
[次へ]を選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2883014/6d311d8f-b2bf-81a3-afce-b166b83e7bdf.png)


一括削除の詳細を確認して、[送信]を選択します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2883014/b98dd8d0-3cce-ade5-c56e-a6b4e07fa59b.png)




# まとめ
環境での消費量を確認しながら、クレジットの割り当てを調整しながら運用していきましょう！
環境への割り当ては以下の方法を参照してください。

https://qiita.com/skuramoto/items/36fc75d9223db5d8feda#%E3%82%AF%E3%83%AC%E3%82%B8%E3%83%83%E3%83%88%E3%81%AE%E7%92%B0%E5%A2%83%E3%81%B8%E3%81%AE%E5%89%B2%E3%82%8A%E5%BD%93%E3%81%A6%E6%96%B9%E6%B3%95%E3%81%A8%E5%88%B6%E5%BE%A1%E6%96%B9%E6%B3%95