カスタム質問応答のエクスポート/インポート/更新

2025-06-21

次のようないくつかの理由から、カスタム質問応答プロジェクトまたは関連する質問と応答のペアのコピーを作成することをお勧めします。

バックアップと復元のプロセスを導入する
CI/CD パイプラインと統合するには
データを異なる領域に移動するには

前提条件

Azure サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。
カスタム質問と回答機能が有効になった言語リソース。リソースを作成したときに選んだ Microsoft Entra ID、サブスクリプション、Language リソース名を覚えておいてください。

プロジェクトをエクスポートする

Azure 資格情報を使用して Language Studio にサインインします。
[Answer questions](質問に回答する) セクションまで下にスクロールし、 [Open custom question answering](カスタム質問と回答を開く) を選択します。
エクスポートするプロジェクトを選択します >[エクスポート] を選択します >Excel または TSV のファイルとしてエクスポートするオプションがあります。
エクスポートしたファイルを zip ファイルとしてローカルに保存するように求められます。

プログラムを使用してプロジェクトをエクスポートする

エクスポートプロセスを自動化するには、作成 API のエクスポート機能を使用します。

プロジェクトをインポートする

Azure 資格情報を使用して Language Studio にサインインします。
[Answer questions](質問に回答する) セクションまで下にスクロールし、 [Open custom question answering](カスタム質問と回答を開く) を選択します。
[インポート] を選択し、エクスポートプロセス用に選択したファイルの種類を指定します。 Excel または TSV のいずれかです。
[ファイルの選択] を選択して、前にエクスポートしたプロジェクトのローカル zip 形式のコピーを参照します。
インポートするプロジェクトに一意の名前を指定します。
インポートしたプロジェクトだけを公開したい場合は、引き続きデプロイ/発行する必要があります。

プログラムを使用してプロジェクトをインポートする

インポートプロセスを自動化するには、作成 API のインポート機能を使用します。

ソース URL を更新する

Azure 資格情報を使用して Language Studio にサインインします。
[Answer questions](質問に回答する) セクションまで下にスクロールし、 [Open custom question answering](カスタム質問と回答を開く) を選択します。
更新するソースを含むプロジェクトを選択します > [Manage sources](ソースの管理) を選択します。
必要に応じていつでもロールバックできるよう、各更新を実行する前に、プロジェクトと質問応答のペアのバックアップを取ることをお勧めします。
URL ベースのソースを選択して更新します >[Refresh Url]\(更新 URL\) を選択します。
一度に更新できる URL は 1 つのみです。

プログラムを使用して URL を更新する

URL 更新プロセスを自動化するには、作成 API の更新ソース機能を使用します。

作成 API ドキュメントの更新ソースの例では、URL ベースの新しいソースを追加するための構文が示されています。更新プログラムのクエリの例は次のようになります。

変数名	値
`ENDPOINT`	この値は、Azure portal からリソースを確認する際に、 [Keys & Endpoint](キーとエンドポイント) セクションで確認することができます。または、[Language Studio]>[質問応答]>[プロジェクトのデプロイ]>[Get prediction URL] (予測 URL の取得) で値を見つけることができます。エンドポイントの例: `https://southcentralus.api.cognitive.microsoft.com/`。これが次のコードサンプルのエンドポイントである場合、残りのエンドポイントパスは既に指定されているため、リージョン固有の部分である `southcentral` のみを追加する必要があります。
`API-KEY`	この値は、Azure portal からリソースを確認する際に、 [Keys & Endpoint](キーとエンドポイント) セクションで確認することができます。 Key1 または Key2 を使用できます。常に 2 つの有効なキーを持つことで、ダウンタイムなしで安全にキーのローテーションを行うことができます。または、[Language Studio]>[質問応答]>[プロジェクトのデプロイ]>[Get prediction URL] (予測 URL の取得) で値を見つけることができます。キー値は、サンプル要求の一部です。
`PROJECT-NAME`	ソースを更新するプロジェクトの名前。

curl -X PATCH -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" -d '[
  {
    "op": "replace",
    "value": {
      "displayName": "source5",
      "sourceKind": "url",
      "sourceUri": https://download.microsoft.com/download/7/B/1/7B10C82E-F520-4080-8516-5CF0D803EEE0/surface-book-user-guide-EN.pdf,
      "refresh": "true"
    }
  }
]'  -i 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects/{PROJECT-NAME}/sources?api-version=2021-10-01'

質問応答をエクスポートする

また、カスタム質問応答プロジェクト全体ではなく、質問応答の特定のプロジェクトをエクスポートまたはインポートすることもできます。

Azure 資格情報を使用して Language Studio にサインインします。
[Answer questions](質問に回答する) セクションまで下にスクロールし、 [Open custom question answering](カスタム質問と回答を開く) を選択します。
エクスポートするプロジェクトの質問応答のペアを含むプロジェクトを選びます。
[プロジェクトの編集] を選びます。
[列を表示] の右側に、省略記号ボタン ... があります。 > ... を選択します > 質問応答をエクスポート/インポートするオプションのドロップダウンが表示されます。

Web ブラウザーのサイズによっては、UI が異なる場合があります。小さいブラウザーでは、2 つの別個の省略記号ボタンが表示されます。

質問応答をインポートする