QnA Maker
ナビゲートが簡単な FAQ に情報をまとめます。
このコネクタは、次の製品および地域で利用可能です:
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure China の地域 |
| Power Automate | 標準 | 以下を除くすべての Power Automate 地域 : - 21 Vianet が運用する中国のクラウド |
| Power Apps | 標準 | 以下を除くすべての Power Apps 地域 : - 21 Vianet が運用する中国のクラウド |
| 連絡先 | |
|---|---|
| 件名 | Microsoft |
| URL | Microsoft LogicApps サポート Microsoft Power Automate サポート Microsoft Power Apps サポート |
| コネクタ メタデータ | |
|---|---|
| パブリッシャー | マイクロソフト |
| Web サイト | https://www.qnamaker.ai/ |
既知の問題と制限事項
QnA Maker コネクタは、API QnA Maker 4.0 バージョンのみをサポートします。
接続の作成
コネクタは、次の認証タイプをサポートしています:
| API キー | ApiKey | すべての地域 | 共有可能 |
| 既定 [非推奨] | このオプションは、明示的な認証の種類を持たない古い接続専用に対してのみ使用され、下位互換性を保つためにのみ提供されます。 | すべての地域 | 共有不可 |
API キー
認証 ID: keyBasedAuth
適用できるもの: すべての領域
ApiKey
これは共有可能な接続です。 Power App が他のユーザーと共有されている場合、接続も共有されます。 詳細については、キャンバス アプリのコネクタの概要 - Power Apps | Microsoft Docs を参照してください
| 件名 | タイプ | 内容 | 必要 |
|---|---|---|---|
| アカウント キー | securestring | Cognitive Services アカウント キー | 真 |
| サイトの URL | 文字列 | ルート サイト URL (例: https://westus.api.cognitive.microsoft.com) |
既定 [非推奨]
適用できるもの: すべての領域
このオプションは、明示的な認証の種類を持たない古い接続専用に対してのみ使用され、下位互換性を保つためにのみ提供されます。
これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 件名 | タイプ | 内容 | 必要 |
|---|---|---|---|
| API キー | securestring | API キー | 真 |
| サイトの URL | 文字列 | ルート サイト URL です。 指定しない場合、サイトの URL は既定で https://westus.api.cognitive.microsoft.com になります。 |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 1200 | 60 秒 |
アクション
| サポート情報のダウンロード [非推奨] |
この操作によって、指定されたサポート情報に関連付けられているすべてのデータをダウンロードします。 |
| サポート情報の詳細のダウンロード |
特定のサポート情報の詳細を取得します。 |
| サポート情報の詳細をダウンロードする (V2) |
特定のサポート情報の詳細を取得します。 |
| 回答の生成 |
この操作は、指定された質問に対する上位の回答を返します。 |
| 回答を生成する [非推奨] |
この操作は、指定された質問に対する上位の回答を返します。 |
サポート情報のダウンロード [非推奨]
この操作によって、指定されたサポート情報に関連付けられているすべてのデータをダウンロードします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サポート情報 ID
|
KnowledgeBaseId | True | string |
これは QnAMaker ポータルから取得する必要があります。 |
戻り値
Createkb 操作の応答スキーマです。
サポート情報の詳細のダウンロード
特定のサポート情報の詳細を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サポート情報 ID
|
KnowledgeBaseId | True | string |
これは QnAMaker ポータルから取得する必要があります。 |
戻り値
Createkb 操作の応答スキーマです。
サポート情報の詳細をダウンロードする (V2)
特定のサポート情報の詳細を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
リソースのサブドメインや地域
|
subdomainName | True | string |
Azure のサブドメインまたは地理的地域 (例: westus) |
|
サポート情報 ID
|
KnowledgeBaseId | True | string |
これは、QnAMaker ポータルから取得する必要があります。 |
戻り値
CreateKb 操作の応答スキーマ。
回答の生成
この操作は、指定された質問に対する上位の回答を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サポート情報 ID
|
KnowledgeBaseId | True | string |
これは QnAMaker ポータルから取得する必要があります。 |
|
サービス ホスト
|
ServiceHost | True | string |
これは QnAMaker ポータルから取得する必要があります。 |
|
エンドポイント キー
|
EndpointKey | True | string |
これは QnAMaker ポータルから取得する必要があります。 |
|
質問
|
question | True | string |
質問する。 |
|
頂部
|
top | integer |
出力に必要なランク付けされた結果の数。 |
戻り値
回答を生成する [非推奨]
この操作は、指定された質問に対する上位の回答を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サポート情報 ID
|
KnowledgeBaseId | True | string |
これは QnAMaker ポータルから取得する必要があります。 |
|
質問
|
question | True | string |
質問をします。 |
|
上詰め
|
top | integer |
出力内の必要なランク付けされた結果の数です。 |
戻り値
定義
GenerateAnswer_Response
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
回答
|
answers | array of object |
すべての回答の一覧。 |
|
回答
|
answers.answer | string |
質問に対する上位の回答です。 |
|
スコア
|
answers.score | float |
回答の相対スコアです。 |
|
ID
|
answers.id | number | |
|
ソース
|
answers.source | string |
DownloadKnowledgeBase_Response
Createkb 操作の応答スキーマです。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ID
|
id | string |
サポート情報を識別する一意の IDです。 |
|
hostName
|
hostName | string |
サポート情報がホストされている URL ホスト名です。 |
|
lastAccessedTimestamp
|
lastAccessedTimestamp | string |
サポート情報が最後にアクセスされたときのタイム スタンプ (UTC) です。 |
|
lastChangedTimestamp
|
lastChangedTimestamp | string |
サポート情報が最後に修正されたときのタイム スタンプ (UTC) です。 |
|
lastPublishedTimestamp
|
lastPublishedTimestamp | string |
サポート情報が最後に公開されたときのタイム スタンプ (UTC) です。 |
|
名前
|
name | string |
サポート情報のフレンドリ名です。 |
|
userId
|
userId | string |
サポート情報を作成/所有しているユーザーです。 |
|
urls
|
urls | array of string |
質問と回答が抽出されてサポート情報に追加された URL ソースです。 |
|
ソース
|
sources | array of string |
質問と回答が抽出またはサポート情報に明示的に追加されたカスタム ソースです。 |