モデルをデプロイする

Language Studio 内からモデルをデプロイするには、次の手順を行います。

1. 左側のメニューから [モデルのデプロイ] を選択します。

2. [デプロイの追加] を選択して、[デプロイの追加] ウィザードを開始します。

   

3. [新しいデプロイ名を作成する] を選択して新しいデプロイを作成し、下のドロップダウンからトレーニング済みのモデルを割り当てます。 それ以外の場合は、[既存のデプロイ名を上書きする] を選択して、既存のデプロイで使用されているモデルを効果的に置き換えることができます。

   Note

   既存のデプロイを上書きする場合、予測 API 呼び出しを変更する必要はなく、新しく割り当てたモデルに基づいて結果が得られるようになります。

   

4. [モデル] ドロップダウンからトレーニング済みのモデルを選択します。

5. [デプロイ] を選択して、デプロイ ジョブを開始します。

6. デプロイが成功すると、その横に有効期限が表示されます。 デプロイの有効期限は、デプロイされたモデルを予測に使用できなくなるときで、通常、トレーニング構成の有効期限が切れる 12 か月後に発生します。

デプロイ ジョブを送信する

会話言語理解モデルのデプロイを始めるには、次の URL、ヘッダー、JSON 本文を使って PUT 要求を作ります。

要求 URL

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/deployments/{DEPLOYMENT-NAME}?api-version={API-VERSION}

ヘッダー

要求を認証するには、次のヘッダーを使います。

要求本文

{
  "trainedModelLabel": "{MODEL-NAME}",
}

API 要求を送信すると、成功を示す 202 応答が返されます。 応答ヘッダーで、operation-___location の値を抽出します。 それは次のように書式設定されています。

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/deployments/{DEPLOYMENT-NAME}/jobs/{JOB-ID}?api-version={API-VERSION}

この URL を使用してデプロイ ジョブの状態を取得できます。

デプロイ ジョブの状態を取得する

プロジェクトのデプロイ要求の送信に成功すると、インポート ジョブの状態を確認するための完全な要求 URL (エンドポイント、プロジェクト名、ジョブ ID を含む) が応答の operation-___location ヘッダーに組み込まれます。

次の GET 要求を使用して、デプロイ ジョブの状態を取得します。 プレースホルダーの値は、実際の値に置き換えます。

要求 URL

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/deployments/{DEPLOYMENT-NAME}/jobs/{JOB-ID}?api-version={API-VERSION}

ヘッダー

要求を認証するには、次のヘッダーを使います。

応答本文

要求を送信すると、次の応答を受け取ります。 status パラメーターが "succeeded" に変化するまで、このエンドポイントのポーリングを続けます。

{
    "jobId":"{JOB-ID}",
    "createdDateTime":"{CREATED-TIME}",
    "lastUpdatedDateTime":"{UPDATED-TIME}",
    "expirationDateTime":"{EXPIRATION-TIME}",
    "status":"running"
}

Language Studio 内からデプロイをスワップするには

1. [モデルのデプロイ] ページで、スワップする 2 つのデプロイを選択し、上部のメニューから [展開のスワップ] を選択します。

2. 表示されたウィンドウで、スワップするデプロイの名前を選びます。

   

デプロイ スワップ ジョブを始めるには、次の URL、ヘッダー、JSON 本文を使って POST 要求を作ります。

要求 URL

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/deployments/:swap?api-version={API-VERSION}

ヘッダー

要求を認証するには、次のヘッダーを使います。

要求本文

{
  "firstDeploymentName": "{FIRST-DEPLOYMENT-NAME}",
  "secondDeploymentName": "{SECOND-DEPLOYMENT-NAME}"
}

API 要求を送信すると、成功を示す 202 応答が返されます。

Language Studio 内からデプロイを削除するには、[モデルのデプロイ] ページを選択します。 次に、削除するデプロイを選択し、上部のメニューから [デプロイの削除] を選択します。

会話言語理解のデプロイを削除するには、次の URL、ヘッダー、JSON 本文を使って DELETE 要求を作成します。

要求 URL

{ENDPOINT}/language/authoring/analyze-conversations/projects/{projectName}/deployments/{deploymentName}?api-version={API-VERSION}

ヘッダー

要求を認証するには、次のヘッダーを使います。

API 要求を送信すると、成功を示す 202 応答を受け取ります。これは、デプロイが削除されたことを意味します。

Language Studio で他のリージョンにデプロイ リソースを割り当てるには:

1. プロジェクトの作成に使用したリソースに Cognitive Services Language 所有者 として自分自身を割り当てていることを確認します。
2. Language Studio の [モデルのデプロイ] ページに移動します。
3. [領域] タブを選択します。
4. [デプロイ リソースの追加] を選択します。
5. 別のリージョンで Language リソースを選びます。

これで、リソースを割り当てたリージョンにプロジェクトをデプロイする準備ができました。

デプロイ リソースをプログラムで割り当てるには、Microsoft Entra 認証**が必要です。 Microsoft Entra ID は、複数リージョンのデプロイのためにプロジェクトに割り当てる目的のリソースへのアクセス権があることを確認するために使用されます。 REST API の呼び出しを行うときにプログラムで Microsoft Entra 認証を使うには、Azure AI サービスの認証に関するドキュメントをご覧ください。

リソースを割り当てる

以下の URL、ヘッダー、JSON 本文を使って POST 要求を送信し、デプロイ リソースを割り当てます。

要求 URL

API 要求を作るときは、次の URL を使います。 次のプレースホルダーの値を実際の値に置き換えてください。

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/resources/:assign?api-version={API-VERSION}

ヘッダー

Microsoft Entra 認証を使用して、この API を認証します。

Body

次のサンプル JSON を本文として使います。

{
  "resourcesMetadata": [
    {
      "azureResourceId": "{AZURE-RESOURCE-ID}",
      "customDomain": "{CUSTOM-DOMAIN}",
      "region": "{REGION-CODE}"
    }
  ]
}

リソースの割り当て状態を取得する

デプロイ リソース割り当てジョブの状態を取得するには、次の GET 要求を使います。 次のプレースホルダーの値を実際の値に置き換えてください。

要求 URL

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/resources/assign/jobs/{JOB-ID}?api-version={API-VERSION}

ヘッダー

要求を認証するには、次のヘッダーを使います。

応答本文

要求を送信すると、次の応答を受け取ります。 status パラメーターが "succeeded" に変化するまで、このエンドポイントのポーリングを続けます。

{
    "jobId":"{JOB-ID}",
    "createdDateTime":"{CREATED-TIME}",
    "lastUpdatedDateTime":"{UPDATED-TIME}",
    "expirationDateTime":"{EXPIRATION-TIME}",
    "status":"running"
}

Language Studio を使用して他のリージョンのデプロイ リソースの割り当てを解除または削除するには:

1. [モデルのデプロイ] ページの [リージョン] タブに移動します。
2. 割り当てを解除するリソースを選択します。
3. [割り当ての削除] ボタンを選択します。
4. 表示されるウィンドウに、削除するリソースの名前を入力します。

リソースの割り当てを解除する

プロジェクトからデプロイ リソースの割り当てを解除または削除するには、以下の URL、ヘッダー、JSON 本文を使って POST 要求を送信します。

要求 URL

API 要求を作るときは、次の URL を使います。 次のプレースホルダーの値を実際の値に置き換えてください。

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/resources/:unassign?api-version={API-VERSION}

ヘッダー

要求を認証するには、次のヘッダーを使います。

本文

次のサンプル JSON を本文として使います。

{
  "assignedResourceIds": [
    "{AZURE-RESOURCE-ID}"
  ]
}

リソースの割り当て解除状態を取得する

デプロイ リソースの割り当て解除ジョブの状態を取得するには、次の GET 要求を使います。 次のプレースホルダーの値を実際の値に置き換えてください。

要求 URL

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/resources/unassign/jobs/{JOB-ID}?api-version={API-VERSION}

ヘッダー

要求を認証するには、次のヘッダーを使います。

応答本文

要求を送信すると、次の応答を受け取ります。 status パラメーターが "succeeded" に変化するまで、このエンドポイントのポーリングを続けます。

{
    "jobId":"{JOB-ID}",
    "createdDateTime":"{CREATED-TIME}",
    "lastUpdatedDateTime":"{UPDATED-TIME}",
    "expirationDateTime":"{EXPIRATION-TIME}",
    "status":"running"
}