用于语言理解 (LUIS) 的 SDK、REST 和 CLI 开发人员资源

重要

LUIS 将于 2025 年 10 月 1 日停用,从 2023 年 4 月 1 日开始,你将无法创建新的 LUIS 资源。 建议将 LUIS 应用程序迁移对话语言理解,以便从持续的产品支持和多语言功能中受益。

SDK、REST API、CLI 用于以编程语言开发语言理解 (LUIS) 应用。 管理 Azure 资源和 LUIS 预测。

Azure 资源管理

使用 Azure AI 服务的管理层来创建、编辑、列出和删除语言理解或 Azure AI 服务资源。

根据以下工具来查找参考文档:

语言理解创作和预测请求

可以从需要创建的 Azure 资源访问语言理解服务。 有两个资源:

  • 使用创作资源进行训练,以便创建、编辑、训练和发布内容。
  • 预测用于运行时,以便发送用户的文本并接收预测。

使用 Azure AI 服务示例代码,了解并使用最常见的任务。

REST 规范

GitHub 上公开提供 LUIS REST 规范以及所有 Azure REST 规范

REST API

创作终结点 API 和预测终结点 API 都可在 REST API 中使用:

类型 版本
创作 V2
预览 V3
预测 V2
V3

REST 终结点

LUIS 目前有 2 种类型的终结点:

  • 在训练终结点上进行创作
  • 运行时终结点上的查询预测。
目的 URL
在训练终结点上进行 V2 创作 https://{your-resource-name}.api.cognitive.azure.cn/luis/api/v2.0/apps/{appID}/
在训练终结点上进行 V3 创作 https://{your-resource-name}.api.cognitive.azure.cn/luis/authoring/v3.0-preview/apps/{appID}/
V2 预测 - 运行时终结点上的所有预测 https://{your-resource-name}.api.cognitive.azure.cn/luis/v2.0/apps/{appId}?q={q}[&timezoneOffset][&verbose][&spellCheck][&staging][&bing-spell-check-subscription-key][&log]
V3 预测 - 运行时终结点上的版本预测 https://{your-resource-name}.api.cognitive.azure.cn/luis/prediction/v3.0/apps/{appId}/versions/{versionId}/predict?query={query}[&verbose][&log][&show-all-intents]
V3 预测 - 运行时终结点上的槽预测 https://{your-resource-name}.api.cognitive.azure.cn/luis/prediction/v3.0/apps/{appId}/slots/{slotName}/predict?query={query}[&verbose][&log][&show-all-intents]

下表说明了上表中用大括号 {} 表示的参数。

参数 目的
your-resource-name Azure 资源名称
qquery 从客户端应用程序(如聊天机器人)发送的话语文本
version 10 字符版本名称
slot productionstaging

REST 查询字符串参数

V3 API 查询字符串参数包括:

查询参数 LUIS 门户名称 类型 版本 默认 目的
log 保存日志 boolean V2 和 V3 false 将查询存储在日志文件中。 默认值为 false。
query - string 仅 V3 无默认值 - 在 GET 请求中是必需的 在 V2 中,要预测的言语位于 q 参数中。

在 V3 中,该功能在 query 参数中传递。
show-all-intents 包括所有意向的分数 boolean 仅 V3 false prediction.intents 对象中返回包含相应评分的所有意向。 意向将在父 intents 对象中作为对象返回。 这样,便可以通过编程方式进行访问,而无需在数组中查找意向:prediction.intents.give。 在 V2 中,这些意向在数组中返回。
verbose 包括更多实体详细信息 boolean V2 和 V3 false 在 V2 中,如果设置为 true,则返回所有预测意向。 如果需要所有预测的意向,请使用 V3 参数 show-all-intents

在 V3 中,此参数仅提供实体预测的实体元数据详细信息。
timezoneOffset - string V2 - 应用于 datetimeV2 实体的时区。
datetimeReference - string V3 - 应用于 datetimeV2 实体的时区。 替换 V2 中的 timezoneOffset

应用架构

应用架构.json.lu 格式导入和导出。

基于语言的 SDK

容器

语言理解 (LUIS) 提供一个可提供本地版和包含版应用的容器

导出和导入格式

语言理解提供以 JSON 格式管理应用及其模型的功能,并提供 .LU (LUDown) 格式以及用于语言理解容器的压缩包。

可以通过 API 和 LUIS 门户导入和导出这些格式。 此门户通过“应用”列表和“版本”列表提供导入和导出功能。

研讨会

Bot Framework 工具

Bot Framework 在多种语言中以 SDK 形式提供。

Bot Framework 提供有助于语言理解的多种工具,其中包括:

  • Bot Framework Emulator - 一款桌面应用程序,可让机器人开发人员测试和调试使用 Bot Framework SDK 构建的机器人。
  • Bot Framework Composer - 一个集成开发工具,供开发人员和多学科团队通过 Microsoft Bot Framework 构建机器人和聊天体验
  • Bot Framework 示例 - 使用 #C、JavaScript、TypeScript 和 Python 编写

后续步骤