次の方法で共有

ソリューションを使用して独自のモデルをパッケージ化する

  • [アーティクル]

Python のパッケージを使用して AI Builder に自作モデルを登録した後は、ソリューションを使ってモデルをパッケージ化し、ALM (アプリケーション ライフサイクル マネジメント) タスクを実行することができるようになります。

ソリューションは、アプリとコンポーネントをある環境から別の環境に転送するために使用されます。 また、既存のアプリに一連のカスタマイズを適用するためにも使用されます。 ソリューションの詳細と、ソリューションを使用して Microsoft Power Platform 全体に ALM の概念を適用する方法については、アプリケーション ライフサイクル管理の概要に移動します。

ソリューションを使用して独自のモデルをパッケージ化する

この例では、次の 2 つのソリューションをエクスポートします。

  • カスタム コネクタのみを含むソリューション
  • モデル、接続参照、およびその他のコンポーネントを含むソリューション

  1. Python パッケージを使用して、ソース環境に独自のモデルを登録したことを確認してください。 まだ登録していない場合は、独自モデルの使用に関するチュートリアル (GitHub 上) の手順に従ってください。

  2. モデルに関連付けられているカスタム コネクタを保存するソリューションを作成します。

    1. Power Apps または Power Automate にサイン インします。
    2. 左ペインで、ソリューション>新しいソリューションを選択します。
    3. 新しいソリューション ダイアログで、フィールドに値を入力します。 各フィールドの詳細については、ソリューションを作成するに移動してください。
    4. 作成を選択します。

    カスタム コネクタを保存するソリューションを作成する方法のスクリーンショット。

  3. 既存を追加>オートメーション>カスタム コネクタ を選択して、既存のカスタム コネクタを追加します。

    既存のカスタム コネクタを追加する方法のスクリーンショット。

  4. モデルに関連付けられているカスタム コネクタを選択します。

    名前はこの形式となります: <model_name>-<random number>-v<version>。 このバージョンは、モデルを更新するときに追加するコネクタを区別するのに役立ちます。

    カスタム コネクタの命名形式のスクリーンショット。

  5. ソリューションをエクスポートします。 ソリューションをエクスポートする方法については、Power Apps のエクスポート ソリューションまたは Power Automate のエクスポート ソリューションに移動します。

  6. モデルとその他のコンポーネントを追加するための新しいソリューションを作成します。

    1. ソリューション>新しいソリューションを選択します。
    2. 新しいソリューション ダイアログで、フィールドに値を入力します。
    3. 作成を選択します。

    モデルとその他のコンポーネントを追加するための新しいソリューションを作成する方法のスクリーンショット。

  7. 既存を追加>その他>接続リファレンス (プレビュー) を選択して、既存の接続参照を追加します。

    既存の接続参照を追加する方法のスクリーンショット。

  8. モデルに関連付けられている既存の接続参照を追加します。

    命名形式は、手順 4 のカスタム コネクタと同じです: <model_name>-<random number>-v<version>。

    接続参照の命名形式のスクリーンショット。

  9. 既存を追加>AI モデル を選択して AI モデルを追加します。

    AI モデルを AI Builder に追加する方法を示したスクリーンショット。

    ソリューションには、次の画像に示すコンポーネントが含まれている必要があります。

    追加された 3 つのコンポーネントのスクリーンショット: AI モデル、接続参照、およびカスタム コネクタ。

  10. (オプション) 必要なコンポーネントを追加します。 この例では、モデルを使用するクラウド フローを追加します。

    追加された新しいコンポーネントのスクリーンショット。

  11. ソリューションをエクスポートします。 ソリューションをエクスポートする方法については、Power Apps のエクスポート ソリューションまたは Power Automate のエクスポート ソリューションに移動します。

独自のモデルをターゲット環境にインポートする

この例では、前のセクションで作成した 2 つのソリューションをインポートします。

  • カスタム コネクタのみを含むソリューション
  • モデル、接続参照、およびその他のコンポーネントを含むソリューション

ソリューションをインポートする方法については、Power Apps のインポート ソリューションまたは Power Automate のインポート ソリューションに移動します。

  1. Power Apps または Power Automate にサイン インします。

  2. カスタム コネクタのみを含むソリューションをインポートします。

  3. モデル、接続参照、およびその他のコンポーネントを含むソリューションをインポートします。

  4. インポート プロセス中に、外部エンドポイントへの接続を作成します:

    • エンドポイントが保護されていない場合は、作成を選択します。
    • エンドポイントが API キーで保護されている場合は、API キー フィールドをクリックし、作成を選択します。

    外部エンドポイントへの接続のスクリーンショット。

これで、モデルをターゲット環境で使用する準備が整いました。

インポートしたソリューションのスクリーンショット。

インポートで問題が発生した場合は、ソリューション インポートのトラブルシューティングに移動してください。

独自のモデルをアップグレードする

すべての古いパッチが 1 つの手順でロールアップされるように、ソリューションを最新バージョン番号にアップグレードします。 古いソリューションのバージョンに関連付けられているコンポーネントのうち、新しいソリューションのバージョンに含まれていないものは削除されます。 これにより、古いコンポーネントがソリューションに含まれなくなります。

例では、2 つのソリューションをアップグレードします。

  • カスタム コネクタのみを含むソリューション
  • モデル、接続参照、およびその他のコンポーネントを含むソリューション

アップグレード方法のヘルプについては、ソリューションをアップグレードまたは更新するに移動します。

ソース環境で独自のモデルをアップグレードする

  1. Python パッケージを使用して、ソース環境でアップグレードしたモデルを登録したことを確認してください。 まだ登録していない場合は、独自モデルの使用に関するチュートリアル (GitHub 上) の手順に従ってください。

  2. Power Apps または Power Automate にサイン インします。

  3. カスタム コネクタのみを含むソリューションで、追加を選択して新しい既存のカスタム コネクタを追加します。

  4. フィールドに入力して、新しいバージョンを入力します。 この例では、これが 2 番目のバージョンであるため、v2 です。

  5. ソリューションから古いバージョンのカスタム コネクタを削除します。

    1. 選択 古いバージョンの横にある縦の省略記号 (⋮)。
    2. 削除>このソリューションから削除を選択します。

    ソリューションから古いバージョンを削除するスクリーンショット。

  6. エクスポートを選択してソリューションをエクスポートします。 既定では、バージョンがエクスポート中に増加します。

  7. モデル、接続参照、およびその他のコンポーネントを含むソリューションで、最新バージョンを指すように接続参照を更新します。

    1. カスタム接続には、手順 4 で追加したカスタム コネクタと同じ名前が付けられます。 この例では、v2 が最新バージョンです。
    2. 削除する名前 (この例では v1) を選択してから、削除>このソリューションから削除するを選択することにより、ソリューションから古いバージョンの接続参照を削除します。

  8. エクスポートを選択してソリューションをエクスポートします。 AI モデルとそのモデルを参照するコンポーネントは、最新バージョンを指すように自動的に更新されます。

ターゲット環境で独自のモデルをアップグレードする

  1. Power Apps または Power Automate にサイン インします。

  2. 輸入>アップグレードを選択して、コネクタのみを含むソリューションをインポートします。

  3. インポート>アップグレードを選択して、モデル、接続参照、およびその他のコンポーネントを含むソリューションをインポートします。

  4. 新しいエンドポイントへの新しい接続を作成します:

    1. エンドポイントが保護されていない場合は、作成を選択します。
    2. エンドポイントが API キーで保護されている場合は、API キー フィールドをクリックし、作成を選択します。

    新しいエンドポイントへの接続のスクリーンショット。

これでモデルは、ターゲット環境の新しいエンドポイントを参照するようになりました。

ターゲット環境の新しいエンドポイントを参照するモデルのスクリーンショット。

アップグレードのために独自のモデルをステージングする

アップグレードのためにモデルをステージングしても、モデルが組織にインポートされるだけです。 アクティブにはなりません。 このシナリオでは、環境内のモデルを参照するコンポーネントは、アップグレードを適用してこの手順を完了するまで、古いバージョンを参照します。

ソリューションをインポートする方法については、Power Apps のインポート ソリューションまたは Power Automate のインポート ソリューションに移動します。

  1. Power Apps または Power Automate にサイン インします。

  2. 輸入>アップグレードを選択して、コネクタのみを含むソリューションをインポートします。

  3. インポート>アップグレード用のステージを選択して、モデル、接続参照、およびその他のコンポーネントを含むソリューションをインポートします。

  4. 新しいエンドポイントへの新しい接続を作成します:

    1. エンドポイントが保護されていない場合は、作成を選択します。
    2. エンドポイントが API キーで保護されている場合は、API キー フィールドをクリックし、作成を選択します。

    新しいエンドポイントへの接続のスクリーンショット。

    ソリューションの 2 つのバージョンが表示されます: ベースそしてそのアップグレード。 これらのソリューション以外の環境内のコンポーネントは、引き続き古いバージョンのモデルを参照します。 これらのソリューション内のコンポーネントは、引き続き対応するソリューションに含まれる古いバージョンのモデルを参照します。

    次の例では、ベース ソリューションのクラウドフローは古いバージョンを参照し、新しいソリューションのクラウド フローは新しいバージョンを参照します。

    アップグレードのためにステージングされる前のコンポーネントのスクリーンショット。

  5. 古いバージョンをアップグレードするには、アップグレードを適用するを選択します。

    アップグレードが適用された後のコンポーネントのスクリーンショット。

これで、環境内のすべてのコンポーネントが、モデルの新しいバージョンを参照するようになりました。

アプリケーション ライフサイクル管理の概要。
ALM の基本
ソリューションのインポート
ソリューションのアップグレードまたは更新