向部署发送预测请求

成功添加部署后,你可以查询部署来基于分配给部署的模型预测你的语句中的意图和实体。 可通过预测 API 或客户端库 (Azure SDK) 以编程方式查询部署。

测试已部署的模型

可使用 Language Studio 提交语句、获取预测并可视化结果。

若要在 Language Studio 中测试已部署的模型,请执行以下操作:

  1. 在左侧菜单中,选择“测试部署”。

  2. 对于多语言项目,请从“选择文本语言”下拉列表中选择要测试的语句的语言。

  3. 从“部署名称”下拉列表中,选择要测试的模型对应的部署名称。 只能测试分配给部署的模型。

  4. 在文本框中,输入要测试的语句。 例如,如果你为与电子邮件相关的语句创建了一个应用程序,则可以输入“删除此电子邮件”。

  5. 在页面顶部,选择“运行测试”。

  6. 运行测试后,在结果中应会看到模型的响应。 可以在实体卡片视图中查看结果,或以 JSON 格式查看结果。


发送对话语言理解请求

首先需要获取资源密钥和终结点:

Azure 门户中,转到资源概述页面。 在左侧菜单中,选择“密钥和终结点”。 你将为 API 请求使用终结点和密钥

A screenshot showing the key and endpoint page in the Azure portal.

查询你的模型

使用以下 URL、标头和 JSON 正文创建 POST 请求,开始测试对话语言理解模型。

请求 URL

{ENDPOINT}/language/:analyze-conversations?api-version={API-VERSION}
占位符 示例
{ENDPOINT} 用于对 API 请求进行身份验证的终结点。 https://<your-custom-subdomain>.cognitiveservices.azure.cn
{API-VERSION} 要调用的 API 的版本 2023-04-01

头文件

使用以下标头对请求进行身份验证。

Ocp-Apim-Subscription-Key 资源密钥。 用于对 API 请求进行身份验证。

请求正文

{
  "kind": "Conversation",
  "analysisInput": {
    "conversationItem": {
      "id": "1",
      "participantId": "1",
      "text": "Text 1"
    }
  },
  "parameters": {
    "projectName": "{PROJECT-NAME}",
    "deploymentName": "{DEPLOYMENT-NAME}",
    "stringIndexType": "TextElement_V8"
  }
}
密钥 占位符 示例
participantId {JOB-NAME} "MyJobName
id {JOB-NAME} "MyJobName
text {TEST-UTTERANCE} 你要预测其意向并从中提取实体的语句。 "Read Matt's email
projectName {PROJECT-NAME} 项目名称。 此值区分大小写。 myProject
deploymentName {DEPLOYMENT-NAME} 部署的名称。 此值区分大小写。 staging

发送请求后,你将获得有关预测的以下响应

响应正文

{
  "kind": "ConversationResult",
  "result": {
    "query": "Text1",
    "prediction": {
      "topIntent": "inten1",
      "projectKind": "Conversation",
      "intents": [
        {
          "category": "intent1",
          "confidenceScore": 1
        },
        {
          "category": "intent2",
          "confidenceScore": 0
        },
        {
          "category": "intent3",
          "confidenceScore": 0
        }
      ],
      "entities": [
        {
          "category": "entity1",
          "text": "text1",
          "offset": 29,
          "length": 12,
          "confidenceScore": 1
        }
      ]
    }
  }
}
示例值 说明
query "Read Matt's email" 提交以供查询的文本。
topIntent "Read" 置信度分数最高的预测意向。
意向 [] 针对查询文本所预测的所有意向的列表,每个意向有一个置信度分数。
实体 [] 一个数组,包含从查询文本中提取的实体列表。

会话项目的 API 响应

在会话项目中,你将获得对项目中的意图和实体的预测。

  • 意图和实体包括一个介于 0.0 到 1.0 之间的置信度分数,该分数与模型对于预测项目中某个元素的信心程度相关。
  • 评分最高的意图包含在其自己的参数内。
  • 只有预测的实体才会显示在响应中。
  • 实体指示:
    • 提取的实体的文本
    • 用偏移值表示的开始位置
    • 用长度值表示的实体文本的长度。

后续步骤