LUIS
Azure 认知服务语言理解智能服务(LUIS)使你可以以上下文方式理解语言,使应用能够以他们说话的方式与用户通信。
此连接器在以下产品和区域中可用:
| 服务 | Class | 区域 |
|---|---|---|
| Copilot Studio | 标准 | 所有 Power Automate 区域 |
| 逻辑应用程序 | 标准 | 所有 逻辑应用区域 |
| Power Apps | 标准 | 所有 Power Apps 区域 |
| Power Automate | 标准 | 所有 Power Automate 区域 |
| 连接器元数据 | |
|---|---|
| 发布者 | Microsoft |
| 网站 | https://azure.microsoft.com/services/cognitive-services/language-understanding-intelligent-service/ |
已知问题和限制
以下是使用 LUIS 连接器的一些已知限制
- 应用 ID、应用版本、Desired Intent 和 Desired 实体调用 创作 终结点的下拉列表,因此需要在创建连接时使用创作密钥。 如果只有可用的终结点密钥,则必须使用“输入自定义值”来输入相应的参数值。
正在创建连接
连接器支持以下身份验证类型:
| 默认 | 用于创建连接的参数。 | 所有区域 | 可共享 |
违约
适用:所有区域
用于创建连接的参数。
这是可共享的连接。 如果 Power App 与其他用户共享,则连接也会共享。 有关详细信息,请参阅 画布应用的连接器概述 - Power Apps |Microsoft Docs
| Name | 类型 | Description | 必选 |
|---|---|---|---|
| API 密钥 | securestring | API 密钥 | True |
| 预测终结点 | 字符串 | 预测终结点。 如果未指定,则默认为 https://westus.api.cognitive.microsoft.com. |
限制
| 名称 | 调用 | 续订期 |
|---|---|---|
| 每个连接的 API 调用数 | 1200 | 60 秒 |
操作
| 按类型获取实体 |
对于给定的实体类型,该作从 LUIS 预测对象返回最佳匹配实体模型。 |
| 获取预测 |
给定一些输入文本,此作基于预先训练的模型返回预测。 返回的预测对象还可以用作其他 LUIS作的输入。 |
按类型获取实体
对于给定的实体类型,该作从 LUIS 预测对象返回最佳匹配实体模型。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
应用 ID
|
app-id | True | string |
已训练应用程序的 ID |
|
所需实体
|
desiredEntity | True | string |
所需实体。 |
|
应用版本
|
versionId | string |
版本名称。 默认情况下,将使用值 0.1。 |
|
|
luisPredictionObject
|
luisPredictionObject | True | string |
返回
获取预测
给定一些输入文本,此作基于预先训练的模型返回预测。 返回的预测对象还可以用作其他 LUIS作的输入。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
应用 ID
|
app-id | True | string |
已训练的应用程序的 ID。 |
|
言语文本
|
q | True | string |
要预测的字符串 |
|
所需意向
|
desiredIntent | string |
所需最高评分意向 |
|
|
应用版本
|
versionId | string |
版本名称。 默认情况下,将使用值 0.1。 |
返回
- Body
- PredictResponse
定义
PredictResponse
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
LUIS 预测
|
luisPrediciton | string |
用作其他 LUIS作的输入。 |
|
所需意向
|
isDesiredIntent | boolean |
如果最高评分意向与所需意向匹配,则为 True。 |
|
所需意向
|
desiredIntent | string |
指定为输入的所需意向(如果有)。 |
|
言语文本
|
query | string |
预测所基于的字符串。 |
|
Name
|
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 |
与所需实体类型匹配的实体数。 |