言語 - 質疑応答
言語 - 質問応答 API はクラウドベースのサービスであり、最先端のトランスフォーマー モデルを使用して高度な自然言語処理を提供し、カスタムの質問応答プロジェクトまたは生のテキストに対する回答を生成します。 質問応答は、QnA Maker サービスから拡張された言語サービスの機能であり、非構造化ドキュメントのサポートや正確な回答などの追加機能があります。
このコネクタは、次の製品および地域で利用可能です:
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure China の地域 |
| Power Automate | Premium | 以下を除くすべての Power Automate 地域 : - 21 Vianet が運用する中国のクラウド |
| Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - 21 Vianet が運用する中国のクラウド |
| お問い合わせ先 | |
|---|---|
| 件名 | 質問回答サポート |
| [URL] | https://portal.azure.com/#blade/Microsoft_Azure_Support/HelpAndSupportBlade/overview |
| メール | qnamakersupport@microsoft.com |
| Connector Metadata | |
|---|---|
| 発行者 | Microsot |
| Web サイト | https://azure.microsoft.com/en-us/services/cognitive-services/question-answering/#overview |
| プライバシー ポリシー | https://privacy.microsoft.com/en-us/privacystatement |
| カテゴリー | AI;Web サイト |
言語 - 質問応答コネクタは、Power アプリを言語サービス内の新しい質問応答機能と統合するためのコネクタです。 このコネクタを使用すると、ユーザーは質問応答の新機能と拡張機能に接続できるようになります。 このコネクタには、ユーザーが行うのに役立つアクションがあります
- プロジェクトから回答を生成する
- プロジェクトのメタデータの取得
- 提供されたテキストから一定期間にわたって回答を生成します。お客様により多くの機能を提供するために、より多くのアクションを展開する予定です。
前提条件
こちら の指示に従って、カスタム質問応答プロジェクトを作成します。
資格情報の入手方法
- プロジェクトをデプロイした後、"予測 URL を取得する" をクリックします。
- 予測 URL のホスト名とアカウント キー (Ocp-Apim-Subscription-Key) からサイト URL を取得します。
- 自分のアカウント キーとサイト URL を入力して、接続します。
コネクタの使用を開始する
フローでコネクタを使用する
- Microsoft Power Automate に移動して、作成 をクリックして、"インスタント クラウド フロー" を選択します。
- このコネクタをテストするには、"手動でフローをトリガーする" をクリックして、
Createをクリックします。
- "新規ステップ" をクリックし、"言語 – 質問応答" を検索して、3 つのアクションから選択します。
アクション:
プロジェクトから回答を生成する
- このアクションは、プロジェクトのナレッジベースを使用して指定された質問に回答するのに役立ちます。
- "サンプル プロジェクト" から回答を生成するために、このクエリを提供できます
- リクエスト本文の詳細については、こちら 質問応答 - 回答を取得 - REST API (Azure Cognitive Services) | Microsoft Docs をご覧ください
プロジェクトのメタデータの取得
- このアクションは、プロジェクトのすべてのメタデータを取得するのに役立ちます。
- プロジェクト名を指定して、プロジェクトのメタデータを取得します。
提供されたテキストから回答を生成する
- このアクションは、提供されたテキストを使用して指定された質問に答えるのに役立ちます。 このアクションのみを使用するには、言語リソースでカスタム質問応答を有効にする必要はありません。
- このアクションには、カスタム質問応答プロジェクトは必要ありません。 これには言語リソースのみが必要です。 言語リソースを作成し、Azure ポータルのキー セクションとエンドポイント セクションでエンドポイントとキーをそれぞれサイト URL とアカウント キーにコピーできます。
- クエリ "表面を充電するのにどれくらい時間がかかりますか？ "次のテキストで:" 電源と充電。 空の状態から Surface Pro 4 のバッテリーを完全に充電するには、2〜4 時間かかります。 充電中に Surface をゲームやビデオ ストリーミングなどの電力を大量に消費するアクティビティに使用している場合は、さらに時間がかかることがあります。"
- リクエスト本文の詳細については、こちら 質問応答 - テキストから回答を取得 - REST API (Azure Cognitive Services) | Microsoft Docs をご覧ください
回答
プロジェクトから回答を生成する
"アクセシビリティ" という質問に対する "サンプルプロジェクト" からの回答が返されます。 このアクションの応答オブジェクトについて詳しくは、次の Web サイトをご覧ください。質問応答 - 回答を取得 - REST API (Azure Cognitive Services) | Microsoft Docs
提供されたテキストから回答を生成する
それは与えられたテキストからあなたの質問に対する答えを抽出します。 このアクションの応答オブジェクトについて詳しくは、次の Web サイトをご覧ください。質問応答 - 回答を取得 - REST API (Azure Cognitive Services) | Microsoft Docs
プロジェクトのメタデータの取得
要求されたプロジェクトのメタデータを取得します。 このアクションの応答オブジェクトについて詳しくは、次の Web サイト 質問応答 - 回答を取得 - REST API (Azure Cognitive Services) | Microsoft Docs をご覧ください。
既知の問題と制限事項
何も見つかりませんでした。もし問題ある場合は、qnamakersupport@microsoft.com までご連絡ください
一般的なエラーと解決策
次のドキュメントを参照してください: https://docs.microsoft.com/en-us/rest/api/cognitiveservices/questionanswering/question-answering
よくあるご質問
次のドキュメントを参照してください: https://docs.microsoft.com/en-us/azure/cognitive-services/language-service/question-answering/overview
接続を作成する
このコネクタは、次の認証タイプをサポートしています:
| API キー | ApiKey | すべての地域 | 共有可能 |
| Azure AD 統合 | Azure Active Directory を使用して、Azure Blob Storage にアクセスします。 | すべての地域 | 共有不可 |
| 既定 [非推奨] | このオプションは、明示的な認証の種類を持たない古い接続専用に対してのみ使用され、下位互換性を保つためにのみ提供されます。 | すべての地域 | 共有不可 |
API キー
認証 ID: keyBasedAuth
適用できるもの: すべての領域
ApiKey
これは共有可能な接続です。 Power App が他のユーザーと共有されている場合、接続も共有されます。 詳細については、キャンバス アプリのコネクタの概要 - Power Apps | Microsoft Docs を参照してください
| 名前 | タイプ | 説明 | 必須 |
|---|---|---|---|
| アカウント キー | securestring | Azure ポータルからコピーする言語リソースのエンドポイントキー | True |
| サイトの URL | 文字列 | Azure ポータルからコピーする言語リソースのエンドポイントキー | True |
Azure AD 統合
Auth ID: tokenBasedAuth
適用可能: すべての領域
Azure Active Directory を使用して、Azure Blob Storage にアクセスします。
これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | 説明 | 必須 |
|---|---|---|---|
| サイトの URL | 文字列 | Azure ポータルからコピーする言語リソースのエンドポイントキー | True |
既定 [非推奨]
適用可能: すべての領域
このオプションは、明示的な認証の種類を持たない古い接続専用に対してのみ使用され、下位互換性を保つためにのみ提供されます。
これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | 説明 | 必須 |
|---|---|---|---|
| アカウント キー | securestring | Azure ポータルからコピーする言語リソースのエンドポイントキー | True |
| サイトの URL | 文字列 | Azure ポータルからコピーする言語リソースのエンドポイントキー | True |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| プロジェクトから回答を生成する |
このアクションは、プロジェクトのナレッジベースを使用して指定された質問に回答するのに役立ちます。 |
| プロジェクトのメタデータの取得 |
このアクションは、プロジェクトのすべてのメタデータを取得するのに役立ちます。 |
| 提供されたテキストから回答を生成する |
このアクションは、提供されたテキストを使用して指定された質問に答えるのに役立ちます。 |
プロジェクトから回答を生成する
このアクションは、プロジェクトのナレッジベースを使用して指定された質問に回答するのに役立ちます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
プロジェクト名
|
projectName | True | string |
これは使用したいプロジェクト名です。 |
|
質問
|
question | True | string |
プロジェクトに対してクエリするユーザーの質問。 |
|
ユーザー ID
|
userId | string |
ユーザーを表す一意の識別子です。 |
|
|
上位 #
|
top | integer |
質問に対して返される回答の最大数 |
|
|
Confidence Threshold
|
confidenceScoreThreshold | float |
回答の最小しきい値スコア。 値の範囲は 0 から 1 です。 |
|
|
ランカーの種類
|
rankerType | string |
使用されるランカーの種類。 |
|
|
QnA ID
|
qnaId | string |
これは、プロジェクトからフェッチする正確な QnA ID です。 |
|
|
以前の QnA ID
|
previousQnaId | integer |
以前の上位回答結果 QnA ID。 |
|
|
以前のユーザー クエリ
|
previousUserQuery | string |
以前のユーザー クエリ。 |
|
|
key
|
key | string |
QnA で使用されるメタデータ辞書のメタデータキー。 |
|
|
値
|
value | string |
QnA で使用されるメタデータ辞書からのメタデータ値。 |
|
|
Join Metadata with
|
logicalOperation | string |
メタデータ フィルターの対応する論理演算には、'OR' または 'AND' を設定します。 |
|
|
ソース フィルター
|
sourceFilter | string |
プロジェクト内の指定されたソースのリストのいずれかに関連付けられている QnA を検索します。 |
|
|
Join Filters with
|
logicalOperation | string |
メタデータ フィルターをソース フィルターと結合するために使用される論理演算。 |
|
|
Enable precise answer
|
enable | boolean |
Answer Span 予測を有効または無効にします。 |
|
|
Confidence Threshold
|
confidenceScoreThreshold | float |
正確な回答を含めるために必要な最小しきい値スコア。値の範囲は 0〜1 です。 |
|
|
上位 #
|
topAnswersWithSpan | integer |
正確な回答予測の 1 から 10 までの上位回答の数。 |
|
|
Include Unstructured Sources
|
includeUnstructuredSources | boolean |
非構造化ソースに対するクエリを有効にするフラグ。 |
|
|
Deployment Name
|
deploymentName | True | string |
これは、使用するプロジェクトの特定の展開です。 |
|
API Version
|
api-version | True | string |
これは、クライアント API バージョンです。 |
戻り値
質問回答のリストを表します。
- Body
- AnswersResult
プロジェクトのメタデータの取得
このアクションは、プロジェクトのすべてのメタデータを取得するのに役立ちます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
プロジェクト名
|
ProjectNamePathParameter | True | string |
使用するプロジェクトの名前。 |
|
API Version
|
api-version | True | string |
これは、クライアント API バージョンです。 |
戻り値
プロジェクトを表します。
- Body
- ProjectMetadata
提供されたテキストから回答を生成する
このアクションは、提供されたテキストを使用して指定された質問に答えるのに役立ちます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
質問
|
question | True | string |
指定されたテキストレコードに対してクエリを実行するためのユーザーの質問。 |
|
id
|
id | True | string |
テキスト レコードの一意識別子。 |
|
テキスト
|
text | True | string |
レコードのテキストの内容。 |
|
Language
|
language | string |
テキスト レコードの言語。 これは、言語の BCP-47 表現です。 |
|
|
文字列インデックス タイプ
|
stringIndexType | string |
文字列オフセットの解釈に使用する方法を指定します。 既定は Unicode v8.0.0 に基づくテキスト要素 (書記素) です。 詳細については https://aka.ms/text-analytics-offsets を参照してください。 |
|
|
API Version
|
api-version | True | string |
これは、クライアント API バージョンです。 |
戻り値
回答結果を表します。
定義
ProjectMetadata
プロジェクトを表します。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
projectName
|
projectName | string |
プロジェクトの名前です。 |
|
説明
|
description | string |
プロジェクトの説明。 |
|
Language
|
language | Language |
テキスト レコードの言語。 これは、言語の BCP-47 表現です。 |
|
defaultAnswer
|
settings.defaultAnswer | string |
ナレッジ ベースに適切な一致が見つからない場合の既定の回答応答。 |
|
multilingualResource
|
multilingualResource | boolean |
プロジェクト間で複数の言語に対してリソースが有効になっているかどうか。 |
|
createdDateTime
|
createdDateTime | date-time |
プロジェクト作成日時。 |
|
lastModifiedDateTime
|
lastModifiedDateTime | date-time |
プロジェクトの最終変更日時を表します。 |
|
lastDeployedDateTime
|
lastDeployedDateTime | date-time |
プロジェクトの最終展開日時を表します。 |
Language
AnswersResult
質問回答のリストを表します。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
回答
|
answers | array of KnowledgeBaseAnswer |
回答結果リストを表します。 |
|
isUserQuestionAmbiguous
|
isUserQuestionAmbiguous | boolean |
ユーザーの質問があいまいな場合はブール値を返します。 |
KnowledgeBaseAnswer
プロジェクトの回答を表します。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
質問
|
questions | array of string |
回答と関連した質問の一覧。 |
|
回答
|
answer | string |
回答のテキスト。 |
|
Confidence Threshold
|
confidenceScore | float |
自信スコアに答えてください。値の範囲は 0 から 1 です。 |
|
QnA ID
|
id | integer |
QnA 結果の ID。 |
|
ソース
|
source | string |
QnA 結果のソース。 |
|
メタデータ
|
metadata | object |
回答に関連付けられたメタデータ。質問の回答を分類またはフィルタリングするのに役立ちます。 |
|
ダイアログ
|
dialog | KnowledgeBaseAnswerDialog |
回答に関連付けられたダイアログ。 |
|
answerSpan
|
answerSpan | AnswerSpan |
QnA の回答スパン オブジェクト。 |
KnowledgeBaseAnswerDialog
回答に関連付けられたダイアログ。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
isContextOnly
|
isContextOnly | boolean |
プロンプトが前の質問にのみ関連するかどうかをマークします。 true の場合、コンテキストのないクエリの検索結果としてこの QnA を含めないでください。それ以外の場合、false の場合、コンテキストを無視し、この QnA を検索結果に含めます。 |
|
プロンプト
|
prompts | array of KnowledgeBaseAnswerPrompt |
回答と関連したプロンプトの一覧。 |
KnowledgeBaseAnswerPrompt
回答のプロンプト。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
displayOrder
|
displayOrder | integer |
プロンプトのインデックス - プロンプトの順序付けに使用されます。 |
|
qnaId
|
qnaId | integer |
プロンプトに対応する QnA ID。 |
|
displayText
|
displayText | string |
フォローアップ質問プロンプトを表すために表示されるテキスト。 |
AnswerSpan
QnA の回答スパン オブジェクト。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
テキスト
|
text | string |
正確な答えの予測テキスト。 |
|
Confidence Threshold
|
confidenceScore | float |
正確な答えの予測スコア。値の範囲は 0 から 1 です。 |
|
オフセット
|
offset | integer |
回答の開始からの正確な回答オフセット。 |
|
length
|
length | integer |
正確な答えの長さ。 |
AnswersFromTextResult
回答結果を表します。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
回答
|
answers | array of TextAnswer |
回答結果を表します。 |
TextAnswer
回答結果を表します。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
回答
|
answer | string |
回答のテキスト。 |
|
Confidence Threshold
|
confidenceScore | float |
自信スコアに答えてください。値の範囲は 0 から 1 です。 |
|
id
|
id | string |
Record ID。 |
|
answerSpan
|
answerSpan | AnswerSpan |
QnA の回答スパン オブジェクト。 |
|
オフセット
|
offset | integer |
ドキュメントの開始からの文オフセットです。 |
|
length
|
length | integer |
分の長さ。 |