次の方法で共有


言語 - 質疑応答

言語 - 質問応答 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 アプリを言語サービス内の新しい質問応答機能と統合するためのコネクタです。 このコネクタを使用すると、ユーザーは質問応答の新機能と拡張機能に接続できるようになります。 このコネクタには、ユーザーが行うのに役立つアクションがあります

  • プロジェクトから回答を生成する
  • プロジェクトのメタデータの取得
  • 提供されたテキストから一定期間にわたって回答を生成します。お客様により多くの機能を提供するために、より多くのアクションを展開する予定です。

前提条件

こちら の指示に従って、カスタム質問応答プロジェクトを作成します。

資格情報の入手方法

  1. プロジェクトをデプロイした後、"予測 URL を取得する" をクリックします。
  2. 予測 URL のホスト名とアカウント キー (Ocp-Apim-Subscription-Key) からサイト URL を取得します。予測 URL
  3. 自分のアカウント キーとサイト URL を入力して、接続します。接続

コネクタの使用を開始する

フローでコネクタを使用する

  1. Microsoft Power Automate に移動して、作成 をクリックして、"インスタント クラウド フロー" を選択します。 CreateFlow
  2. このコネクタをテストするには、"手動でフローをトリガーする" をクリックして、Create をクリックします。SelectTriggerForFlow
  3. "新規ステップ" をクリックし、"言語 – 質問応答" を検索して、3 つのアクションから選択します。 SelectActionForFlow

アクション:

プロジェクトから回答を生成する

  1. このアクションは、プロジェクトのナレッジベースを使用して指定された質問に回答するのに役立ちます。
  2. "サンプル プロジェクト" から回答を生成するために、このクエリを提供できますGenerateAnswerFromProject
  3. リクエスト本文の詳細については、こちら 質問応答 - 回答を取得 - REST API (Azure Cognitive Services) | Microsoft Docs をご覧ください

プロジェクトのメタデータの取得

  1. このアクションは、プロジェクトのすべてのメタデータを取得するのに役立ちます。
  2. プロジェクト名を指定して、プロジェクトのメタデータを取得します。 GetProjectMetadata

提供されたテキストから回答を生成する

  1. このアクションは、提供されたテキストを使用して指定された質問に答えるのに役立ちます。 このアクションのみを使用するには、言語リソースでカスタム質問応答を有効にする必要はありません。
  2. このアクションには、カスタム質問応答プロジェクトは必要ありません。 これには言語リソースのみが必要です。 言語リソースを作成し、Azure ポータルのキー セクションとエンドポイント セクションでエンドポイントとキーをそれぞれサイト URL とアカウント キーにコピーできます。
  3. クエリ "表面を充電するのにどれくらい時間がかかりますか? "次のテキストで:" 電源と充電。 空の状態から Surface Pro 4 のバッテリーを完全に充電するには、2〜4 時間かかります。 充電中に Surface をゲームやビデオ ストリーミングなどの電力を大量に消費するアクティビティに使用している場合は、さらに時間がかかることがあります。"GenerateAnswerFromProvidedText
  4. リクエスト本文の詳細については、こちら 質問応答 - テキストから回答を取得 - 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 バージョンです。

戻り値

質問回答のリストを表します。

プロジェクトのメタデータの取得

このアクションは、プロジェクトのすべてのメタデータを取得するのに役立ちます。

パラメーター

名前 キー 必須 説明
プロジェクト名
ProjectNamePathParameter True string

使用するプロジェクトの名前。

API Version
api-version True string

これは、クライアント API バージョンです。

戻り値

プロジェクトを表します。

提供されたテキストから回答を生成する

このアクションは、提供されたテキストを使用して指定された質問に答えるのに役立ちます。

パラメーター

名前 キー 必須 説明
質問
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

テキスト レコードの言語。 これは、言語の BCP-47 表現です。

テキスト レコードの言語。 これは、言語の BCP-47 表現です。

Language
string

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

分の長さ。