次の方法で共有

モデリング サイクルを手動でトリガーする

  • [アーティクル]

この記事は、モデリング リソースのクッキング サイクルを手動で起動する方法である "今すぐモデル化" ツールを使用したい開発者に向けたガイドです。

モデリング リソースが作成され、展開された後も、Intelligent Recommendations サービスは定期的なクッキング サイクルによりデータを処理し続けます。 規定では、データのクッキング サイクルは 36 時間ごとに発生します。

規定の 36 時間スケジュールより前に、モデリング サイクルを手動で起動することも可能です (一部制限あり)。 規定でモデリングがプッシュされる理由としては、直前になってデータの微調整を行った場合や、Azure Data Lake Storage のデータ設定エラーの結果である場合があります。

手動でモデリング プロセスを起動するには、この記事で紹介した API 呼び出しを使用します。

モデリング プロセスを手動でトリガーする方法

Insomnia でモデリングのサイクルを開始する

次の POST リクエストは、新しいモデリング サイクルを開始します:

https://<your-endpoint-url>/Control/V1.0/Model?modeling=<your-modeling-name>

推奨結果を見るためのクイック スタート ガイドに記載の手順でエンドポイント URL を確認することができます。

モデリング プロセスを手動でトリガーする場合の制限事項

手動でモデリング プロセスを起動するには、いくつかの制限事項を覚えておく必要があります:

  • ユーザーは 30 分ごとに新しい 今すぐモデル化 POST 要求を実行できます。

  • ユーザーは 24 時間あたり最大 5 件 の POST 要求を実行できます (ローリング枠)。

  • モデリング パラメータはオプションと見なされます。 何もパラメーターを指定しなかった場合は、既定のモデリング リソースがトリガーされます。

  • 他のすべての API 呼び出しと同様に、POST リクエストによるモデリング処理のトリガーは、Intelligent Recommendations エンドポイントへの認証されたコールであるため、認証の詳細を記述する必要があります。 詳細については、認証付き API 呼び出しのクイック スタート ガイドを参照してください。

API 応答サンプル

成功メッセージ

成功した場合、成功メッセージが表示されます:

{
    "status": "Success",
    "environmentId": "your env id will be written here",
    "version": "20210930173241" // this is the timestamp of the trigger
}

Error message

エラー メッセージが表示される場合があります:

  • クッキング サイクルがすでに進行中の場合
  • 許容される頻度 (最大 24 時間に 5 回、または 30 分間に 1 回) を超える多くのトリガー要求が送信された場合。

次のようなエラーメッセージが表示されます:

{
    "error": {
        "code": "TooManyRequests",
        "message": "Too many requests"
    }
}

モデリング プロセス中に発生する可能性のあるその他のエラー メッセージの詳細については、エラー ログを参照してください。

参照

データ コントラクトの概要
Quick start guide: Create an API request
クイック スタート ガイド: サンプル データで Intelligent Recommendations を設定して実行する
展開の概要