LUIS
Azure Cognitive Services の言語理解インテリジェント サービス (LUIS) を使用すると、言語をコンテキストに応じて理解できるため、アプリはユーザーの話し方でユーザーと通信できます。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | リージョン |
|---|---|---|
| コピロット スタジオ | Standard | すべての地域 Power Automate |
| ロジック アプリ | Standard | すべての Logic Apps リージョン |
| Power Apps | Standard | すべての Power Apps リージョン |
| Power Automate | Standard | すべての地域 Power Automate |
| コネクタ メタデータ | |
|---|---|
| Publisher | Microsoft |
| Website | https://azure.microsoft.com/services/cognitive-services/language-understanding-intelligent-service/ |
既知の問題と制限事項
LUIS コネクタを使用する場合の既知の制限事項を次に示します。
- アプリ ID、アプリ バージョン、Desired Intent、Desired Entity 呼び出し 作成 エンドポイントのドロップダウン。そのため、接続を作成するときにオーサリング キーを使用する必要があります。 エンドポイント キーのみを使用できる場合は、"カスタム値の入力" を使用して、対応するパラメーター値を入力する必要があります。
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| デフォルト | 接続を作成するためのパラメーター。 | すべてのリージョン | 共有可能 |
デフォルト
適用対象: すべてのリージョン
接続を作成するためのパラメーター。
これは共有可能な接続です。 電源アプリが別のユーザーと共有されている場合は、接続も共有されます。 詳細については、 キャンバス アプリのコネクタの概要 - Power Apps |Microsoft Docs
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| 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 が使用されます。 |
戻り値
- Body
- 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 |
意図モデルの名前。 |
|
Score
|
topScoringIntent.score | float |
予測の信頼度の割合。 |
|
Intents 配列
|
intents | array of object |
予測されたすべての意図の一覧。 |
|
意図名
|
intents.intent | string |
意図モデルの名前。 |
|
意図スコア
|
intents.score | float |
予測の信頼度の割合。 |
|
Entities 配列
|
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 |
目的のエンティティ型に一致するエンティティの数。 |