LUIS
Azure Cognitive Services の Language Understanding Intelligent Service (LUIS) は、コンテキストに従って言語を理解するのに役立つため、アプリは人々が話す方法でコミュニケーションすることができます。
このコネクタは、次の製品および地域で利用可能です。
| サービス | クラス | リージョン |
|---|---|---|
| Logic Apps | 標準 | すべての Logic Apps 地域 |
| Power Automate | 標準 | すべての Power Automate 地域 |
| Power Apps | 標準 | すべての Power Apps 地域 |
| コネクタ メタデータ | |
|---|---|
| 発行者 | マイクロソフト |
| Web サイト | https://azure.microsoft.com/services/cognitive-services/language-understanding-intelligent-service/ |
既知の問題と制限事項
以下は、LUIS コネクタを使用する際の既知の制限の一部です
- エンドポイントを作成しているアプリ ID、アプリ バージョン、目的のインテント、目的のエンティティの呼び出しのドロップダウンは、接続を作成するときに使用するオーサリング キーが必要です。 エンドポイント キーのみが使用可能な場合は、「カスタム値の入力」を使用して、対応するパラメーター値を入力する必要があります。
接続の作成
コネクタは、次の認証タイプをサポートしています:
| 既定 | 接続を作成するためのパラメーター。 | すべてのリージョン | 共有可能 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続です。 Power App が他のユーザーと共有されている場合、接続も共有されます。 詳細については、キャンバス アプリのコネクタの概要 - Power Apps | Microsoft Docs を参照してください
| 件名 | タイプ | 内容 | 必要 |
|---|---|---|---|
| API キー | securestring | API キー | 真 |
| 予測エンドポイント | 文字列 | 予測エンドポイント。 指定しない場合、既定で https://westus.api.cognitive.microsoft.com になります。 |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 1200 | 60 秒 |
アクション
| 予測を取得する |
入力テキストが与えられると、この操作は事前にトレーニングされたモデルに基づいて予測を返します。 返された予測オブジェクトは、他の LUIS アクションの入力として使用することもできます。 |
| 種類でエンティティを取得 |
特定のエンティティの種類に対して、操作は LUIS 予測オブジェクトから最も一致するエンティティ モデルを返します。 |
予測を取得する
入力テキストが与えられると、この操作は事前にトレーニングされたモデルに基づいて予測を返します。 返された予測オブジェクトは、他の LUIS アクションの入力として使用することもできます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
アプリ ID
|
app-id | True | string |
トレーニング済みのアプリケーションの ID。 |
|
発話テキスト
|
q | True | string |
予測する文字列 |
|
目的のインテント
|
desiredIntent | string |
最高得点の目的のインテント |
|
|
アプリ バージョン
|
versionId | string |
バージョン名。 既定では値 0.1 が使用されます。 |
戻り値
- 本文
- PredictResponse
種類でエンティティを取得
特定のエンティティの種類に対して、操作は LUIS 予測オブジェクトから最も一致するエンティティ モデルを返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
アプリ ID
|
app-id | True | string |
トレーニング済みのアプリケーションの ID |
|
目的のエンティティ
|
desiredEntity | True | string |
目的のエンティティ。 |
|
アプリ バージョン
|
versionId | string |
バージョン名。 既定では値 0.1 が使用されます。 |
|
|
luisPredictionObject
|
luisPredictionObject | True | string |
戻り値
定義
PredictResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
LUIS 予測
|
luisPrediciton | string |
他の LUIS アクションの入力として使用されます。 |
|
目的のインテントかどうか
|
isDesiredIntent | boolean |
最高得点のインテントが目的のインテントと一致する場合は True。 |
|
目的のインテント
|
desiredIntent | string |
入力として指定された目的のインテント (ある場合)。 |
|
発話テキスト
|
query | string |
予測の基になっている文字列。 |
|
件名
|
topScoringIntent.intent | string |
インテント モデルの名前。 |
|
スコア
|
topScoringIntent.score | float |
予測の信頼度。 |
|
インテント配列
|
intents | array of object |
予測されるすべてのインテントの一覧。 |
|
インテント名
|
intents.intent | string |
インテント モデルの名前。 |
|
インテントのスコア
|
intents.score | float |
予測の信頼度。 |
|
エンティティ配列
|
entities | array of LuisPredictResponseEntity |
予測されるすべてのエンティティの一覧。 |
LuisPredictResponseEntity
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
エンティティの値
|
entity | string |
対応するエンティティの種類の値。 |
|
エンティティの種類
|
type | string |
エンティティ モデルの名前。 |
|
エンティティのスコア
|
score | float |
予測の信頼度。 |
GetTopScoringMatchingEntityResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
エンティティ
|
entity | LuisPredictResponseEntityMinusType | |
|
entityMatchInfo
|
entityMatchInfo | EntityMatchInfo |
LuisPredictResponseEntityMinusType
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
エンティティの値
|
entity | string |
対応するエンティティの種類の値。 |
|
エンティティのスコア
|
score | float |
予測の信頼度。 |
|
エンティティの解決
|
resolution | string |
このエンティティの解決。 組み込みエンティティのみに適用されます。 |
EntityMatchInfo
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
目的のエンティティ
|
desiredEntity | string |
入力として指定された目的のエンティティ (ある場合)。 |
|
エンティティは一致しているか
|
isEntityMatch | boolean |
指定されたエンティティが見つかった場合は True。 |
|
エンティティが一致する数
|
entityMatchCount | integer |
目的のエンティティの種類と一致するエンティティの数。 |